获取融云 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 对象:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
width | Int | 否 | 指定视频宽度,必须参照宽高限制 列表进行配置。 |
height | Int | 否 | 指定视频高度,必须参照宽高限制列表进行配置。 |
fps | Int | 否 | 帧率。接受 10 /15 /24 /30 ,默认为源流帧率。 |
kind | String | 否 | 拉流协议。支持 flv /rtmp /hls ,默认为 rtmp 。 |
isHttps | Int | 否 | 是否开启 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
}