首页 / 文档中心 / 平台接口 API / 视频地址生成-1

视频地址生成-1

平台接口 API · 通用接口

简要描述:

  • 按设备通道生成视频直播地址,需要提前在设备上配置开启视频直播

请求URL:
- /product/genUrls

请求方式:
- POST

参数:

参数名 必选 类型 说明
pId 是 string 设备id
cId 是 int 通道号 从1开始
genType 是 string 生成类型 (url == 快直播地址, fast == 低延迟地址)
des 是 string 描述信息
expiredSec 是 int64 过期结束秒数(1970年到过期时间的时间戳)
protocol 否 string 返回协议取值范围:(hls,flv,ws,rtmp,webrtc)默认全部返回,多个用逗号隔开

返回示例

{
  "item": {
    "id": "cdeb442f7dff7adb0df6bbecc5270827",
    "des": "测试",
    "type": "url",
    "createTime": "2025-03-26T11:28:36+08:00",
    "expiredTime": "2025-03-29T11:28:36+08:00"
  },
  "urls": {
    "hlsUrl": "https://hls.cloud.xstrive.com/0b345b5917716f597dda2cab1661a069/hlsram/live0/cdeb442f7dff7adb0df6bbecc5270827.m3u8",
    "flvUrl": "https://flv.cloud.xstrive.com/0b345b5917716f597dda2cab1661a069/hlsram/live0/cdeb442f7dff7adb0df6bbecc5270827.flv",
    "fastFlv": "https://rwen.xstrive.com/hdl/0b345b5917716f597dda2cab1661a069/live0/cdeb442f7dff7adb0df6bbecc5270827.flv",
    "fastWebrtc": "https://rwen.xstrive.com/api/webrtc/cloud/play?sid=0b345b5917716f597dda2cab1661a069&streamPath=live0&sk=cdeb442f7dff7adb0df6bbecc5270827",
    "fastHls": "https://rwen.xstrive.com/hls/0b345b5917716f597dda2cab1661a069/live0/cdeb442f7dff7adb0df6bbecc5270827/index.m3u8",
    "fastWs": "ws://rwen.xstrive.com/ws/0b345b5917716f597dda2cab1661a069/live0/cdeb442f7dff7adb0df6bbecc5270827.flv",
    "fastRtmp": "rtmp://rwen.xstrive.com:19352/0b345b5917716f597dda2cab1661a069/live0_cdeb442f7dff7adb0df6bbecc5270827"
  }
}

返回参数说明

参数名 类型 说明
item.id string 加密token
item.des string 描述信息
item.path string 已废弃,不在使用
item.type string 请求时的生成类型
item.createTime string 创建时间
item.expiredTime string 过期时间
urls.hlsUrl string 快直播hls地址
urls.flvUrl string 快直播flv地址
urls.fastFlv string 低延迟flv地址
urls.fastWebrtc string 低延迟webrtc地址
urls.fastHls string 低延迟hls地址
urls.fastWs string 低延迟ws地址
urls.fastRtmp string 低延迟rtmp地址

备注

  • 适用于第三方平台接入
  • 域名可能会更换,请勿自行拼接播放地址。
  • 直播域名:hls.cloud.xstrive.com、flv.cloud.xstrive.com、rwen.xstrive.com
  • 备用域名 hlscloud1.xstrive.com、flvcloud1.xstrive.com、rwen1.xstrive.com、hlscloud2.xstrive.com、flvcloud2.xstrive.com、rwen2.xstrive.com
  • 如需添加白名单,请把直播域名,备用域名全部添加
这份文档没解决你的问题?联系我们,技术工程师直接对接。

询价咨询

填写这几项,我们 1 个工作日内回传报价与方案

点「生成询价邮件」会打开你的邮件客户端,正文已自动填好;电脑没配邮件客户端,就点「复制内容」粘到网页邮箱发送,收件人 sunshiyang@xstrive.com。