建图
导航

O_STATUS

ws://{{host}}/api/ws?token={{token}}

接口描述

系统状态输出

响应参数

参数名
类型
描述
必填
type
int
消息类型
必填
data
object
消息内容
必填
current
float
充电电流(仅在充电状态有效),单位:A
必填
percentage
int
电量百分比
必填
pose
object
机器当前位姿
必填
orientation
object
四元数表示的机器人在地图坐标系下的当前姿态
必填
w
float
示例:0.3323372154796466
必填
x
float
示例:0
必填
y
float
示例:0
必填
z
float
示例:0.9431606306495384
必填
position
object
机器人在地图坐标系的位置(单位:米)
必填
x
float
示例:-2.690151629640846
必填
y
float
示例:2.2565590959076927
必填
z
float
示例:0
必填
twist
object
机器当前速度
必填
angular
object
角速度,单位:rad/s,仅z轴的值有效,x轴和y轴值无效
必填
x
float
示例:0
必填
y
float
示例:0
必填
z
float
示例:-0.00009524634531364407
必填
linear
object
线速度,单位:m/s,仅x轴的值有效,y轴和z轴的值无效
必填
x
float
示例:0.000180017024756703
必填
y
float
示例:-3.2973112260077805e-7
必填
z
float
示例:0
必填
voltage
float
电池电压,单位:伏特
必填
state
int
系统状态码 详见下方说明
必填
err
array[string]
系统状态子码: 类型码-子码
必填
msg
string
系统状态描述
必填
time_stamp
int
时间戳(毫秒)
必填
chassis_mode
int
底盘状态
必填

说明 / 示例

[系统状态码](https://docs.qq.com/doc/p/c2843f0d9dfb32f037b44823b4effb666066c61a?dver=3.0.0) [类型码-子码](https://docs.qq.com/doc/p/98a7ee9423d41ac7d23cfffc2945b3ad6cbc2477?dver=3.0.0) [四元数与欧拉角转换](https://blog.csdn.net/xiaoma_bk/article/details/79082629) 数据示例: ```json { "type":1026, "data":{ "chassis_mode":1, // "current":0, "msg":"正在执行任务", "percentage":77, "pose":{ "orientation":{ //四元数 表示机器人在地图坐标系下的姿态 "w":0.6937204814499561, "x":0, "y":0, "z":-0.720244329111199 }, "position":{ //机器人在地图坐标系下的位置 单位:米 "x":-0.36726856231689453, "y":5.278438568115234, "z":0 } }, "state":1, "err": [], "time_stamp":1658129667807, "twist":{ "angular":{ "x":0, "y":0, "z":0.01600000075995922 }, "linear":{ "x":0.503000020980835, "y":0, "z":0 } }, "voltage":26.658 } } ```