开启直播

POST

https://es-flight-api-cn.djigate.com/openapi/v0.1/live-stream/start

启用设备直播功能后，设备将自动向媒体服务器推流，并返回对应直播供应商的鉴权信息。需集成供应商的SDK（如火山引擎、声网、SRS等），通过鉴权信息调用其接口拉取直播流。

注意：司空2 会动态选择直播供应商，互为备份使用，若依赖使用该 API 需要将多个供应商的 SDK 集成后使用，若不实现可能会遇到不支持的情况。

提示信息：

camera_index 信息可通过获取组织下的设备列表接口下的 data.list.drone.camera_list 中获取。

没有拉流观众5分钟后，将停止直播推流。

请求参数

Authorization

在 header 添加参数

X-User-Token

示例：

X-User-Token: ********************

Header 参数

Body 参数application/json

示例

{
    "sn": "7CTDM3D00BZNVZ",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "quality_type": "adaptive"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://es-flight-api-cn.djigate.com/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,
    "quality_type": "adaptive"
}'

返回响应

🟢200成功

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-09-03 12:30:07

直播管理教程

码流转发错误码