You need to enable JavaScript to run this app.
导航
慢直播
  • 文档首页
    • /
  • 慢直播

查看视频流

最近更新时间：2023.06.27 11:40:49

首次发布时间：2021.11.25 17:21:46

我的收藏

查询指定视频流的详细信息。

请求方式

使用 GET 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。

字段
位置
类型
必填
说明
值
ActionQueryString是公共参数，OpenAPI 接口名称GetStream
VersionQueryString是公共参数，OpenAPI 接口版本2021-01-01
StreamIDQueryString否筛选条件，视频流 ID可通过调用 ListStreams 接口获取
StreamNameQueryString否筛选条件，视频流名称
FreshExpiredPullQueryString否是否刷新过期的拉流地址如果设置为1，会判断拉流地址是否过期（拉流域名开启防盗链）；如果过期，会刷新拉流地址

返回结果

返回参数说明

通用返回参数，请参考 ResponseMetadata 结构体说明。

Result 字段包含以下参数：

参考 ListStreams 接口的返回参数列表。

示例

请求示例

GET https://open.volcengineapi.com?Action=GetStream
&Version=2021-01-01
&StreamID=4b9ee060-9fed-4c0e-aaa4-283b17xxxxxx
&FreshExpiredPull=1
&<公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022020809562401020404907915037F68",
        "Action": "GetStream",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "SpaceID": "517ff7ec-7700-4862-b1e7-7967xxxxxxxx",
        "SpaceID": "517ff7ec-7700-4862-b1e7-7967a4xxxxxx",
        "SIPID": "34020000002000xxxxxx",
        "StreamName": "34020033991320xxxxxx_34020033991320384963",
        "StreamID": "4b9ee060-9fed-4c0e-aaa4-283b17xxxxxx",
        "SpaceAccessType": "gb28181",
        "DeviceID": "0a32c128-c89c-4f39-aa60-66e5f1xxxxxx",
        "DeviceNSID": "34020033991320xxxxxx",
        "ChannelID": "34020033991320xxxxxx",
        "Status": "online",
        "StreamingType": "main_stream",
        "Description": "channel: 34020033991320xxxxxx@device: 34020033991320xxxxxx",
        "Screenshot": {
            "TemplateName": "",
            "TemplateID": ""
        },
        "Record": {
            "TemplateName": "online-record-1022",
            "TemplateID": "1f5704dc-8d31-4547-9534-1ac40bxxxxxx"
            },
        "AI": {
            "TemplateName": "car0121",
            "TemplateID": "1c443146-8d6a-44d5-baf8-5efafcxxxxxx"
        },
        "CreatedAt": "2023-06-13T16:20:28+08:00",
        "UpdatedAt": "2023-06-13T16:22:28+08:00",
        "PushUrlDDL": 1687383521,
        "RTMPushUrl": "https://xxx-push.xx/xxx.sdp?Time=123&Secret=xxx",
        "PullUrls": [
            "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
            "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
            "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8"
        ],
        "TransPullUrls": {
            "flv": [
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv"
            ],
            "hls": [
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8"
            ],
            "rtmp": [
                "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx"
            ],
            "webrtc": [
                "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp"
            ]
        },
        "FailedTimes": 0,
        "RecentPushTs": "2021-11-30T17:07:35+08:00",
        "RtpTransportTcp": true,
        "Resolution": "6",
        "Logs": [
            {
                "LogTime": 1638603119124,
                "LogLevel": 2,
                "Message": "invite message send failed"
            }
        ]
    }
}