开启直播

POST

/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,
    "video_quality": "adaptive"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://192.168.10.11:7012/api//openapi/v0.1/live-stream/start' \
--header 'gis-access-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NzIwNzI1ODEsInVzZXJuYW1lIjoic3lhZG1pbiJ9._MztFZUO72f_nClLz-Yf-qcDFHOm-G_o1ZkJZplzSQU' \
--header 'x-tenant-id: 1011' \
--header 'x-access-token: {{$string.uuid}}' \
--header 'X-User-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "sn": "7CTDM3D00BZNVZ",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "video_quality": "adaptive"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "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-08-17 01:47:01

直播管理教程

码流转发错误码