开始旁路推流转发 - 大疆运载云端互联

请求参数

Path 参数

group_id

string

设备的团队ID

必需

Body 参数application/json

region

string

可选

区域,cn-中国大陆,na-北美,eu-欧洲,ap-亚洲其余区域

示例值:

cn

rtmp_url

string

推流目标地址

可选

示例值:

rtmp://xxx-example.com:1935/xxChanelStream

sn

string

设备SN

可选

示例值:

1581FXXXXXXXXXXXTEST

camera

string

飞机的负载相机

可选

示例值:

39-0-7

video

string

相机的镜头

可选

示例值:

normal-0

expire_ts

integer

可选

直播有效时长，最大两小时

示例值:

7200

video_quality

integer

可选

直播清晰度，自动-0、流畅-1、标清-2、高清-3、超清-4

示例值:

0

示例

{
    "region": "cn",
    "rtmp_url": "rtmp://xxx-example.com:1935/xxChanelStream",
    "sn": "1581FXXXXXXXXXXXTEST",
    "camera": "39-0-7",
    "video": "normal-0",
    "expire_ts": 7200,
    "video_quality": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/manage/sdk/v1/groups/{{group_id}}/bypass/streams/start' \
--header 'Content-Type: application/json' \
--data-raw '{
    "region": "cn",
    "rtmp_url": "rtmp://xxx-example.com:1935/xxChanelStream",
    "sn": "1581FXXXXXXXXXXXTEST",
    "camera": "39-0-7",
    "video": "normal-0",
    "expire_ts": 7200,
    "video_quality": 0
}'

返回响应

🟢200成功

application/json

OK

Body

code

integer <int64>

必需

message

string <string>

必需

示例值:

data

object

可选

converter_id

string

可选

旁路推流的任务唯一ID

示例值:

2A3AD3DEB844D55B8B8933B2804B9C0F

play_rtmp_url

string

可选

rtmp拉流地址,旁路推流会在推流地址后末尾拼凑一部分成为拉流地址

示例值:

rtmp://xxx-example.com:1935/xxChanelStream/1581FXXXXXXXXXXXTEST_39-0-7

create_ts

number

可选

旁路推流的任务状态创建时间戳

示例值:

1717408389

update_ts

number

可选

旁路推流的任务状态更新时间戳

示例值:

1717408389

converter_state

string

可选

旁路推流的任务状态,成功后该值为running

示例值:

running

示例

{
    "code": 0,
    "message": "",
    "data": {
        "converter_id": "2A3AD3DEB844D55B8B8933B2804B9C0F",
        "play_rtmp_url": "rtmp://xxx-example.com:1935/xxChanelStream/1581FXXXXXXXXXXXTEST_39-0-7",
        "create_ts": 1717408389,
        "update_ts": 1717408389,
        "converter_state": "running"
    }
}