跳到主要内容

获取融云 CDN 拉流地址

在使用融云 CDN 服务时，支持通过该 API 获取对应房间的 CDN 拉流地址。适用于通过融云 CDN 播放器或第三方播放器直播播放拉流地址的场景。

  • 支持获取 RTMP、FLV、HLS 协议的拉流地址。
  • 支持设定视频宽高及帧率。该功能会触发 CDN 转码，详见价格说明中的音视频服务价格详情。
  • 支持返回包含防盗链的完整拉流地址（需在控制台开启防盗链功能）。

注意事项​

  • 请确保已开通融云 CDN 服务。仅在推拉流模式设置为开播自动推流和开播手动推流时可获取 CDN 拉流地址。详见融云 CDN 服务配置。
  • 如果需要使用 HLS 拉流地址且开启了防盗链功能，推荐将防盗链的有效时长配置大于一天，以保证观众在房间内可长时间稳定观看直播。
  • 2022年6月前开通融云 CDN 服务的客户，如获取到的 HLS 拉流地址无法正常播放，请提交工单咨询。

请求方法​

POST: https://api.rong-api.com/v2/rtc/innercdn/pull_url

签名规则： 所有请求融云服务端 API 接口的请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文中包含具有以下结构的 JSON 对象：

参数类型必填说明
widthInt否指定视频宽度，必须参照宽高限制列表进行配置。
heightInt否指定视频高度，必须参照宽高限制列表进行配置。
fpsInt否帧率。接受 10/15/24/30，默认为源流帧率。
kindString否拉流协议。支持 flv/rtmp/hls，默认为 rtmp。
isHttpsInt否是否开启 https，1：是；0：否。默认为 0。

  • 宽高限制列表

    [
        "176*144", "180*180", "256*144", "240*180", "320*180", "240*240", "320*240",
        "360*360", "480*360", "640*360", "480*480", "640*480", "720*480", "848*480",
        "960*720", "1280*720", "1920*1080", "144*176", "144*256", "180*240", "180*320",
    "240*320", "360*480", "360*640", "480*640", "480*720", "480*848", "720*960",
    "720*1280", "1080*1920"
    ]

请求示例​

POST /v2/rtc/innercdn/pull_url HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1585127132438
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json
Room-Id: room1

{
    "width": 480,
    "height": 640,
    "fps": 10,
    "kind": "flv",
    "isHttps": 1
}

返回结果​

返回值类型说明
codeNumberHTTP 响应正文中的业务码，10000 为处理成功。
errorMessageString错误信息。
pullUrlString根据客户请求的拉流协议返回对应拉流地址。

返回结果示例​

{
    "code": 10000,
    "errorMessage": "success",
    "pullUrl": "https://pull.rongcloud.cn/a8kqb3rdkbb8j/6D4371504F49564E3977664332754668307935366A673D3D_480_640_10.flv?wsSecret=e1f334e64348823418d9f24d3832d943&wsTime=6222d6e5"
}
最后于 更新