Control Robot Motion

Send movement, turning, and posture commands to a specified robot.

Endpoint Information

• Name: Robot motion control
• Description: Moves a robot forward, backward, left, or right, or turns it.
• Method: POST
• Path: remoteApi/controlDog
• Login required: No
• Permission required: Yes

Note: The robot must be in remote-control mode. Sending a road-network target is strongly recommended.

---

Request Parameters

• dogCode · String · Required

  Robot code
  Example: 001

• type · Integer · Required

  Control type: 1 switch between remote-control and task modes; 2 body movement
  Example: 2

• command · Integer · Required

  Command
  Example: 2

• value · String · Required

  Command value or step size
  Example: 0.5

• speed · Integer · Optional

  Speed; defaults to 1. For a Lynx M20, this value may be increased for lateral movement and turning. Use the default value of 1 for an X30.
  Example: 1

Command meanings:

Mode Switching

Shared parameters: type = 1, command = 6; speed is not applicable.

value	Description
1	Switch to task mode
2	Switch to remote-control mode

Body Movement

Shared parameter: type = 2. See the request parameters above for value and speed.

command	Description
1	Move forward
2	Move backward
11	Move left (recommended value: 0.5)
12	Move right (recommended value: 0.5)
3	Turn left (recommended value: 0.35)
4	Turn right (recommended value: 0.35)
15	Crouch
16	Stand Up

Request Example

{
  "dogCode": "001",
  "type": 2,
  "command": 1,
  "value": 1,
  "speed": 1
}

Response

Field	Type	Example	Description
code	Integer	200	Status code
success	Boolean	true	Whether the request succeeded
msg	String	success	Response message

Response Example

{
  "success": true,
  "code": 200,
  "msg": "success",
  "data": null
}

Error Codes

Code	Description
400	Invalid parameters
401	Unauthorized
403	Access denied
404	Resource not found
500	Internal server error