Direct Remote Control
Event
Payload Control—Single Shot
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_photo_take
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Camera enumeration | text | Camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"payload_index": "68-0-0"
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_photo_take"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: camera_photo_take
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_photo_take"
}
Payload Control—Start Recording
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_recording_start
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Camera enumeration | text | Camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"payload_index": "68-0-0"
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_recording_start"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: camera_recording_start
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_recording_start"
}
Payload Control—Stop Recording
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_recording_stop
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Camera enumeration | text | Camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"payload_index": "68-0-0"
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_recording_stop"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: camera_recording_stop
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_recording_stop"
}
Payload Control—Screen Drag Control
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_screen_drag
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Camera enumeration | text | Camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] | |
| locked | Whether the relative relationship between nose and gimbal is locked | bool | {"false":"Only gimbal rotates, body does not rotate","true":"Lock nose, gimbal and body rotate together"} | |
| pitch_speed | Gimbal pitch speed | double | {"unit_name":"Degrees per second / deg/s"} | Gimbal pitch speed, only supports gimbal rotation |
| yaw_speed | Gimbal yaw speed | double | {"unit_name":"Degrees per second / deg/s"} | Gimbal yaw speed, only supports locked nose |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"locked": false,
"payload_index": "68-0-0",
"pitch_speed": 0.1,
"yaw_speed": 0.1
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_screen_drag"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: camera_screen_drag
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_screen_drag"
}
Payload Control—Zoom
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_focal_length_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Camera enumeration | text | Camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] | |
| camera_type | Camera type | enum_string | {"ir":"Infrared","wide":"Wide angle","zoom":"Zoom"} | Camera type enumeration |
| zoom_factor | Zoom factor | double | {"max":200,"min":2} | Zoom factor, visible light is 2-200, infrared is 2-20 |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"camera_type": "zoom",
"payload_index": "68-0-0",
"zoom_factor": 5
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_focal_length_set"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: camera_focal_length_set
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_focal_length_set"
}
Payload Control—Reset Gimbal
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: gimbal_reset
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| payload_index | Payload number | text | Payload number, camera enumeration value. Non-standard device_mode_key, format is {type-subtype-gimbalindex}, can refer to [Product Support] | |
| reset_mode | Reset mode type | enum_int | {"0":"Return to center","1":"Downward","2":"Yaw return to center","3":"Downward 45 degrees"} |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"payload_index": "68-0-0",
"reset_mode": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "gimbal_reset"
}
Topic: thing/product/{gateway_sn}/services_reply
Direction: up
Method: gimbal_reset
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| result | Return code | int | Non-0 represents error |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"result": 0
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "gimbal_reset"
}
Payload Control—Look At
Topic: thing/product/{gateway_sn}/services
Direction: down
Method: camera_look_at
Data:
| Column | Name | Type | constraint | Description |
|---|---|---|---|---|
| latitude | Target point latitude | double | {"max":90,"min":-90} | Angle value. South latitude is negative, north latitude is positive, precision to 6 decimal places. |
| longitude | Target point longitude | double | {"max":180,"min":-180} | Angle value. East longitude is positive, west longitude is negative, precision to 6 decimal places. |
| height | Target point height | float | {"max":10000,"min":2,"step":0.1,"unit_name":"Meters / m"} | Target point height (ellipsoidal height) |
Example:
{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"data": {
"height": 100,
"latitude": 12.23,
"longitude": 12.23
},
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
"timestamp": 1654070968655,
"method": "camera_look_at"
}