视频监控

    • 视频监控 > API 文档 > 流管理相关接口 >获取流地址 > 动态模式

    动态模式

    最近更新时间: 2025-09-18 17:33:22

    描述

    本接口根据推流端和播放端的公网IP，计算最合适的推流和播放地址。

    • 接口请求域名：qvs.qiniuapi.com
    • 请求方式：POST
    • 接口路径：/v1/namespaces/{namespaceId}/streams/{streamId}/urls
    • 当空间类型为GBT28181时，设备类型为摄像头时，流ID就是设备国标ID；设备类型为平台时，流ID就是设备国标ID_通道ID的形式
    • 对于本地录像回放，如果希望播放任意时间段内的录像，需要手动拼接流ID。当设备类型为摄像头时，流ID格式为设备国标ID_history_开始时间戳_结束时间戳；当设备类型为平台时，流ID格式为设备国标ID_通道ID_history_开始时间戳_结束时间戳；假设目前有一个NVR国标ID为31011500991320020874，通道ID为34020000001310000001，希望观看2022-12-12 00:00:00到2022-12-12 23:59:59时间段内的录像，则流ID为:31011500991320020874_34020000001310000001_history_1671638400_1671724799，通过请求此接口可以获取到回放的流地址。注意这里的时间戳指的是unix时间戳，单位秒。

    请求参数

    路径参数

    参数名称 必填 字段类型 说明
    namespaceId 是 string 空间ID
    streamId 是 string 流id规则

    Body

    参数名称 必填 字段类型 说明
    publishIp 是 string 推流端公网IP地址。注：gb28181类型的空间可以不传。
    playIp 否 string 播放端公网IP。注：在无法获取播放端公网ip时，可以填充为127.0.0.1
    urlExpireSec 否 integer 流地址过期时间(单位为秒)
    playExpireSec 否 integer 播放过期时间(单位为秒)

    备注:

    1. 只传 publishIp,只返回推流地址。注：gb28181类型的空间，推流地址为空
    2. 只传 playIp, 只返回播放地址。注：在无法感知到播放端的对外ip时，可以填充为127.0.0.1
    3. 两个都传, 同时返回推拉流地址。注：gb28181类型的空间，推流地址为空。
    4. 若域名配置中设置了防盗链过期时间，优先以域名配置为主

    响应参数

    参数名称 类型 说明
    publishUrl string rtmp推流地址
    playUrls.rtmp string rtmp播放地址
    playUrls.flv string flv播放地址
    playUrls.hls string hls播放地址
    playUrls.webrtc string webrtc播放地址
    publishUrlExpired integer 流地址过期时间点(unix时间戳，单位second)
    onlineState bool 流的在线状态
    disabled bool 流是否被禁用

    示例

    请求示例

    curl --request POST \
  --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/urls \
  --header 'authorization: QiniuStub j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
  --header 'content-type: application/json' \
  --data '{
	"publishIp":"116.236.177.50",
	"playIp":"116.236.177.50"
}'

    响应示例

    {
  "publishUrl": "rtmp://47.105.118.51:2045/2akrars3vld9y/device009?e=1586922179&token=test123%3Al8rY2rRRKT182Hc7pymLMWX7how",
  "playUrls": {
    "rtmp": "rtmp://47.105.118.51:2045/2akrars3vld9y/device009?e=1586922179&token=test123%3Al8rY2rRRKT182Hc7pymLMWX7how",
    "flv": "http://47.105.118.51:1360/2akrars3vld9y/device009.flv?e=1586922179&token=test123%3A4JyGGXWy4OKOuXF2LYfs3inxt0k",
    "hls": "http://47.105.118.51:1370/2akrars3vld9y/device009.m3u8?e=1586922179&token=test123%3Ak6TOQ8vvsYnOTdjBcjnO6_m5uB0",
    "webrtc": "webtrtc://47.105.118.51:1240/2akrars3vld9y/device009"
  },
  "publishUrlExpired": 1586922179
}
    以上内容是否对您有帮助？