Master 人形机器人 SDK

# 在机器人上（aarch64）
pip install wheels/ff_sdk-0.1.0a0-cp310-cp310-linux_aarch64.whl

# 在 Linux 开发机上（x86_64）
pip install wheels/ff_sdk-0.1.0a0-cp310-cp310-linux_x86_64.whl

python -c "import ff_sdk; print(ff_sdk.__version__)"

import asyncio, ff_sdk

async def main():
    async with await ff_sdk.connect("X2-DEMO") as robot:
        print(robot.diagnose())                  # 体检：动作通道是否在线
        print(robot.capabilities())

        battery = await robot.state.battery()
        print(f"电量 {battery.percent:.0%}")

        status = await robot.state.status()
        print(f"状态 {status}")

        # 播放一个之前上传过的动作作品（名字 = <key>_<version>）
        res = await robot.motion.do_preset("mydance_v1")
        print(res)

asyncio.run(main())

from ff_sdk import Config

cfg = Config.from_env()
cfg.extra["x2_motion_proxy_url"] = "http://192.168.1.50:5000"
robot = await ff_sdk.connect("X2-DEMO", config=cfg)

async with await ff_sdk.connect("X2-DEMO") as robot:
    ...
# 自动 close()

# 路线 A：作品之前传过 → 直接按名字播
await robot.motion.do_preset("mydance_v1")

# 路线 B：新作品 → 上传并播放
await robot.motion.do_preset_uploaded(
    key="mydance", version="v2",
    file_path="./works/mydance_v2.bin",
    motion_type="foundation",
)

# 停止
await robot.motion.stop()

import ff_sdk
from ff_sdk.core.exceptions import CapabilityNotSupported

async def play_latest(robot, key: str, versions: list[str]):
    """按版本号从新到旧尝试播放，第一个成功的为准。"""
    for ver in versions:
        try:
            res = await robot.motion.do_preset(f"{key}_{ver}")
            if res.success:
                return res
        except CapabilityNotSupported:
            continue
    raise RuntimeError(f"作品 {key} 没有可播放的版本")

battery = await robot.state.battery()
if battery.percent < 0.3:
    print("电量低于 30%，全身动作建议先充电")
else:
    await robot.motion.do_preset("mydance_v1")

from ff_sdk import skills

# skills 在 Master 上自动选择可用的实现路径，
# 不可用时返回 {"ok": False, "message": ...} 而不是崩溃
result = await skills.wave(robot)
print(result)   # {"ok": ..., "platform": "x2", ...}

res = await robot.motion.do_preset("mydance_v1")
if not res.success:
    print(f"播放失败: {res.message}")
    print(res.details)        # 服务端返回的细节，排错用