Smart版
描述
该接口用于实现视频直播观看功能,适用于具备完善的iot管理平台,只需使用linking产品中的流媒体功能实现直播功能需求场景。
请求
请求语法
POST /v1/startlive HTTP/1.1
Host: linking.qiniuapi.com
Authorization: <QiniuToken>
{
"appid": "<appid>", //linking 账户下的 appid
"device": "<device>", // 设备名称
"publishIP": "<publishIP>", // 推流端外网 ip 地址
"playIP": "<playIP>", // 播放端外网 ip 地址
}
请求头
该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头。
请求元素
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
appid | 是 | string | 设备所属应用的appid,设备名称只能由 4-200 位英文字母和数字组成 |
device | 是 | string | 设备名称 |
publishIP | 是 | string | 推流端外网 ip 地址 |
playIP | 是 | string | 播放端外网 ip 地址 |
响应
响应头
该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头。
响应元素
200 {
"publishUrl": "<publishUrl>", // 推流地址
"playUrls": {
"rtmp": "<rtmp>", // rtmp 播放地址
"hls": "<hls>", // hls 播放地址
"flv": "<flv>" // flv 播放地址
}
}
参数 | 说明 |
---|---|
publishUrl | 推流地址 |
playUrls | 拉流地址,同时会返回rtmp、hls、http+flv三种标准播放协议的拉流地址 |
示例
请求示例
POST /v1/startlive HTTP/1.1
Host: linking.qiniuapi.com
Authorization: Qiniu JAwTPb8dmrbiwt89Eaxa4VsL4_xSIYJoJh4rQfOQ:bszosRMZyxy2X8EAV0FEy_iyWO8=
Content-Type: application/json
{
"appid": "3nm4x087b30o3",
"device":"test001",
"publishIP":"103.90.188.82",
"playIP":"103.90.188.82"
}
响应示例
{
"publishUrl": "rtmp://61.54.93.10:2045/3nm4x087b30o3/test001?domain=pdwjeyj6v.bkt.clouddn.com&e=1558585233&policy=eyJwbGF5TGltaXQiOjB9&route=MTAzLjkwLjE4OC44Ml82MS41NC45My4xMA%3D%3D&token=52fdfc072182654d%3AkHJvlcvLAfCZqKKelnAt2vr2kTg",
"playUrls": {
"rtmp": "rtmp://61.54.93.10:2045/3nm4x087b30o3/test001?domain=pdwjeyj6v.bkt.clouddn.com&e=1558585233&policy=eyJwbGF5TGltaXQiOjB9&route=MTAzLjkwLjE4OC44Ml82MS41NC45My4xMA%3D%3D&token=52fdfc072182654d%3AkHJvlcvLAfCZqKKelnAt2vr2kTg",
"hls": "http://61.54.93.10:1370/3nm4x087b30o3/test001.m3u8?domain=pdwjeyj6v.bkt.clouddn.com&e=1558585233&policy=eyJwbGF5TGltaXQiOjB9&route=MTAzLjkwLjE4OC44Ml82MS41NC45My4xMA%3D%3D&token=52fdfc072182654d%3A3O6ZgtWdNps-j6VTe4kLssYYP7Y",
"flv": "http://61.54.93.10:1360/3nm4x087b30o3/test001.flv?domain=pdwjeyj6v.bkt.clouddn.com&e=1558585233&policy=eyJwbGF5TGltaXQiOjB9&route=MTAzLjkwLjE4OC44Ml82MS41NC45My4xMA%3D%3D&token=52fdfc072182654d%3ADBKdoukVdmr6SggZ_3_A68DvH6Y"
}
}
文档反馈
(如有产品使用问题,请 提交工单)