开启直播

开发中

POST

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

开启直播，将飞行器的码流实时直播給用户。

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

curl --location --request POST 'https://es-flight-api-cn.djigate.com/openapi/v0.1/live-stream/start' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'Content-Type: application/json' \
--header 'X-User-Token;' \
--data-raw '{
    "sn": "7CTDM3D00BZNVZ",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "video_quality": "adaptive"
}'

返回响应

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

直播管理教程

码流转发错误码