You need to enable JavaScript to run this app.
导航
启用视频流
最近更新时间:2024.02.29 14:55:33首次发布时间:2023.06.27 11:40:50

启用指定视频流(适用于接入类型为 GB 的空间内的视频流)。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com?Action=StartStream&Version=2021-01-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
ActionStringStartStream接口名称。当前 API 的名称为 StartStream
VersionString2021-01-01接口版本。当前 API 的版本为 2021-01-01
StreamIDString524c804d-0149-4b58-8209-2f17f6xxxxxx视频流 ID,可通过调用 ListStreams 接口获。

IgnoreAudio

String

1

是否忽略音频,取值及含义如下所示。

  • 1:忽略;
  • 0:不忽略(默认值)。

FreshExpiredPull

String

1

是否检查并刷新过期的 URL,需要先开启域名防盗链,取值及含义如下所示。

  • 1:刷新(默认值);
  • 0:不刷新。

EnableAudioTranscode

String

0

是否开启音频转码,开启后会将音频编码由 G.711 转为 AAC,取值及含义如下所示。

  • 1:转码;
  • 0:不转码(默认值)。

Body

参数类型是否必选示例值描述

StreamingIndex

Integer

0

主子码流编号,取值及含义如下所示。

  • 0:主码流;
  • 1~n:子码流。

说明

  • 如果 StreamType 和 Resolution 都不指定,则默认拉取主码流;
  • StreamType 和 Resolution 参数不能同时指定。

Resolution

String

3

分辨率编码(可参考 GB28181-2022 协议附录G中的定义),取值及含义如下所示。

  • 1(QCIF - 176x144)
  • 2(CIF - 320x288)
  • 3(4CIF - 704x576)
  • 4(D1 - 720x576)
  • 5(720p)
  • 6(1080p/i)
  • 其他(自定义宽高,如19201080等,需设备支持)

说明

  • 如果 StreamType 和 Resolution 都不指定,则默认拉取主码流;
  • StreamType 和 Resolution 参数不能同时指定。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数类型示例值描述
IDString4b9ee060-9fed-4c0e-aaa4-283b17xxxxxx启用成功的视频流 ID。
PullUrlsArray of String["rtmp://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001","http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.flv","http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.m3u8","http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.sdp"]拉流地址。

请求示例

POST https://open.volcengineapi.com?Action=StartStream&Version=2021-01-01&StreamID=

{
    "StreamingIndex": 0,
    "Resolution": "4"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202112081609140102120720962400088F",
        "Action": "StartStream",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "ID": "4b9ee060-9fed-4c0e-aaa4-283b17xxxxxx",
        "PullUrls": [
            "rtmp://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001",
            "http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.flv",
            "http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.m3u8",
            "http://xxxx.fcdn-xxx-pull.org/xxxx/xxx000001.sdp"
        ]
    }
}

错误码

您可访问公共错误码,获取更多错误码信息。