开启直播 - 全新司空 2 OpenAPI V1.0

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

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

提示信息：

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

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

请求参数

Authorization

在 header 添加参数

X-User-Token

示例：

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

Header 参数

X-Request-Id

string <uuid>

请求唯一标识

可选

默认值:

X-Language

enum<string>

可选

枚举值:

zhen

默认值:

X-Project-Uuid

string

项目编号

可选

默认值:

X-User-Token

string

必需

X-User-Token

默认值:

Body 参数application/json

string

必需

camera_index

string

必需

video_expire

integer

必需

直播推流Token有效期，超过这个有限期直播将中止。

quality_type

enum<string>

直播清晰度

必需

枚举值:

adaptivesmoothultra_high_definition

示例

{
    "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

返回响应

🟢200成功

application/json

Body

code

integer

非0表示异常

必需

message

string

消息提示

必需

data

object

必需

expire_ts

integer

必需

直播推流Token有效期

url

string

直播拉流播放地址

必需

url_type

string

直播推流类型

必需

示例

{
    "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"
    }
}