全新司空 2 OpenAPI V1.0(openapi-translation)
  1. Push Livestream
全新司空 2 OpenAPI V1.0(openapi-translation)
  • Root Directory
    • Authentication and Authorization
      • Authentication Authorization Tutorial
    • System Services
      • FlightHub 2 Public Cloud Access Point Information
      • Query FlightHub 2 System Status
    • Organization Projects
      • Organization Project Tutorial
      • Get the List of Projects Under the Organization
      • Get the List of Devices Under the Organization
      • Get the List of Devices Under the Project
      • Obtain the storage upload credentials for the project
      • Add Members to the Project
    • Livestream Management
      • Live streaming management tutorial
      • Push Livestream
        • Enable Livestream
          POST
      • Stream forwarding (only supports private cloud)
        • Stream Forwarding Error Code
        • Create Stream Forwarder
        • Enable/Disable Stream Forwarder
    • Annotation Management
      • Annotation management tutorial
      • Create Map Annotations
    • Task Management
      • Task management tutorial
      • Create Flight Tasks
      • Update Flight Task Status
      • Get the Flight Task List
      • Get Media Files Generated by the Flight Task
      • Get Flight Trajectory Information
    • Device Management
      • Device management tutorial
      • Get Device Properties
      • Get HMS Information
      • Switch Dock Cameras
      • Switch Aircraft Cameras
      • Custom Network RTK Calibration
      • Specify device to enter relay frequency pairing mode (only supports private cloud and relay)
      • Query relay frequency pairing result (only supports private cloud and relay)
    • Route Management
      • Route management tutorial
      • Flight Route Upload Completion Notification
      • Get the List of Flight Routes Under the Project
      • Get Flight Route Details
    • Model Management
      • Model management tutorial
      • Model reconstruction coordinate system
      • Get the List of Models Under the Project
      • Mapping
      • Get the Model Details
      • Get Model File Download URL
    • Open modeling
      • Open modeling tutorial
      • Model Reconstruction Error Code
      • Algorithm parameter introduction
      • Get upload credential
      • Upload callback
      • Get resource details
      • Delete resource
      • Start reconstruction task
      • Stop reconstruction task
      • Get the Model Details
      • Delete Models
  • Get the Stream Transcoder List
    GET
  • Send Real-Time Control Command
    POST
  • Delete Stream Forwarder
    DELETE
  • Acquire Control
    POST
  • Release Control
    DELETE
  • Video Transmission Quality Settings
    PUT
  • Get the Flight Task Information
    GET
  1. Push Livestream

Enable Livestream

开发中
POST
/openapi/v0.1/live-stream/start
Enable live streaming, stream the aircraft stream to users in real-time.
camera_index information can be obtained from data.list.drone.camera_list in the device list interface under the organization.
If there are no viewers after 5 minutes, stream pushing will stop.

请求参数

Authorization
在 header 添加参数
X-User-Token
示例：
X-User-Token: ********************
Header 参数

Body 参数application/json

示例
{
    "sn": "7CTDM3D00BZNVZ",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "video_quality": "adaptive"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/v0.1/live-stream/start' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'X-User-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sn": "7CTDM3D00BZNVZ",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "video_quality": "adaptive"
}'

返回响应

🟢200Success
application/json
Body

示例
{
    "code": 0,
    "message": "",
    "data": {
        "expire_ts": 1764751629,
        "url": "http://47.96.144.147:30806/rtc/v1/whep/?app=live&stream=7CTDM3D00BZNVZ_165-0-7&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwcm9kdWN0X2lkIjoiNzEzNTE5ZmIxYjRlNDRiYTlkMjdkMDJhOGRlZDk5NGQiLCJjaGFubmVsX25hbWUiOiI3Q1RETTNEMDBCWk5WWl8xNjUtMC03IiwidWlkIjoxMDAxMTQsImFjdGlvbiI6InBsYiLCJleHAiOjE3NjQ3NTE2MzAsIm5iZiI6MTczMzIxNTYzMCwiaWF0IjoxNzMzMjE1NjMwfQ._AysitutpprlgYGFy4lDL_gSv4Y3hl_te-yxoFVHZb4",
        "url_type": "srs"
    }
}
修改于 2025-04-29 08:42:42
上一页
Live streaming management tutorial
下一页
Stream Forwarding Error Code
Built with