指令控制

创建机器人指令

POST /v1alpha1/robots/{serialNumber}/commands

向指定序列号的机器人发送一条新指令。支持三种命令类型：任务命令、导航命令和控制命令，三者选其一，并通过 commandParameter 传递具体参数。

请求参数（Body）

响应参数

SDK 调用示例

from gausium_sdk.models import CreateCommandRequest

request = CreateCommandRequest(
    remote_task_command_type="START_TASK",
    command_parameter={"taskId": "task-001"}
)
result = await sdk.command.create("GS101-00A0-A7L-0000", request)
print(result.name, result.state)  # 资源名称, WAITING

获取机器人指令

GET /v1alpha1/robots/{robotId}/commands/{commandId}

根据机器人 ID 和指令 ID 获取单条指令的详细信息，包括命令参数、执行状态和创建时间。

路径参数

响应参数

SDK 调用示例

command = await sdk.command.get("GS101-00A0-A7L-0000", "cmd-12345")
print(command.state)           # 命令状态
print(command.create_time)     # 创建时间

列出机器人指令

GET /v1alpha1/robots/{robotId}/commands

分页列出指定机器人的所有历史指令，支持按创建时间排序。

请求参数（Query）

响应参数

SDK 调用示例

result = await sdk.command.list(
    "GS101-00A0-A7L-0000",
    page=1,
    page_size=10,
    order_by="create_time desc"
)
print(f"共 {result.total} 条指令")
for cmd in result.commands:
    print(cmd.name, cmd.state)

指令状态说明

指令创建后会经历不同的状态流转，state 字段反映当前执行阶段。

最佳实践