为保护用户数据,小鱼server的录制文件是加密存储的,无法直接播放。若需要进行录制文件的播放分享,可调用该API获取视频的播放地址。
默认接口请求频率限制:20次/秒
REST URL
GET https://sdk.xylink.com/api/rest/external/v1/vods/getM3u8Url?enterpriseId=XXX&signature=XXX&vodId=xxx&linkLimitCount=10
请求参数说明:
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
version | String | Path | 是 | 无 | 传v1即可 | 公有云 5.2不支持 |
enterpriseId | String | Query | 是 | 无 | 企业ID | 公有云 5.2不支持 |
vodId | Long | Query | 是 | 无 | 视频id | 公有云 5.2不支持 |
linkLimitCount | Long | Query | 否 | 无 | 播放链接可访问次数限制,传值时必须大于 0 | 公有云 5.2不支持 |
请求成功返回结果示例
{
"playUrl": "http://vod.xylink.com/vodserver-prd-2/cloud/901025680965/101-bj1-prdSig1-1163237707906_0_16423252940831_1280_720.mp4/index.m3u8?proxysessionid=1801309955,bandwidth=1732698",
"innerPlayUrl": "http://vod.xylink.com/vodserver-prd-2/cloud/901025680965/101-bj1-prdSig1-11232967707906_0_1642322940831_1280_720.mp4/index.m3u8?proxysessionid=1808999955,bandwidth=1725698"
}请求成功返回结果示例2
返回参数说明:
参数 | 说明 |
playUrl | 播放链接 注:由于视频地址会失效,故不建议将视频地址缓存、保存本地使用,建议即用即拿。 |
innerPlayUrl | 播放链接: 部署在在内网情况下; 注:由于视频地址会失效,故不建议将视频地址缓存、保存本地使用,建议即用即拿。 |
请求失败结果示例
{
"developerMessage": "ErrorStatus: SDK_INVALID_APPKEY No app found for extId: ",
"userMessage": "sdk.invalid.key",
"errorCode": 60001,
"moreInfo": "http://www.com.ainemo.com/errors/60001"
}错误码见小鱼RESTAPI错误码
触发事件回调:首次调用获取视频下载链接或获取视频播放链接,会触发DecryptStatus事件回调。