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

参数类型是否必选示例值描述
ActionString是StartStream接口名称。当前 API 的名称为 StartStream。
VersionString是2021-01-01接口版本。当前 API 的版本为 2021-01-01。
StreamIDString否524c804d-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"
        ]
    }
}

错误码

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