跳到主要内容

EVO III 设备属性

设备属性列表​

  • pushMode:

    • 0:设备推送定频数据,设备将以 0.5HZ 的频率定时上报 (Topic:thing/product/{device_sn}/osd)
    • 1:设备推送状态数据,设备在状态变化时上报(Topic:thing/product/{device_sn}/state)
  • accessMode:

    • r:属性只读
    • rw:属性可读写 (Topic:thing/product/{gateway_sn}/property/set)
ColumnNameTypeconstraintDescriptionaccessModepushMode
payloads负载状态array{"size": -, "item_type": struct}无人机当前挂载的负载设备列表r1
»payload_index负载编号text负载索引,格式为 {type-subtype-gimbalindex}r1
»sn负载序列号(SN)text负载设备唯一识别码r1
»payload_id负载 IDintAgent 为该负载分配的 IDr1
»payload_type负载类型int{5:照明喊话一体机,6:喊话器}PSDK 负载类型,其余取值由 SDK 定义r1
»payload_position负载位置int{0:未知,1:前,2:后,3:左,4:右,5:上,6:下}负载在机身上的安装位置r1
»is_online在线状态int{0:离线,1:在线}负载当前是否在线r1
»last_active_time上次激活时间long负载最近一次活跃的时间戳;PSDK 负载当前固件未写入该字段r1
»control_source负载控制权text{"A":A 控,"B":B 控}当前拥有该负载控制权的一端r1
»firmware_version负载固件版本text负载设备的固件版本号r1
»psdklib_versionPSDK 库版本textPSDK 负载的库版本号r1
»payload_version负载版本textPSDK 负载的固件版本号r1
mode_code无人机状态enum_int{"0":"待机","1":"起飞准备","2":"起飞准备完毕","3":"手动飞行","4":"自动起飞","5":"航线飞行","6":"全景拍照","7":"智能跟随","8":"ADS-B 躲避", "9":"自动返航","10":"自动降落","11":"强制降落","12":"三桨叶降落","13":"升级中","14":"未连接","15":"APAS","16":"虚拟摇杆状态", "17":"矩形","18":"多边形","19":"倾斜摄影","20":"保留字段","21":"精准复拍","22":"延时摄影","23":"环绕","25":"螺旋","26":"超清", "27":"智能图传打点模式","28":"红外跟踪","29":"智能任务航线飞行","30":"智能任务多边形仿地","31":"智能任务单体环绕","32":"全景智能检测","33":"安防智能检测", "34":"gps逃逸模式","35":"异常模式状态,当前只是planner进程挂掉,会切换至此模","36":"蜂群编队模式","37":"快速任务", "38":"建模环综模式","39":"kml航线模式","40":"区域搜索","71":"跟踪-目标识别","72":"跟踪-云台锁定","73":"跟踪-环绕跟踪"}当前无人机飞行状态码r0
distance_limit_status无人机限远状态struct无人机限远功能的整体状态信息rw0
»state是否开启限远enum_int{"0":"未设置","1":"已设置"}限远功能开关状态0
»distance_limit限远距离int{"max":"8000","min":"15","step":"1","unit_name":"米 / m"}设定的最大飞行距离0
»is_near_distance_limit是否接近设定的限制距离enum_int{"0":"未达到设定的限制距离","1":"接近设定的限制距离"}无人机是否即将达到限远距离r0
cameras无人机相机信息array{"size": -, "item_type": struct}无人机当前相机状态列表r0
»[array_item]Elements in arraystruct单个相机信息
»»payload_index负载编号text10902-0-0负载编号,相机枚举值。非标准的 device_mode_key,格式为 {type-subtype-gimbalindex},可以参考产品支持页面r0
»»camera_mode相机模式enum_int{"0":"拍照","1":"录像"}相机模式r0
»»zoom_factor变焦倍数float{"max":160,"min":1}当前变焦镜头倍数r0
»»wide_factor广角变焦倍数float{"max":160,"min":1}当前广角镜头变焦倍数r0
»»night_factor夜视变焦倍数float{"max":160,"min":1}当前夜视镜头变焦倍数r0
»»ir_zoom_factor红外变焦倍数float{"max":16,"min":1}当前红外镜头变焦倍数r0
»»photo_storage_settings拍照能力集String in array{"zoom":变焦, "wide":广角, "ir":红外,"NightVision": 夜视 }当前支持拍照的镜头类型列表0
»»video_storage_settings录像能力集String in array{"zoom":变焦, "wide":广角, "ir":红外,"NightVision": 夜视 }当前支持录像的镜头类型列表0
»»photo_state拍照状态enum_int{"0":"空闲","1":"工作中"}相机当前拍照工作状态r0
»»record_time当前录像时长int{"unit_name":"秒 / s"}当前正在录制的视频时长r0
»»recording_state录像状态enum_int{"0":"空闲","1":"工作中"}相机当前录像工作状态r0
»»remain_photo_num剩余可拍照数量long存储卡剩余可拍照数量r0
»»remain_record_duration剩余可录像时长int{"unit_name":"秒 / s"}存储卡剩余可录像时长r0
»»screen_split_enable分屏开关int{"0":"关闭","1":"开启"}画面分屏显示开关状态r0
»»ir_metering_mode红外测温模式int{"0":"关闭测温","1":"点测温","2":"区域测温"}红外相机测温功能的工作模式r0
»»ir_metering_point红外点测温数据structir_metering_mode == 1 时有数据r0
»»»x测温点X坐标double点测温目标的归一化X坐标r0
»»»y测温点Y坐标double点测温目标的归一化Y坐标r0
»»»temperature测温点温度double点测温目标的温度值r0
»»ir_metering_area红外区域测温数据structir_metering_mode == 2 时有数据r0
»»»x测温区域X坐标double区域测温左上角归一化X坐标r0
»»»y测温区域Y坐标double区域测温左上角归一化Y坐标r0
»»»width测温区域宽度double区域测温归一化宽度r0
»»»height测温区域高度double区域测温归一化高度r0
»»»aver_temperature区域平均温度double区域内的平均温度r0
»»»min_temperature_point最低温度点struct区域内最低温度的位置和温度值r0
»»»»xX坐标double最低温度点的归一化X坐标r0
»»»»yY坐标double最低温度点的归一化Y坐标r0
»»»»temperature温度double区域内的最低温度值r0
»»»max_temperature_point最高温度点struct区域内最高温度的位置和温度值r0
»»»»xX坐标double最高温度点的归一化X坐标r0
»»»»yY坐标double最高温度点的归一化Y坐标r0
»»»»temperature温度double区域内的最高温度值r0
»»zoom_fov_h变焦水平视场角float变焦镜头水平视场角r0
»»zoom_fov_v变焦垂直视场角float变焦镜头垂直视场角r0
»»zoom_focal_length变焦焦距float变焦镜头当前焦距r0
»»wide_fov_h广角水平视场角float广角镜头水平视场角r0
»»wide_fov_v广角垂直视场角float广角镜头垂直视场角r0
»»wide_focal_length广角焦距float广角镜头当前焦距r0
»»ir_fov_h红外水平视场角float红外镜头水平视场角r0
»»ir_fov_v红外垂直视场角float红外镜头垂直视场角r0
»»ir_focal_length红外焦距float红外镜头当前焦距r0
»»nightvision_fov_h夜视水平视场角float夜视镜头水平视场角r0
»»nightvision_fov_v夜视垂直视场角float夜视镜头垂直视场角r0
»»nightvision_focal_length夜视焦距float夜视镜头当前焦距r0
»»arm_light机臂灯状态int{0:关闭,1:开启}机臂补光灯开关状态r0
»»brightness_value画面亮度int可见光画面亮度值r0
»»defog_mode去雾模式int{0:关闭,1:开启}相机去雾功能开关r0
»»gimbal_dehaze_enable云台去雾开关int{0:关闭,1:开启}云台侧去雾增强开关r0
»»exposure_compensation曝光补偿int当前曝光补偿档位r0
»»min_exposure_compensation曝光补偿最小值int曝光补偿可设置的下限r0
»»max_exposure_compensation曝光补偿最大值int曝光补偿可设置的上限r0
»»linkage_zoom_mode联动变焦模式int{0:关闭,1:开启}多镜头联动变焦开关r0
»»ultra_pixel_mode超像素模式int{0:关闭,1:开启}超分辨率拍照模式开关r0
»»video_encode_settings视频编码格式int{0:H264,1:H265}当前视频编码方式r0
»»video_format_settings视频封装格式int{0:MOV,1:MP4,2:TIFF}当前视频文件封装格式r0
»»video_subtitle_mode视频字幕模式int{0:关闭,1:开启}录像字幕叠加开关r0
»»zoom_focus_mode变焦对焦模式enum_int{1:自动对焦(AF),2:手动对焦(MF)}变焦镜头对焦方式r0
»»zoom_focus_value变焦对焦值int变焦镜头当前对焦位置r0
»»zoom_iso_mode变焦 ISO 模式int{0:自动,1:手动}变焦镜头 ISO 控制方式r0
»»zoom_iso变焦 ISO 值int变焦镜头当前 ISOr0
»»zoom_shutter_mode变焦快门模式int{0:自动,1:手动}变焦镜头快门控制方式r0
»»zoom_shutter_speed变焦快门速度float{"unit_name":"秒 / s"}变焦镜头当前快门时间r0
»»zoom_white_balance_mode变焦白平衡模式int{0:自动,1:手动}变焦镜头白平衡控制方式r0
»»zoom_white_balance_value变焦白平衡色温int{"unit_name":"开尔文 / K"}变焦镜头当前白平衡色温r0
»»thermal_fusion_enable红外融合开关int{0:关闭,1:开启}红外与可见光图像融合开关r0
»»thermal_super_resolution红外超分辨率int{0:关闭,1:开启}红外图像超分辨率开关r0
»»thermal_gain_mode红外增益模式int{1:高增益,2:低增益}红外测温增益档位r0
»»thermal_emissivity红外发射率int{"max":100,"min":1}取值 1-100,实际发射率 = 该值 / 100r0
»»thermal_image_mode红外图像模式int红外图像显示模式r0
»»thermal_image_brightness红外图像亮度int红外图像亮度值r0
»»thermal_image_contrast红外图像对比度int红外图像对比度值r0
»»thermal_image_enhance_mode红外图像增强开关int{0:关闭,1:开启}红外图像细节增强开关r0
»»thermal_image_enhance_value红外图像增强强度int红外图像细节增强等级r0
»»thermal_image_setting红外图像设置struct上述红外图像参数的聚合结构r0
»»»thermal_image_enhance图像增强设置struct红外图像增强的开关与强度r0
»»»»enable是否开启int{0:关闭,1:开启}图像增强开关r0
»»»»value增强强度int图像增强等级r0
»»»thermal_image_mode图像模式设置struct红外图像模式与亮度对比度r0
»»»»mode图像模式int红外图像显示模式r0
»»»»brightness亮度int红外图像亮度r0
»»»»contrast对比度int红外图像对比度r0
»»thermal_isotherm_state等温线开关int{0:关闭,1:开启}红外等温线功能开关r0
»»thermal_isotherm_lower_limit等温线下限int{"unit_name":"摄氏度 / °C"}等温线温度下限r0
»»thermal_isotherm_upper_limit等温线上限int{"unit_name":"摄氏度 / °C"}等温线温度上限r0
»»thermal_thermometry红外测温设置struct发射率与等温线的聚合结构r0
»»»emissivity发射率int{"max":100,"min":1}取值 1-100,实际发射率 = 该值 / 100r0
»»»thermal_isotherm等温线设置struct等温线类型与上下限r0
»»»»type等温线类型int等温线显示类型r0
»»»»low下限int{"unit_name":"摄氏度 / °C"}等温线温度下限r0
»»»»high上限int{"unit_name":"摄氏度 / °C"}等温线温度上限r0
horizontal_speed水平速度float{"unit_name":"米每秒 / m/s"}无人机当前水平飞行速度r0
vertical_speed垂直速度float{"unit_name":"米每秒 / m/s"}无人机当前垂直飞行速度r0
longitude当前位置经度float无人机当前位置经度,WGS84坐标系r0
latitude当前位置纬度float无人机当前位置纬度,WGS84坐标系r0
height绝对高度float海拔高度r0
elevation相对起飞点高度float无人机相对于起飞点的飞行高度r0
attitude_pitch俯仰轴角度float无人机机体俯仰轴角度r0
attitude_roll横滚轴角度float无人机机体横滚轴角度r0
attitude_head偏航轴角度int偏航轴角度与真北角(经线)的角度,0到6点钟方向为正值,6到12点钟方向为负值r0
home_distance距离 Home 点的距离float无人机与返航点之间的水平距离r0
wind_speed风速float{"unit_name":"米每秒 / m/s"}无人机当前位置环境风速r0
battery无人机电池信息struct无人机电池整体信息r0
»capacity_percent电池的总剩余电量int{"max":100,"min":0}所有电池的综合剩余电量百分比r0
»remain_flight_time剩余飞行时长int单位s基于当前电量估算的剩余可飞行时间r0
»temperature电池组温度float{"unit_name":"摄氏度 / °C"}电池组当前温度r0
»voltage电池组电压float{"unit_name":"伏 / V"}电池组当前电压r0
»batteries多电池列表array各电池的独立状态信息列表r0
»»index电池IDint电池在机身中的位置索引r0
»»sn电池序列号(SN)text电池唯一序列号r0
»»capacity_percent电池电量百分比int{"max":100,"min":0}单块电池的剩余电量百分比r0
»»temperature温度float{"unit_name":"摄氏度 / °C"}电池当前温度r0
»»voltage电压float{"unit_name":"伏 / V"}电池当前电压r0
»»loop_times电池循环次数int电池放电次数电池完整充放电循环次数r0
»»firmware_version电池固件版本text单块电池的固件版本号r0
position_state搜星状态struct无人机定位系统综合状态r0
»coordinate_sysrtk坐标系统Int{0:WGS84, 1:RTK移动站}RTK定位使用的坐标系类型r0
»fix_stafix状态Int{0:未fix, 1:fix}RTK定位的Fix解算状态0
»is_fixed是否收敛enum_int{"0":"未开始","1":"收敛中","2":"收敛成功","3":"收敛失败"}RTK定位是否完成收敛;实际由 pos_type 推导,大于 47 上报 2,否则上报 3r0
»quality搜星档位enum_int{"1":"1档","2":"2档","3":"3档","4":"4档","5":"5档"}卫星信号质量等级r0
»rtk_inposrtk模块是否在位置int{0:没有在位置, 1: 在位置}RTK模块定位是否就绪r0
»rtk_used是否使用rtk定位Int{0:没有使用, 1: 在使用}当前定位是否使用RTK增强r0
»rtk_hgtrtk高度DoubleRTK解算的椭球高度r0
»rtk_latrtk纬度DoubleRTK解算的纬度值r0
»rtk_lonrtk经度DoubleRTK解算的经度值r0
»gps_numberGPS 搜星数量int当前GPS可见卫星数量r0
»rtk_numberRTK 搜星数量int当前RTK可见卫星数量r0
»calibration校准状态int当前固件固定上报 0r0
»rtk_enabled是否启用 RTKbool{true:启用,false:未启用}飞机侧 RTK 功能开关r0
»rtk_inpos_stateRTK 定位状态int当前固件固定上报 0r0
»rtk_report_usedRTK 上报使用标志int{0:未使用,1:使用}飞控上报的 RTK 使用标志;rtk_used 由本字段与 rtk_enabled 共同推导r0
{type-subtype-gimbalindex}负载编号struct动态键,键名与该负载的 payload_index 一致,如 "10902-0-0"r0
»gimbal_pitch云台俯仰轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台俯仰轴当前角度r0
»gimbal_roll云台横滚轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台横滚轴当前角度r0
»gimbal_yaw云台偏航轴角度double{"max":"180","min":"-180","step":0.1,"unit_name":"度 / °"}云台偏航轴当前角度r0
»payload_index负载索引,格式为 {type-subtype-gimbalindex}text负载设备的索引标识r1
»zoom_factor变焦倍数double当前镜头变焦倍数r0
»thermal_current_palette_style调色盘样式enum_int{0:白热,1:冷热,2:彩虹,3:增强彩虹,4:铁红,5:熔岩,6:极光,7:灼热,8:渐变,9:热探测,(高德红外)30:白热,31:黑热,32:彩虹1,33:彩虹2,34:铁红,35:熔岩,36:北极,38:医疗,39:描红}红外相机提供多种调色样式,用户可根据不同的场景选择不同的色彩,便于更加清晰地查看目标rw0
»thermal_supported_palette_styles设备支持的调色盘样式集合array{"item":{"specs":{0:白热,1:冷热,2:彩虹,3:增强彩虹,4:铁红,5:熔岩,6:极光,7:灼热,8:渐变,9:热探测,(高德红外)30:白热,31:黑热,32:彩虹1,33:彩虹2,34:铁红,35:熔岩,36:北极,38:医疗,39:描红},"type":"enum_int"}}不同设备所支持的样式能力有所不同r0
»gimbal_pitch_max_speed云台俯仰最大速度int{"unit_name":"度每秒 / °/s"}云台俯仰轴的最大转动速度r0
»measure_target_error_state激光测距开关int{0:关闭,1:打开}激光测距功能开关状态,非测距结果有效性r0
»measure_target_distance激光测距目标距离double{"unit_name":"米 / m"}激光测距测得的目标距离r0
»measure_target_longitude激光测距目标经度double激光测距目标点经度r0
»measure_target_latitude激光测距目标纬度double激光测距目标点纬度r0
»measure_target_altitude激光测距目标绝对高度double{"unit_name":"米 / m"}激光测距目标点绝对高度r0
»iso_support_list支持的 ISO 列表array{"item_type": struct}各镜头支持的 ISO 取值集合r0
»»lens_type镜头类型text{"zoom":变焦,"wide":广角,"ir":红外,"NightVision":夜视}该能力集对应的镜头r0
»»iso_values可选 ISO 值array{"item_type": int}该镜头支持的 ISO 档位列表r0
»shutter_speed_support_list支持的快门速度列表array{"item_type": struct}各镜头支持的快门速度集合r0
»»lens_type镜头类型text{"zoom":变焦,"wide":广角,"ir":红外,"NightVision":夜视}该能力集对应的镜头r0
»»shutter_speed_values可选快门速度array{"item_type": struct}以分数形式表示的快门速度列表r0
»»»numerator分子int快门速度分数的分子r0
»»»denominator分母int快门速度分数的分母,如 1/10000 秒r0
»white_balance_support_list支持的白平衡范围array{"item_type": struct}各镜头支持的白平衡色温范围r0
»»lens_type镜头类型text{"zoom":变焦,"wide":广角,"ir":红外,"NightVision":夜视}该能力集对应的镜头r0
»»min_value最小色温int{"unit_name":"开尔文 / K"}白平衡可设置的最低色温r0
»»max_value最大色温int{"unit_name":"开尔文 / K"}白平衡可设置的最高色温r0
»»step步进int色温调节步进值r0
»object_distance_support_list支持的对焦距离范围array{"item_type": struct}各镜头支持的对焦物距范围r0
»»lens_type镜头类型text{"zoom":变焦,"wide":广角,"ir":红外,"NightVision":夜视}该能力集对应的镜头r0
»»min_value最小对焦距离int{"unit_name":"米 / m"}可对焦的最近物距r0
»»max_value最大对焦距离int{"unit_name":"米 / m"}可对焦的最远物距r0
»»step步进int对焦距离调节步进值r0
»thermal_area_temperature红外测温数据struct红外相机测温区域与温度结果r0
»»metering_mode测温模式int{0:点测温,1:区域测温}红外测温工作模式r0
»»metering_point_x点测温 X 坐标double{"max":1.0,"min":0.0}归一化画面宽度比例r0
»»metering_point_y点测温 Y 坐标double{"max":1.0,"min":0.0}归一化画面高度比例r0
»»metering_area_x测温区域左上角 Xdouble{"max":1.0,"min":0.0}归一化画面宽度比例r0
»»metering_area_y测温区域左上角 Ydouble{"max":1.0,"min":0.0}归一化画面高度比例r0
»»metering_area_width测温区域宽度double{"max":1.0,"min":0.0}归一化区域宽度r0
»»metering_area_height测温区域高度double{"max":1.0,"min":0.0}归一化区域高度r0
»»max_area_temp区域最高温度double{"unit_name":"摄氏度 / °C"}测温区域内的最高温度r0
»»min_area_temp区域最低温度double{"unit_name":"摄氏度 / °C"}测温区域内的最低温度r0
»»avg_area_temp区域平均温度double{"unit_name":"摄氏度 / °C"}测温区域内的平均温度r0
»»center_area_temp区域中心温度double{"unit_name":"摄氏度 / °C"}测温区域中心点温度r0
»»max_temp_point_x最高温点 X 坐标double{"max":1.0,"min":0.0}归一化画面宽度比例r0
»»max_temp_point_y最高温点 Y 坐标double{"max":1.0,"min":0.0}归一化画面高度比例r0
»»min_temp_point_x最低温点 X 坐标double{"max":1.0,"min":0.0}归一化画面宽度比例r0
»»min_temp_point_y最低温点 Y 坐标double{"max":1.0,"min":0.0}归一化画面高度比例r0
»»touch_temp触摸点温度double手动触摸点的温度值r0
»thermal_emissivity红外发射率int{"max":100,"min":1}取值 1-100,实际发射率 = 该值 / 100r0
»thermal_gain_mode红外增益模式int{1:高增益,2:低增益}红外测温增益档位r0
»thermal_image_mode红外图像模式int红外图像显示模式r0
»thermal_image_brightness红外图像亮度int红外图像亮度值r0
»thermal_image_contrast红外图像对比度int红外图像对比度值r0
»thermal_image_enhance_mode红外图像增强开关int{0:关闭,1:开启}红外图像细节增强开关r0
»thermal_image_enhance_value红外图像增强强度int红外图像细节增强等级r0
»thermal_image_setting红外图像设置struct上述红外图像参数的聚合结构r0
»»thermal_image_enhance图像增强设置struct红外图像增强的开关与强度r0
»»»enable是否开启int{0:关闭,1:开启}图像增强开关r0
»»»value增强强度int图像增强等级r0
»»thermal_image_mode图像模式设置struct红外图像模式与亮度对比度r0
»»»mode图像模式int红外图像显示模式r0
»»»brightness亮度int红外图像亮度r0
»»»contrast对比度int红外图像对比度r0
»thermal_isotherm_state等温线开关int{0:关闭,1:开启}红外等温线功能开关r0
»thermal_isotherm_lower_limit等温线下限int{"unit_name":"摄氏度 / °C"}等温线温度下限r0
»thermal_isotherm_upper_limit等温线上限int{"unit_name":"摄氏度 / °C"}等温线温度上限r0
»thermal_thermometry红外测温设置struct发射率与等温线的聚合结构r0
»»emissivity发射率int{"max":100,"min":1}取值 1-100,实际发射率 = 该值 / 100r0
»»thermal_isotherm等温线设置struct等温线类型与上下限r0
»»»type等温线类型int等温线显示类型r0
»»»low下限int{"unit_name":"摄氏度 / °C"}等温线温度下限r0
»»»high上限int{"unit_name":"摄氏度 / °C"}等温线温度上限r0
»zoom_photo_setting变焦拍照设置struct变焦镜头的拍照参数r0
»»photo_format照片格式int{0:JPG,1:DNG,2:JPG+DNG,3:RJPEG,4:RJPEG+TIFF,255:未知}拍照输出的文件格式r0
»»photo_size照片分辨率text格式 "宽x高"如 "4096x3072"r0
»zoom_video_setting变焦录像设置struct变焦镜头的录像参数r0
»»video_resolution视频分辨率text格式 "宽x高"如 "4000x3000"r0
»»video_fps视频帧率int{"unit_name":"帧每秒 / fps"}录像帧率r0
»thermal_photo_setting红外拍照设置struct红外镜头的拍照参数r0
»»photo_format照片格式int{0:JPG,1:DNG,2:JPG+DNG,3:RJPEG,4:RJPEG+TIFF,255:未知}拍照输出的文件格式r0
»»photo_size照片分辨率text格式 "宽x高"如 "640x512"r0
»thermal_video_setting红外录像设置struct红外镜头的录像参数r0
»»video_resolution视频分辨率text格式 "宽x高"如 "640x512"r0
»»video_fps视频帧率int{"unit_name":"帧每秒 / fps"}录像帧率r0
activation_time无人机激活时间(unix 时间戳)int{"unit_name":"毫秒 / ms"}无人机首次激活的时间戳r0
night_lights_state无人机夜航灯状态enum_int{"0":"关闭","1":"打开"}夜航灯的开关状态rw0
height_limit无人机限高int{"max":"1500","min":"20","step":"1","unit_name":"米 / m"}设定的最大飞行高度rw0
is_near_height_limit是否接近设定的限制高度enum_int{"0":"未达到设定的限制高度","1":"接近设定的限制高度"}无人机是否即将达到限高高度r0
is_near_area_limit是否接近限飞区enum_int{"0":"未达到限飞区","1":"接近限飞区"}无人机是否即将进入限飞区域r0
obstacle_avoidance无人机避障状态struct无人机避障功能整体状态rw0
»horizon水平避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
»upside上视避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
»downside下视避障状态enum_int{"0":"关闭","1":"开启"}注意:目前无人机是统一避障,没有区分0
»horizon_safe_distance水平避障安全距离double{"unit_name":"米 / m"}水平方向刹停的安全距离,默认 2.0r0
»horizon_warn_distance水平避障告警距离double{"unit_name":"米 / m"}水平方向开始告警的距离,默认 5.0r0
»upside_safe_distance上视避障安全距离double{"unit_name":"米 / m"}上方刹停的安全距离,默认 1.0r0
»upside_warn_distance上视避障告警距离double{"unit_name":"米 / m"}上方开始告警的距离,默认 5.0r0
»downside_safe_distance下视避障安全距离double{"unit_name":"米 / m"}下方刹停的安全距离,默认 1.0r0
»downside_warn_distance下视避障告警距离double{"unit_name":"米 / m"}下方开始告警的距离,默认 5.0r0
»landing_protection降落保护bool{true:开启,false:关闭}降落时的地面检测保护开关,默认开启r0
total_flight_time累计飞行时长Int单位s无人机历史累计飞行时间r0
total_armed_time本次打桨累计飞行时长Int单位s本次启动电机后的累计飞行时间r0
alarm_status告警状态Int{0:未告警 1 有告警}无人机当前是否存在告警r0
pos_typertk状态text{0:无解, 1:位置由FIX POSITION命令指定, 2:不支持 8:多普勒信息导出,16:单点定位 17:伪距差分解 18:SBAS定位 32:L1浮点解 33:消电离层浮点解 34:窄巷浮点解 48:L1固定解 49:宽巷固定解 50:窄巷固定节 52:纯惯导定位解 53:惯导与单点组合解 54: 惯导与伪距差分定位组合解 55:惯导与载波相位差分浮点解组合解 56:惯导与载波相位差分固定解组合解}RTK 定位解算类型,以十进制数字字符串上报(如 "21"),同时以 posType 键重复上报一份r0
wireless_link链路状态struct无人机无线链路状态信息r0
»link_workmode链路工作模式int{0:图传单链路,1:图传与 4G 融合}当前无线链路的工作方式r0
»sdr_link_state图传链路状态int{0:断开,1:连接}图传链路连接状态,由图传信号强度推导r0
»sdr_quality图传信号质量int{"max":5,"min":0}图传信号质量档位r0
»4g_link_state4G 链路状态int{0:断开,1:连接}由 lte_status == 4 推导r0
»4g_quality4G 信号质量int{"max":5,"min":0}4G 信号质量档位r0
»4g_uav_quality飞机侧 4G 信号质量int{"max":5,"min":0}与 4g_quality 同值,为兼容旧字段保留r0
»4g_sim_card_detected4G 是否插卡int{0:未插卡,1:已插卡}4G 模块是否检测到 SIM 卡r0
»4g_sdr_fusion_state4G 与图传融合状态int{0:未融合,1:已融合}由 link_workmode == 1 推导r0
»cellular_uav_type蜂窝网络类型int{0:4G,1:5G}飞机侧蜂窝网络制式r0
»cellular_uav_server_state蜂窝服务连接状态int{0:未连接,1:已连接}融合模式下 4G 已连接时为 1r0
»fourth_line_error_msg4G 链路错误信息text融合状态下默认为 "Login Success"r0
payload_Index云台负载struct云台负载的综合状态信息r0
»gimbal_pitch云台俯仰角double云台俯仰轴当前角度0
»gimbal_roll云台横滚角double云台横滚轴当前角度0
»gimbal_yaw云台偏航角double云台偏航轴当前角度0
»payload_index负载IDtext负载设备的索引标识0
»zoom_factor缩放倍数Int当前镜头变焦倍数0
lte_card_is_detected是否有插sim卡int{0:没有插卡, 1: 有插卡}无人机是否检测到SIM卡r0
lte_signal4g信号int{0,100}4G模块信号强度r0
lte_status4g卡状态int{0:不支持lte模块,1:关闭状态 2:未连接状态 3: 已连接,但网络不可达, 4:已连接}4G模块连接状态r0
remote_id_statusRemote id 工作状态int{0:关闭1:开启2:自检异常}Remote ID广播模块工作状态r0
control_source当前控制源text当前控制无人机的一端;当前固件由飞机运行模式映射得出,Normal 上报 "A",其余上报 "B"r1
ai_enable_funcai功能打开状态int{0:关闭, 1:打开}AI智能识别功能开关状态r0
country国家代码text无人机所在国家或地区的ISO代码r0
gear_level档位等级int{0:未知,1:平稳档,2:普通档,3:运动档4:低速档}无人机当前飞行档位rw0
gimbal_angle_follow_toggle云台角度跟随开关int{0:关闭, 1:打开}云台偏航角是否跟随机头方向r0
hae椭球高double基于WGS84椭球面的高度r0
infrared_palette_mode红外调色板模式int{0:白热, 1:冷热, 2:彩虹, 3:增强彩虹,4:铁红,5:熔岩,6:极光,7:灼热, 8:渐变,9:热探测, (高德红外)30:白热,31:黑热,32:彩虹1,33:彩虹2,34:铁红,35:熔岩,36:北极,38:医疗,39:描红}红外相机当前使用的调色板模式rw0
measure_target_error_state激光测距状态int{0:关闭, 1:打开}激光测距模块的工作状态r0
measure_target_distance激光测距距离double单位:米(measure_target_error_state == 1时有数据)激光测距的目标距离r0
measure_target_longitude激光测距目标经度double(measure_target_error_state == 1时有数据)激光测距计算的目标经度r0
measure_target_latitude激光测距目标纬度double(measure_target_error_state == 1时有数据)激光测距计算的目标纬度r0
measure_target_altitude激光测距目标高度double(measure_target_error_state == 1时有数据)激光测距计算的目标高度r0
main_mode飞机飞行模式int{0:未知,1:姿态模式,2:GNSS 模式,3:IOC(已废弃),4:视觉定位}飞机当前的飞行定位模式r0
ned_altitudened坐标高度doubleNED坐标系下的高度值r0
ned_latitudened坐标纬度doubleNED坐标系下的纬度值r0
ned_longitudened坐标经度doubleNED坐标系下的经度值r0
vel_ned_xNED坐标X方向速度(北向)floatNED坐标系下北向速度分量r0
vel_ned_yNED坐标Y方向速度(东向)floatNED坐标系下东向速度分量r0
vel_ned_zNED坐标Z方向速度(天向)floatNED坐标系下天向速度分量r0
ntrip_statusntrip模块状态text{"normal":正常,"error":异常}NTRIP 差分模块状态,为字符串而非整型枚举r0
storage存储信息struct无人机机载存储容量信息r0
»storage_type存储类型int{0:SD卡, 1:MMC}存储介质类型0
»total总容量int存储空间总容量0
»used已使用容量int存储空间已使用容量0
»current_used是否为当前使用的存储int{0:非当前使用,1:当前使用}相机当前写入的存储介质r0
out_of_control_action遥控器失联动作int{"0":"返航", “1”:“悬停”, "2":"降落" }遥控器信号丢失时无人机的处理动作rw0
exit_wayline_when_rc_lost航线失联动作int{"0":"继续执行航线任务", “1”:“退出航线任务,执行遥控器失控动作}航线执行中遥控器失联时的处理方式rw0
rth_altitude返航高度int无人机返航时的飞行高度rw0
rc_lost_action遥控器失控动作enum_int{"0":"悬停","1":"着陆(降落)","2":"返航"}遥控器失控时无人机执行的安全动作r0
intelligent_lock_mode智能锁定模式int{"0":"未进入智能锁定模式","1":"已进入智能锁定模式"}无人机是否处于智能锁定模式r0
manual_ctrl_gimbal航线下是否支持手动控制云台int{"0":"不支持手动控制云台","1":"支持手动控制云台"}航线执行时是否允许手动控制云台rw0
firmware_version飞机固件版本text无人机当前固件版本号r0
sn飞机序列号(SN)text无人机唯一序列号r0
sdcard_storageSD卡存储信息structSD存储卡容量信息r0
»storage_type存储类型int{0:SD卡, 1:MMC}存储介质类型r0
»total总容量int{"unit_name":"KB"}SD卡总容量r0
»used已使用容量int{"unit_name":"KB"}SD卡已使用容量r0
»current_used是否为当前使用的存储int{0:非当前使用,1:当前使用}相机当前写入的存储介质r0
speaker喊话器状态struct仅在挂载喊话器时上报r0
»work_mode工作模式int{1:默认模式}喊话器当前工作模式r0
psdk_widget_valuesPSDK 负载控件值array{"item_type": struct}仅在挂载PSDK负载时上报r0
»psdkIndex负载索引intPSDK负载在机身上的索引编号r0
»psdkName负载名称textPSDK负载设备名称r0
»psdkSn负载序列号textPSDK负载设备序列号r0
»psdkVersion负载固件版本textPSDK负载固件版本号r0
»psdkLibVersionPSDK库版本textPSDK库版本号r0
»speaker喊话器状态structPSDK负载喊话器模块状态r0
»»workMode工作模式int{0:TTS负载模式,1:录音喊话}喊话器工作模式r0
»»playMode播放模式int{0:单次播放,1:循环播放(单曲)}音频播放模式r0
»»playVolume播放音量int{"max":100,"min":0}喊话器播放音量r0
»»systemState喊话器系统状态int喊话器系统运行状态r0
»»playFileName播放文件名text当前播放的音频文件名r0
»»playFileMd5播放文件MD5text当前播放文件的MD5校验值r0
»»realTimeSpeakingStatus实时喊话状态int{0:未喊话,1:喊话中}是否正在进行实时喊话r0
»lightStatus探照灯状态structPSDK负载探照灯模块状态r0
»»switchStatus开关状态int{0:关闭,1:打开}探照灯开关状态r0
»»flashMode闪烁模式int探照灯闪烁模式r0
»»brightnessLevel亮度等级int探照灯亮度等级r0
»»pitchEngle俯仰角度int探照灯俯仰角度r0
»»pztLinkedStatusPZT联动状态int探照灯PZT联动状态r0
rid_stateRemote ID 状态int{0:关闭,1:开启,2:自检异常}Remote ID广播模块运行状态r0
laser_distance_data激光测距数据struct激光测距模块的测距结果r0
»laser_distance_is_valid激光测距是否有效int{0:无效,1:有效}激光测距数据是否有效r0
»laser_distance激光测距距离int{"unit_name":"厘米 / cm"}激光测距的距离值r0
live_fps_stats直播帧率统计struct直播推流帧率统计信息r0
»recv_frame_stats接收帧统计array{"item_type": struct}接收端帧率统计列表r0
»»fps_video_type视频类型text视频流类型标识r0
»»lag_count卡顿帧数int统计周期内的卡顿帧数r0
»»fps_count帧数量int统计周期内的总帧数r0
»send_frame_stats发送帧统计array{"item_type": struct}发送端帧率统计列表r0
»»fps_video_type视频类型text视频流类型标识r0
»»lag_count卡顿帧数int统计周期内的卡顿帧数r0
»»fps_count帧数量int统计周期内的总帧数r0
home_latitudeHome 点纬度double返航点纬度,WGS84 坐标系r0、1
home_longitudeHome 点经度double返航点经度,WGS84 坐标系r0、1
home_distance_latHome 点纬度差double(当前纬度 - Home 点纬度) × 1e7,由机巢计算r0
home_distance_lonHome 点经度差double(当前经度 - Home 点经度) × 1e7,由机巢计算r0
coor_distance_to_home距 Home 点直线距离double{"unit_name":"米 / m"}按 Haversine 公式由机巢计算r0
posTypeRTK 解状态(兼容键)text与 pos_type 完全同值,为兼容旧客户端保留的 camelCase 键r0
active_zoom_control变焦控制激活状态int{0:未激活,1:激活}变焦控制是否处于激活状态r0
compatible_status兼容性状态int当前固件固定上报 0r0
navigation_project_enable导航工程模式int{0:关闭,1:开启}缓存无值时不上报该字段rw0
total_flight_sorties累计飞行架次int出厂以来的累计飞行架次;缓存值为 -1 时不上报r0
track_type跟踪类型int{0:非跟踪中,1:跟踪中}智能锁定模式且跟踪状态为 TRACKING 时为 1,与 intelligent_lock_mode 联动r0
uom_stateUOM 注册状态int{0:未注册,1:已注册}来自飞控状态位;缓存无值时不上报r0
user_hide_mode用户隐藏模式int{0:关闭,1:开启}用户隐私隐藏模式开关rw0
track_setting跟踪参数设置struct智能跟踪的距离与高度参数rw0
»obstacle_avoidance跟踪避障开关int{0:关闭,1:开启}跟踪过程中的避障开关r0
»horizontal_distance跟踪水平距离int{"max":100,"min":10,"unit_name":"米 / m"}超出合法区间时不上报r0
»vertical_distance跟踪垂直距离int{"max":100,"min":10,"unit_name":"米 / m"}超出合法区间时不上报r0
»orbit_height环绕高度int{"max":100,"min":10,"unit_name":"米 / m"}超出合法区间时不上报r0
camera_watermark_settings相机水印设置struct拍照录像的水印叠加配置rw0
»global_enable水印总开关int{0:关闭,1:开启}水印功能总开关r0
»drone_type_enable机型水印int{0:关闭,1:开启}是否叠加机型信息r0
»drone_sn_enable飞机 SN 水印int{0:关闭,1:开启}是否叠加飞机序列号r0
»datetime_enable日期时间水印int{0:关闭,1:开启}是否叠加拍摄日期时间r0
»gps_enableGPS 坐标水印int{0:关闭,1:开启}是否叠加拍摄位置坐标r0
»user_custom_string_enable自定义文字水印int{0:关闭,1:开启}是否叠加用户自定义文字r0
»layout水印布局int水印在画面中的排布方式r0
dongle_infos蜂窝模块信息array{"item_type": struct}飞机侧 LTE 模块与 SIM 卡信息,缓存为空时不上报r0、1
»dongle_type模块类型int{0:内置,1:外置 Dongle}蜂窝模块的接入方式r0、1
»imeiIMEItext当前固件恒为空串,SDK 未提供该数据r0、1
»eideSIM EIDtexteSIM 的 EID 标识r0、1
»esim_activate_stateeSIM 激活状态int{0:未知,1:检测到 eSIM 但无启用 Profile,2:已有启用 Profile}eSIM 的 Profile 启用情况r0、1
»esim_infoseSIM 列表array{"item_type": struct}已写入的 eSIM Profile 列表r0、1
»»telecom_operator运营商int{0:未知,1:移动,2:联通,3:电信}由 PLMN 映射得到r0、1
»»enabled是否启用bool{true:启用,false:未启用}该 Profile 是否为当前启用项r0、1
»»iccidICCIDtexteSIM Profile 的 ICCIDr0、1
»sim_card_stateSIM 卡状态int{0:未插入,1:已插入}实体 SIM 卡在位状态r0、1
»sim_slotSIM 卡槽int{0:未知,1:实体 SIM,2:eSIM}当前生效的卡槽类型r0、1
»sim_info实体 SIM 信息struct实体 SIM 卡的运营商与 ICCIDr0、1
»»iccidICCIDtext实体 SIM 卡的 ICCIDr0、1
»»sim_typeSIM 类型int当前固件恒为 0(未知),SDK 未提供该数据r0、1
»»telecom_operator运营商int{0:未知,1:移动,2:联通,3:电信}由 PLMN 映射得到r0、1
camera_settings相机拍录参数array{"item_type": struct}各镜头当前的拍照与录像参数r1
»camera_type镜头类型text{"zoom":变焦,"ir":红外}该组参数对应的镜头r1
»photo_format照片格式int{0:JPG,1:DNG,2:JPG+DNG,3:RJPEG,4:RJPEG+TIFF,255:未知}拍照输出的文件格式r1
»photo_size照片分辨率text格式 "宽x高"如 "4096x3072",为字符串而非枚举r1
»video_resolution视频分辨率text格式 "宽x高"如 "4000x3000",为字符串而非枚举r1
»video_fps视频帧率int{"unit_name":"帧每秒 / fps"}取值大于 0 时才上报r1
current_firmware_version组件固件版本列表array{"item_type": struct}飞机各组件的版本信息,缓存为空时不上报r1
»component_id组件标识text如 PLATFORM_SKYLINK / PLATFORM_VISION / GPS / FCS / CAMERA / GIMBAL / BATTERY / ESC1 / ESC2 / RADAR / SYSTEM_PACK;未收录的组件上报为 UNKNOWN_{数值 ID}r1
»component_type组件类型text如 TARGET_FCS / TARGET_CAMERA / TARGET_GIMBAL / TARGET_BATTERY / TARGET_ESC / TARGET_RADAR / FCS_GATEWAY / SYSTEM_PACK;未收录的组件上报为 UNKNOWN_{数值 ID}r1
»component_model组件型号int组件型号数值r1
»str_component_model组件型号(字符串)text组件型号的字符串表示r1
»component_sn组件序列号text组件的唯一序列号r1
»software_version软件版本text格式 V{major}.{minor}.{patch}.{build}组件当前软件版本r1
»hardware_version硬件版本text组件硬件版本r1
»bootloader_versionBootloader 版本text组件 Bootloader 版本r1
»label组件标签text组件的标签信息r1
»data_source数据来源int{0:版本消息被动上报,1:主动查询}该条版本信息的获取方式r1
locked飞机是否锁定bool{true:锁定,false:未锁定}当前固件恒为 falser1
low_battery_warning_enable低电量告警开关int{0:关闭,1:开启}智能低电返航开关;缓存无值时不上报rw1
low_battery_warning_threshold低电量告警阈值int{"max":100,"min":0,"unit_name":"百分比 / %"}触发低电量告警的剩余电量rw1
serious_low_battery_warning_threshold严重低电量告警阈值int{"max":100,"min":0,"unit_name":"百分比 / %"}触发严重低电量告警的剩余电量rw1

负载上报​

Topic: thing/product/{device_sn}/state

Direction: up

方向:上行(设备->云)

Data:

ColumnNameType备注
payload_list负载列表array
»payload_id负载idint
»payload_type负载类型int
»is_online在线状态int
»last_active_time上次激活时间Long
»payload_position负载位置int
»psdklib_versionpsdk版本String
»payload_version负载版本String

示例:

{
"bid": "6b3665e1-be0f-4c7c-86ee-e387edd668e7",
"data":{
"payloads": [{
"last_active_time": 315535819380,
"payload_id": 10001,
"payload_index": "10306-0-0",
"payload_position": 2,
"payload_version": "",
"psdklib_version": "",
"is_online": 1
}]
},
"gateway": "TH7923350808",
"tid": "c441054b-88f7-4d88-ae66-2732f803310c",
"timestamp": 1724054078099
}