命令 Payload

本页列出 001 已支持的 DJI 云端到设备 command_type 及对应 payload 示例。Open Platform 下行命令统一调用 POST /api/v1/open/downlink/commands；command_type 映射到 DJI services.method，payload 映射到 DJI services.data。

payload 必须是 JSON object。无参数命令使用空对象 {}，不能省略。

代码演示

下面示例只演示调用结构。生产环境必须按照鉴权与签名计算签名。

cURL

BODY='{"vendor":"dji","device_id":"drone-001","command_type":"camera_photo_take","payload":{"payload_index":"52-0-0"},"idempotency_key":"req-camera-photo-001","timeout_seconds":30}'
TIMESTAMP="$(date +%s)"
NONCE="$(uuidgen)"
SIGNATURE="YOUR_CALCULATED_SIGNATURE"

curl -X POST "https://dev.utmos.dev/api/v1/open/downlink/commands" \
  -H "Content-Type: application/json" \
  -H "X-Api-Id: YOUR_API_ID" \
  -H "X-Api-Timestamp: $TIMESTAMP" \
  -H "X-Api-Nonce: $NONCE" \
  -H "X-Api-Signature: $SIGNATURE" \
  -d "$BODY"

TypeScript

const body = {
  vendor: "dji",
  device_id: "drone-001",
  command_type: "camera_photo_take",
  payload: { payload_index: "52-0-0" },
  idempotency_key: "req-camera-photo-001",
  timeout_seconds: 30,
};

const timestamp = Math.floor(Date.now() / 1000).toString();
const nonce = crypto.randomUUID();
const signature = await signOpenPlatformRequest({
  method: "POST",
  path: "/api/v1/open/downlink/commands",
  timestamp,
  nonce,
  body: JSON.stringify(body),
  secret: "YOUR_API_SECRET",
});

const resp = await fetch("https://dev.utmos.dev/api/v1/open/downlink/commands", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Id": "YOUR_API_ID",
    "X-Api-Timestamp": timestamp,
    "X-Api-Nonce": nonce,
    "X-Api-Signature": signature,
  },
  body: JSON.stringify(body),
});

console.log(await resp.json());

body := []byte(`{"vendor":"dji","device_id":"drone-001","command_type":"camera_photo_take","payload":{"payload_index":"52-0-0"},"idempotency_key":"req-camera-photo-001","timeout_seconds":30}`)
req, err := http.NewRequest(http.MethodPost, "https://dev.utmos.dev/api/v1/open/downlink/commands", bytes.NewReader(body))
if err != nil {
    return err
}

timestamp := strconv.FormatInt(time.Now().Unix(), 10)
nonce := uuid.NewString()
signature := signOpenPlatformRequest(http.MethodPost, "/api/v1/open/downlink/commands", timestamp, nonce, body, apiSecret)

req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Api-Id", apiID)
req.Header.Set("X-Api-Timestamp", timestamp)
req.Header.Set("X-Api-Nonce", nonce)
req.Header.Set("X-Api-Signature", signature)

resp, err := http.DefaultClient.Do(req)
if err != nil {
    return err
}
defer resp.Body.Close()

DJI Payload 全量目录

device

`air_conditioner_mode_switch`

Field	Type	Required	说明
`payload.action`	integer	是	Air conditioner mode: 0=idle, 1=cooling, 2=heating, 3=dehumidify

{
  "action": 0
}

`alarm_state_switch`

Field	Type	Required	说明
`payload.action`	integer	是	Alarm state: 0=off, 1=on

{
  "action": 0
}

`battery_maintenance_switch`

Field	Type	Required	说明
`payload.action`	integer	是	Battery maintenance mode: 0=off, 1=on

{
  "action": 0
}

`battery_store_mode_switch`

Field	Type	Required	说明
`payload.action`	integer	是	Battery store mode: 1=plan, 2=standby

{
  "action": 0
}

`charge_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`charge_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`cover_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`cover_force_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`cover_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`debug_mode_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`debug_mode_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`device_format`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`device_reboot`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`drone_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`drone_format`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`drone_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`putter_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`putter_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`sdr_workmode_switch`

Field	Type	Required	说明
`payload.link_workmode`	integer	是	Link work mode: 0=SDR only, 1=4G enhanced

{
  "link_workmode": 0
}

`supplement_light_close`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`supplement_light_open`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

camera

`camera_aim`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: ir, wide, zoom
`payload.locked`	boolean	是	Whether aircraft head and gimbal relationship is locked
`payload.x`	number	是	Target coordinate x (0-1)
`payload.y`	number	是	Target coordinate y (0-1)

{
  "payload_index": "string",
  "camera_type": "string",
  "locked": true,
  "x": 0,
  "y": 0
}

`camera_exposure_mode_set`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: wide, zoom
`payload.exposure_mode`	integer	是	Exposure mode: 1=auto, 2=shutter_priority, 3=aperture_priority, 4=manual

{
  "payload_index": "string",
  "camera_type": "string",
  "exposure_mode": 0
}

`camera_exposure_set`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: wide, zoom
`payload.exposure_value`	string	是	Exposure value: 1=-5.0EV, 2=-4.7EV, …, 16=0EV, …, 31=5.0EV, 255=FIXED

{
  "payload_index": "string",
  "camera_type": "string",
  "exposure_value": "string"
}

`camera_focal_length_set`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: ir, wide, zoom
`payload.zoom_factor`	number	是	Zoom factor (2-200 for visible light, 2-20 for IR)

{
  "payload_index": "string",
  "camera_type": "string",
  "zoom_factor": 0
}

`camera_focus_mode_set`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: wide, zoom (M30 series only supports zoom)
`payload.focus_mode`	integer	是	Focus mode: 0=MF (manual), 1=AFS (auto single), 2=AFC (auto continuous)

{
  "payload_index": "string",
  "camera_type": "string",
  "focus_mode": 0
}

`camera_focus_value_set`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: wide, zoom (M30 series only supports zoom)
`payload.focus_value`	integer	是	Focus value (range from zoom_min_focus_value to zoom_max_focus_value in OSD)

{
  "payload_index": "string",
  "camera_type": "string",
  "focus_value": 0
}

`camera_frame_zoom`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: ir, wide, zoom
`payload.locked`	boolean	是	Whether aircraft head and gimbal relationship is locked
`payload.x`	number	是	Target coordinate x (0-1)
`payload.y`	number	是	Target coordinate y (0-1)
`payload.width`	number	是	Frame width (0-1)
`payload.height`	number	是	Frame height (0-1)

{
  "payload_index": "string",
  "camera_type": "string",
  "locked": true,
  "x": 0,
  "y": 0,
  "width": 0,
  "height": 0
}

`camera_look_at`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.locked`	boolean	是	Whether aircraft head and gimbal relationship is locked
`payload.latitude`	number	是	Target point latitude (-90 to 90 degrees)
`payload.longitude`	number	是	Target point longitude (-180 to 180 degrees)
`payload.height`	number	是	Target point height (meters, relative to takeoff point)

{
  "payload_index": "string",
  "locked": true,
  "latitude": 0,
  "longitude": 0,
  "height": 0
}

`camera_mode_switch`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_mode`	integer	是	Camera mode: 0=photo, 1=video

{
  "payload_index": "string",
  "camera_mode": 0
}

`camera_photo_stop`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value

{
  "payload_index": "string"
}

`camera_photo_take`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value

{
  "payload_index": "string"
}

`camera_point_focus_action`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.camera_type`	string	是	Camera type: wide, zoom (M30 series only supports zoom)
`payload.x`	number	是	Focus point coordinate x (0-1)
`payload.y`	number	是	Focus point coordinate y (0-1)

{
  "payload_index": "string",
  "camera_type": "string",
  "x": 0,
  "y": 0
}

`camera_recording_start`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value

{
  "payload_index": "string"
}

`camera_recording_stop`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value

{
  "payload_index": "string"
}

`camera_screen_drag`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.locked`	boolean	是	Whether aircraft head and gimbal relationship is locked
`payload.pitch_speed`	number	是	Gimbal pitch speed (rad/s)
`payload.yaw_speed`	number	是	Gimbal yaw speed (rad/s, only effective when not locked)

{
  "payload_index": "string",
  "locked": true,
  "pitch_speed": 0,
  "yaw_speed": 0
}

`camera_screen_split`

Field	Type	Required	说明
`payload.payload_index`	string	是	Camera enumeration value
`payload.enable`	boolean	是	Whether to enable split screen mode

{
  "payload_index": "string",
  "enable": true
}

`gimbal_reset`

Field	Type	Required	说明
`payload.payload_index`	string	是	Payload index (camera enumeration value)
`payload.reset_mode`	integer	是	Reset mode: 0=center, 1=down, 2=yaw center, 3=pitch down

{
  "payload_index": "string",
  "reset_mode": 0
}

drc

`drc_mode_enter`

Field	Type	Required	说明
`payload.mqtt_broker`	object	是	MQTT broker connection info
`payload.osd_frequency`	integer	是	OSD frequency (1-30 Hz)
`payload.hsi_frequency`	integer	是	HSI frequency (1-30 Hz)

{
  "mqtt_broker": {
    "address": "string",
    "client_id": "id-001",
    "username": "string",
    "password": "string",
    "expire_time": 0,
    "enable_tls": true
  },
  "osd_frequency": 0,
  "hsi_frequency": 0
}

`drc_mode_exit`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`drone_control`

Field	Type	Required	说明
`payload.seq`	integer	是	Command sequence number
`payload.x`	number	是	Forward/backward speed (-17 to 17 m/s)
`payload.y`	number	是	Left/right speed (-17 to 17 m/s)
`payload.h`	number	是	Up/down speed (-4 to 5 m/s)
`payload.w`	number	是	Angular velocity (-90 to 90 degrees/s)

{
  "seq": 0,
  "x": 0,
  "y": 0,
  "h": 0,
  "w": 0
}

`drone_emergency_stop`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`flight_authority_grab`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`fly_to_point`

Field	Type	Required	说明
`payload.fly_to_id`	string	是	Fly to point ID
`payload.max_speed`	integer	是	Maximum speed (0-15 m/s)
`payload.points`	array	是	Target points (supports only 1 point)

{
  "fly_to_id": "id-001",
  "max_speed": 0,
  "points": [
    {
      "latitude": 0,
      "longitude": 0,
      "height": 0
    }
  ]
}

`fly_to_point_stop`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`fly_to_point_update`

Field	Type	Required	说明
`payload.max_speed`	integer	是	Maximum speed (1-15 m/s)
`payload.points`	array	是	Updated target points (supports only 1 point)

{
  "max_speed": 0,
  "points": [
    {
      "latitude": 0,
      "longitude": 0,
      "height": 0
    }
  ]
}

`heart_beat`

Field	Type	Required	说明
`payload.seq`	integer	是	Command sequence number
`payload.timestamp`	integer	是	Heart beat timestamp (milliseconds)

{
  "seq": 0,
  "timestamp": 0
}

`payload_authority_grab`

Field	Type	Required	说明
`payload.payload_index`	string	是	Payload index (camera enumeration value)

{
  "payload_index": "string"
}

`stick_control`

Field	Type	Required	说明
`payload.roll`	integer	是	横滚通道 364-1684 1024为中值（无动作），数值增大表示向右倾斜，减小表示向左倾斜
`payload.pitch`	integer	是	俯仰通道 364-1684 1024为中值（无动作），数值增大表示向前俯冲，减小表示向后抬头。
`payload.throttle`	integer	是	升降通道 364-1684 1024为悬停状态，数值增大表示升高，减小表示降低。
`payload.yaw`	integer	是	偏航通道 364-1684 1024为中值（无动作），数值增大表示顺时针旋转，减小表示逆时针旋转。

{
  "roll": 0,
  "pitch": 0,
  "throttle": 0,
  "yaw": 0
}

`takeoff_to_point`

Field	Type	Required	说明
`payload.target_latitude`	number	是	Target point latitude (-90 to 90)
`payload.target_longitude`	number	是	Target point longitude (-180 to 180)
`payload.target_height`	number	是	Target point height (ellipsoidal height, WGS84)
`payload.security_takeoff_height`	number	是	Safe takeoff height (relative to dock ALT)
`payload.rth_mode`	integer	是	【必填】返航模式设置值”0”:“智能高度”,“1”:“设定高度”
`payload.rth_altitude`	integer	是	Return home altitude (relative to dock ALT)
`payload.rc_lost_action`	integer	是	RC lost action (0=hover, 1=land, 2=RTH)
`payload.exit_wayline_when_rc_lost`	integer	是	[Deprecated] Wayline lost action (0=continue, 1=exit)
`payload.commander_mode_lost_action`	integer	是	【必填】Commander mode lost action (0=continue, 1=exit)
`payload.commander_flight_mode`	integer	是	【必填】指点飞行模式设置值 “0”:“智能高度飞行”,“1”:“设定高度飞行”
`payload.commander_flight_height`	number	是	【必填】Commander flight height (relative to dock ALT)
`payload.flight_id`	string	是	One-key takeoff mission UUID
`payload.max_speed`	integer	否	Max speed (1-15 m/s, optional)
`payload.flight_safety_advance_check`	integer	是	飞行安全预检查 “0”:“关闭”,“1”:“开启”

{
  "target_latitude": 0,
  "target_longitude": 0,
  "target_height": 0,
  "security_takeoff_height": 0,
  "rth_mode": 0,
  "rth_altitude": 0,
  "rc_lost_action": 0,
  "exit_wayline_when_rc_lost": 0,
  "commander_mode_lost_action": 0,
  "commander_flight_mode": 0,
  "commander_flight_height": 0,
  "flight_id": "id-001",
  "flight_safety_advance_check": 0,
  "max_speed": 0
}

wayline

`flight_setup_abort`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`flighttask_create`

Field	Type	Required	说明
`payload.flighttask_id`	string	是	method payload 字段
`payload.execute_time`	integer	否	Optional execution time (timestamp)
`payload.task_type`	string	是	Task type: immediate, timed, conditional
`payload.wayline_type`	string	是	Wayline type: wayline, mapping_2d, mapping_3d, mapping_strip
`payload.wayline_file`	string	否	Wayline file URL
`payload.execute_times`	integer	否	Number of execution times
`payload.out_of_control_action`	string	是	Action when out of control: continue, execute_go_home, hover
`payload.rth_altitude`	number	否	Return to home altitude
`payload.task_name`	string	否	Task name
`payload.ready_conditions`	object	否	Ready conditions (for conditional tasks)
`payload.executable_conditions`	object	否	Executable conditions
`payload.simulate_mission`	object	否	Simulation settings
`payload.break_point`	object	否	Breakpoint information for resume
`payload.rth_mode`	integer	否	Return to home mode (0=smart, 1=preset)
`payload.exit_wayline_when_rc_lost`	integer	否	Exit wayline when RC lost (0=continue, 1=exit)
`payload.wayline_precision_type`	integer	否	Wayline precision type (0=GPS, 1=RTK)
`payload.flight_safety_advance_check`	boolean	否	Flight safety advance check

{
  "flighttask_id": "id-001",
  "task_type": "string",
  "wayline_type": "string",
  "out_of_control_action": "string",
  "execute_time": 0,
  "wayline_file": "string",
  "execute_times": 0,
  "rth_altitude": 0,
  "task_name": "string",
  "ready_conditions": {
    "battery_capacity": 0,
    "begin_time": 0,
    "end_time": 0
  },
  "executable_conditions": {
    "storage_capacity": 0
  },
  "simulate_mission": {
    "is_enable": 0,
    "latitude": 0,
    "longitude": 0
  },
  "break_point": {
    "index": 0,
    "state": 0,
    "progress": 0,
    "wayline_id": 0,
    "break_reason": 0,
    "latitude": 0,
    "longitude": 0,
    "height": 0,
    "attitude_head": 0
  },
  "rth_mode": 0,
  "exit_wayline_when_rc_lost": 0,
  "wayline_precision_type": 0,
  "flight_safety_advance_check": true
}

`flighttask_execute`

Field	Type	Required	说明
`payload.flight_id`	string	是	Flight task ID
`payload.multi_dock_task`	object	否	Multi-dock task parameters (optional, for leapfrog missions)

{
  "flight_id": "id-001",
  "multi_dock_task": {
    "wireless_link_topo": {
      "secret_code": [
        0
      ],
      "center_node": {
        "sdr_id": 0,
        "sn": "string"
      },
      "leaf_nodes": [
        {
          "sdr_id": 0,
          "sn": "string",
          "control_source_index": 0
        }
      ]
    },
    "dock_infos": [
      {
        "dock_type": "string",
        "latitude": 0,
        "longitude": 0,
        "height": 0,
        "heading": 0,
        "home_position_is_valid": 0,
        "index": 0,
        "sn": "string",
        "rtcm_info": {
          "mount_point": "string",
          "port": "string",
          "host": "string",
          "rtcm_device_type": 0,
          "source_type": 0
        },
        "alternate_land_point": {
          "longitude": 0,
          "latitude": 0,
          "height": 0,
          "safe_land_height": 0,
          "is_configured": 0
        }
      }
    ]
  }
}

`flighttask_pause`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`flighttask_prepare`

Field	Type	Required	说明
`payload.break_point`	object	否	method payload 字段
`payload.executable_conditions`	object	否	method payload 字段
`payload.execute_time`	integer	是	method payload 字段
`payload.exit_wayline_when_rc_lost`	integer	是	method payload 字段
`payload.file`	object	是	method payload 字段
`payload.flight_id`	string	是	method payload 字段
`payload.out_of_control_action`	integer	是	method payload 字段
`payload.ready_conditions`	object	否	method payload 字段
`payload.rth_altitude`	integer	是	method payload 字段
`payload.simulate_mission`	object	否	method payload 字段
`payload.task_type`	integer	是	method payload 字段
`payload.rth_mode`	integer	是	method payload 字段

{
  "execute_time": 0,
  "exit_wayline_when_rc_lost": 0,
  "file": {
    "fingerprint": "string",
    "url": "https://example.com/path"
  },
  "flight_id": "id-001",
  "out_of_control_action": 0,
  "rth_altitude": 0,
  "task_type": 0,
  "rth_mode": 0,
  "break_point": {
    "index": 0,
    "state": 0,
    "progress": 0,
    "wayline_id": 0,
    "break_reason": 0,
    "latitude": 0,
    "longitude": 0,
    "height": 0,
    "attitude_head": 0
  },
  "executable_conditions": {
    "storage_capacity": 0
  },
  "ready_conditions": {
    "battery_capacity": 0,
    "begin_time": 0,
    "end_time": 0
  },
  "simulate_mission": {
    "is_enable": 0,
    "latitude": 0,
    "longitude": 0
  }
}

`flighttask_recovery`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`flighttask_undo`

Field	Type	Required	说明
`payload.flight_ids`	array	是	Flight task ID

{
  "flight_ids": [
    "string"
  ]
}

`return_home`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`return_home_cancel`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

live

`live_lens_change`

Field	Type	Required	说明
`payload.video_type`	string	是	Video type: ir=infrared, normal=default, wide=wide angle, zoom=zoom

{
  "video_type": "string"
}

`live_set_quality`

Field	Type	Required	说明
`payload.video_id`	string	是	Video stream ID (format: //)
`payload.video_quality`	integer	是	Video quality: 0=adaptive, 1=smooth, 2=standard, 3=high, 4=super

{
  "video_id": "id-001",
  "video_quality": 0
}

`live_start_push`

Field	Type	Required	说明
`payload.url_type`	integer	是	URL type: 0=Agora, 1=RTMP, 3=GB28181, 4=WebRTC
`payload.url`	string	是	Live stream URL/parameters
`payload.video_id`	string	是	Video stream ID (format: //)
`payload.video_quality`	integer	是	Video quality: 0=adaptive, 1=smooth, 2=standard, 3=high, 4=super

{
  "url_type": 0,
  "url": "https://example.com/path",
  "video_id": "id-001",
  "video_quality": 0
}

`live_stop_push`

Field	Type	Required	说明
`payload.video_id`	string	是	Video stream ID

{
  "video_id": "id-001"
}

psdk

`custom_data_transmission_to_esdk`

Field	Type	Required	说明
`payload.data`	object	是	Custom data

{
  "data": {}
}

`custom_data_transmission_to_psdk`

Field	Type	Required	说明
`payload.payload_index`	string	是	Payload index
`payload.data`	object	是	Custom data

{
  "payload_index": "string",
  "data": {}
}

`psdk_input_box_text_set`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (0-3)
`payload.value`	string	是	Text content (max 128 bytes)

{
  "psdk_index": 0,
  "value": "string"
}

`psdk_widget_value_set`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (0-3)
`payload.index`	integer	是	Widget index
`payload.value`	integer	是	Widget value (defined by developer)

{
  "psdk_index": 0,
  "index": 0,
  "value": 0
}

`speaker_audio_play_start`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (min: 0)
`payload.file`	object	是	Audio file information

{
  "psdk_index": 0,
  "file": {
    "name": "string",
    "url": "https://example.com/path",
    "md5": "string",
    "format": "string"
  }
}

`speaker_play_mode_set`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (0-3)
`payload.play_mode`	integer	是	Play mode: 0=single play, 1=loop (single track)

{
  "psdk_index": 0,
  "play_mode": 0
}

`speaker_play_stop`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (min: 0)

{
  "psdk_index": 0
}

`speaker_play_volume_set`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (0-3)
`payload.index`	integer	是	method payload 字段
`payload.play_volume`	integer	是	Speaker volume (0-100)

{
  "psdk_index": 0,
  "index": 0,
  "play_volume": 0
}

`speaker_replay`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (min: 0)

{
  "psdk_index": 0
}

`speaker_tts_play_start`

Field	Type	Required	说明
`payload.psdk_index`	integer	是	PSDK payload device index (min: 0)
`payload.tts`	object	是	TTS text information

{
  "psdk_index": 0,
  "tts": {
    "name": "string",
    "text": "string",
    "md5": "string"
  }
}

file

`fileupload_list`

Field	Type	Required	说明
`payload.module_list`	array	是	文件所属过滤列表: “0”=飞行器, “3”=机场

{
  "module_list": [
    "string"
  ]
}

`fileupload_start`

Field	Type	Required	说明
`payload.bucket`	string	是	对象存储桶名称
`payload.region`	string	是	数据中心所在的地域
`payload.credentials`	object	是	凭证信息
`payload.endpoint`	string	是	对外服务的访问域名
`payload.provider`	string	是	云厂商枚举值: “ali”=阿里云, “aws”=亚马逊云, “minio”=minio
`payload.params`	object	是	method payload 字段

{
  "bucket": "string",
  "region": "string",
  "credentials": {
    "access_key_id": "id-001",
    "access_key_secret": "string",
    "expire": 0,
    "security_token": "string"
  },
  "endpoint": "string",
  "provider": "string",
  "params": {
    "files": [
      {
        "list": {},
        "module": "string",
        "object_key": "string"
      }
    ]
  }
}

`fileupload_update`

Field	Type	Required	说明
`payload.status`	string	是	上传状态: “cancel”=取消
`payload.module_list`	array	是	日志所属模块列表: “0”=飞行器, “3”=机场

{
  "status": "string",
  "module_list": [
    "string"
  ]
}

`upload_flighttask_media_prioritize`

Field	Type	Required	说明
`payload.flight_id`	string	是	Flight task ID

{
  "flight_id": "id-001"
}

safety

`flight_areas_get`

Field	Type	Required	说明
`payload.area_type`	string	否	Area type filter (optional)

{
  "area_type": "string"
}

`flight_areas_update`

Field	Type	Required	说明
`payload`	object	是	空对象 `{}`

{}

`unlock_license_list`

Field	Type	Required	说明
`payload.device_model_domain`	integer	是	License location (0=aircraft, 3=dock)

{
  "device_model_domain": 0
}

`unlock_license_switch`

Field	Type	Required	说明
`payload.license_id`	integer	是	License ID (unique identifier)
`payload.enable`	boolean	是	Enable/disable unlock license

{
  "license_id": 0,
  "enable": true
}

`unlock_license_update`

Field	Type	Required	说明
`payload.file`	object	否	Offline license file (optional, use Flysafe server if omitted)

{
  "file": {
    "url": "https://example.com/path",
    "fingerprint": "string"
  }
}

firmware

`ota_create`

Field	Type	Required	说明
`payload.devices`	array	是	Array of devices to upgrade (max 2 devices)

{
  "devices": [
    {
      "sn": "string",
      "product_version": "string",
      "file_url": "https://example.com/path",
      "md5": "string",
      "file_size": 0,
      "file_name": "string",
      "firmware_upgrade_type": 0
    }
  ]
}

​命令 Payload

​代码演示

​DJI Payload 全量目录

命令 Payload

代码演示

DJI Payload 全量目录