设备实时推送详情信息字段说明

数据字段说明

地理位置相关

longitude（经度）：double，取值范围 {"max":"180","min":"-180","step":"0.01"}

latitude（纬度）：double，取值范围 {"max":"90","min":"-90","step":"0.01"}

固件相关

firmware_version（固件版本）：text，长度 {"length":"64"}，权限 r 1

firmware_upgrade_status（固件升级状态）：{"0":"未升级","1":"升级中"}

机场状态相关

mode_code（机场状态）：{"0":"空闲中","1":"现场调试","2":"远程调试","3":"固件升级中","4":"作业中","5":"待标定"}

flighttask_step_code（机场任务状态）：

{"0":"作业准备中","1":"飞行作业中","2":"作业后状态恢复","3":"自定义飞行区更新中","4":"地形障碍物更新中","5":"任务空闲","255":"飞行器异常","256":"未知状态"}

子设备相关

sub_device（子设备状态）

device_sn（子设备序列号（SN））

product_type（子设备枚举值）：text，格式为 {domain - type - subtype}

device_online_status（机场停机坪上的飞行器开机状态）：{"0":"关机","1":"开机"}

device_paired（机场停机坪上的飞行器是否与机场对频）：{"0":"未对频","1":"已对频"}

其他设备状态相关

cover_state（舱盖状态）：{"0":"关闭","1":"打开","2":"半开","3":"舱盖状态异常"}

supplement_light_state（补光灯状态）：{"0":"关闭","1":"打开"}

network_state（网络状态）

type（网络类型）：{"1":"4G","2":"以太网"}

quality（网络质量）：{"0":"无信号","1":"差","2":"较差","3":"一般","4":"较好","5":"好"}

rate（网络速率）：float，{"unit_name":"千字节每秒 / KB/s"}

drone_in_dock（飞行器是否在舱）：enum_int，{"0":"舱外","1":"舱内"}

job_number（机场累计作业次数）：int，{"unit_name":"次 / count"}

媒体文件相关

media_file_detail（媒体文件上传细节）

remain_upload（待上传数量）

图传链路相关

wireless_link（图传链路）

dongle_number（飞行器上 Dongle 数量）

4g_link_state（4G 链路连接状态）：{"0":"未连接","1":"已连接"}

sdr_link_state（SDR 链路连接状态）：{"0":"未连接","1":"已连接"}

link_workmode（机场的图传链路模式）：{"0":"SDR 模式","1":"4G 融合模式"}

sdr_quality（SDR 信号质量）：int，{"max":"5","min":"0","step":"1"}

4g_quality（总体 4G 信号质量）：int，{"max":"5","min":"0","step":"1"}

4g_uav_quality（天端 4G 信号质量）：int，{"max":"5","min":"0","step":"1"}，飞行器端与 4G 服务器之间的信号质量

4g_gnd_quality（地端 4G 信号质量）：int，{"max":"5","min":"0","step":"1"}，地面端（如遥控器、DJI Dock 等）与 4G 服务器之间的信号质量

sdr_freq_band（SDR 频段）

4g_freq_band（4G 频段）

直播相关

live_status（网关当前整体直播状态推送）：array，{"size": -, "item_type": struct}

video_id（直播码流标识符）：text，某路在推视频码流的标识符，格式为 {sn}/{camera_index}/{video_index}。其中 {sn} 为视频源设备序列号。{camera_index} 为相机索引，使用 {type - subtype - gimbalindex} 的格式。{video_index} 为该相机级别的视频源可以选择的码流索引

video_type（视频类型）：text，{"length":"24"}，表明视频镜头的类型，如 normal/wide/zoom/infrared 等

video_quality（直播码流的质量）：enum_int，{"0":"自适应","1":"流畅","2":"标清","3":"高清","4":"超清"}

status（直播状态）：enum_int，{"0":"未直播","1":"在直播"}

error_status（错误码）：int，{"length":6}

live_capacity（网关设备直播能力）：struct，权限 r 1

available_video_number（可选择推流的码流数量）：int

coexist_video_number_max（可同时推流的最大码流数量）：int

device_list（可选择的视频设备源）：array，{"size": -, "item_type": struct}，可选择的视频设备源（设备层，比如飞行器）

sn（飞行器等视频源设备序列号（SN））：text

available_video_number（该序列号设备可以被选择推流的码流数）：int

coexist_video_number_max（该序列号设备可以同时被推流的码流数）：int

camera_list（该序列号设备上的相机列表）：array，{"size": -, "item_type": struct}

camera_index（相机索引）：text，使用 {type - subtype - gimbalindex} 的格式

available_video_number（该相机级别的视频源可以被选择推流的码流数）：int

coexist_video_number_max（该相机级别的视频源可以同时被推流的码流数）：int

video_list（该相机级别的视频源可以选择的码流列表）：array，{"size": -, "item_type": struct}

video_index（该相机级别的视频源可以选择的码流索引）：text

video_type（该相机级别的视频源可以选择的码流类型）：text

switchable_video_types（该视频流支持切换的视频镜头类型）：array，{"size": -, "item_type": text}

环境相关

rainfall（降雨量）：enum_int，{"0":"无雨","1":"小雨","2":"中雨","3":"大雨"}，权限 r 0

wind_speed（风速）：float，{"unit_name":"米每秒 / m/s"}，权限 r 0

environment_temperature（环境温度）：float，{"unit_name":"摄氏度 / °C"}，权限 r 0

temperature（舱内温度）：float，{"unit_name":"摄氏度 / °C"}，权限 r 0

humidity（舱内湿度）：float，{"unit_name":"相对湿度 / %RH"}，权限 r 0

10.

电力相关

electric_supply_voltage（市电电压）：int，{"unit_name":"伏特 / V"}，权限 r 0

working_voltage（工作电压）：int，{"unit_name":"毫伏 / mV"}，权限 r 0

working_current（工作电流）：float，{"unit_name":"毫安 / mA"}，权限 r 0

11.

存储相关

storage（存储容量）：struct，权限 r 0

total（总容量）：int，{"unit_name":"千字节 / KB"}

used（已使用容量）：int，{"unit_name":"千字节 / KB"}

12.

时间相关

first_power_on（首次上电时间）：int，{"unit_name":"毫秒 / ms"}，权限 r 0

acc_time（机场累计运行时长）：int，{"unit_name":"秒 / s"}，权限 r 1

activation_time（机场激活时间(unix 时间戳)）：int，{"unit_name":"秒 / s"}，权限 r 0

13.

固件一致性相关

compatible_status（固件一致性）：enum_int，{"0":"不需要一致性升级","1":"需要一致性升级"}，一致性升级：指飞行器某些模块的固件版本与系统匹配版本不一致，需要进行升级。常见的情况例如：飞行器与遥控器已经升级至最新版本，但替换电池时发现电池未升级，此时一致性升级将被提示。普通升级：开发者将飞行器所有模块升级至指定固件版本。权限 r 1

14.

备降点相关

alternate_land_point（备降点）：struct，权限 r 0

longitude（经度）：float

latitude（纬度）：float

safe_land_height（安全高度(备降转移高)）：float

is_configured（是否设置备降点）：enum_int，{"0":"未设置","1":"已设置"}

height（椭球高度）：float

height（椭球高度）：double，{"unit_name":"米 / m"}，权限 r 0

15.

电池相关

battery_store_mode（电池运行模式）：enum_int，{"1":"计划模式","2":"待命模式"}，计划模式适合规律作业场景，无任务时电池电量保持在55% - 60%，电池寿命较长。待命模式适合应急作业场景，无任务时电池电量保持在90% - 95%，电池寿命较短。权限 r 0

backup_battery（机场备用电池信息）：struct，权限 r 0

switch（备用电池开关）：enum_int，{"0":"关闭","1":"开启"}

voltage（备用电池电压）：int，{"desc":"备用电池关闭时电压为0","max":"30000","min":"0","step":"1","unit_name":"毫伏 / mV"}

temperature（备用电池温度）：float，{"step":"0.1","unit_name":"摄氏度 / °C"}，保留小数点后一位

drone_charge_state（飞行器充电状态）：struct，飞行器充电状态，权限 r 0

capacity_percent（电量百分比）：int，{"max":"100","min":"0"}

state（充电状态）：enum_int，{"0":"空闲","1":"充电中"}

16.

紧急与状态相关

emergency_stop_state（紧急停止按钮状态）：enum_int，{"0":"关闭","1":"开启"}，权限 r 0

position_state（搜星状态）：struct，权限 r 0

is_calibration（是否标定）：enum_int，{"0":"未标定","1":"已标定"}

is_fixed（是否收敛）：enum_int，{"0":"未开始","1":"收敛中","2":"收敛成功","3":"收敛失败"}

quality（搜星档位）：enum_int，{"1":"1档","2":"2档","3":"3档","4":"4档","5":"5档","10":"RTK fixed"}

gps_number（GPS 搜星数量）：int

rtk_number（RTK 搜星数量）：int

17.

保养相关

maintain_status（保养信息）：struct，权限 r 0

maintain_status_array（保养信息数组）：array，{"size": -, "item_type": struct}

state（保养状态）：enum_int，{"0":"无保养","1":"有保养"}

last_maintain_type（上一次保养类型）：enum_int，{"0":"无保养","17":"机场常规保养","18":"机场深度保养"}

last_maintain_time（上一次保养时间）：date，{"unit_name":"秒 / s"}

last_maintain_work_sorties（上一次保养时作业架次）：int，{"max":"2147483647","min":"0","step":"1"}

putter_state（推杆状态）：enum_int，{"0":"关闭","1":"打开","2":"半开","3":"推杆状态异常"}，权限 r 0

air_conditioner（机场空调工作状态信息）：struct，权限 r 0

air_conditioner_state（机场空调状态）：enum_int，

{"0":"空闲模式(无制冷、制热、除湿等)","1":"制冷模式","2":"制热模式","3":"除湿模式","4":"制冷退出模式","5":"制热退出模式","6":"除湿退出模式","7":"制冷准备模式","8":"制热准备模式","9":"除湿准备模式","10":"风冷准备中","11":"风冷中","12":"风冷退出中","13":"除雾准备中","14":"除雾中","15":"除雾退出中"}

，机场空调工作状态信息，空调仅存在一种工作模式

switch_time（剩余等待可切换时间）：int，{"unit_name":"秒 / s"}，模式切换顺序为准备模式、工作（制冷、制热、除湿）模式、退出模式、空闲模式。本属性将上报，可以切换下一个模式指令还需要等待的时间。例如当前机场空调在进入制冷模式后，必须制冷5分钟后才可以退出制冷模式，本属性将上报还需要多久退出制冷模式，为0表示随时可退出

drone_battery_maintenance_info（飞行器电池保养信息）：struct

maintenance_state（保养状态）：enum_int，{"0":"无需保养","1":"待保养","2":"正在保养"}

maintenance_time_left（电池保养剩余时间）：int，{"unit_name":"小时 / h"}

heat_state（电池加热保温状态）：enum_int，{"0":"电池未开启加热或保温","1":"电池在加热中","2":"电池在保温中"}，当飞行器舱内关机时由本物模型上报机场连接飞行器的电池加热保温信息

batteries（电池详细信息）：array，{"size": -, "item_type": struct}，当飞行器舱内关机时由本物模型上报机场连接飞行器的电池信息，基本数据与飞行器物模型中电池信息基本保持一致

capacity_percent（电池剩余电量）：int，{"max":100,"min":0}

index（电池序号）：enum_int，{"0":"左电池","1":"右电池"}

voltage（电压）：int，{"unit_name":"毫伏 / mV"}

temperature（温度）：float，{"unit_name":"摄氏度 / °C"}，保留小数点后一位，正常范围 - 40 - 150°C，设备端获取不到数据的异常值为32767

18.

其他相关

wpmz_version（机场的航线解析库版本号）：text，权限 r 1

drc_state（DRC 链路的状态）：enum_int，{"0":"未连接","1":"连接中","2":"已连接"}，权限 r 0

drone_authority_info（飞行器控制权状态更新）：struct

control_source（飞行控制权）：enum_string，{"":"未获取","A":"A控","B":"B控"}

locked（飞行控制权是否锁定(负载控制权不支持锁定)）：bool

payloads（负载）：array，{"size": -, "item_type": struct}

control_source（负载控制权）：enum_string，{"":"未获取","A":"A控","B":"B控"}

payload_index（负载编号）：text，负载编号，相机枚举值。非标准的 device_mode_key，格式为 {type - subtype - gimbalindex}，可以参考产品支持

sn（负载序列号（SN））：text

user_experience_improvement（用户体验改善计划）：enum_int，{"0":"初始状态","1":"拒绝加入用户体验改善计划","2":"同意加入用户体验改善计划"}，权限 rw 1

silent_mode（机场静音模式）：enum_int，{"0":"非静音模式","1":"静音模式"}，开启静音模式，意味着：1. 风扇转速降低、空调制冷性能下降、炎热天气下作业间隔变长。2. 蜂鸣器声音将关闭，开关舱盖时请注意周围安全。3. 机场待机状态的白色指示灯关闭，其他运行状态的指示灯正常。权限 rw 1

设备实时推送详情信息字段说明

数据字段说明

请求参数

请求示例代码

返回响应

设备实时推送详情信息字段说明

数据字段说明#

请求参数

请求示例代码

返回响应

数据字段说明