### **3.17.1 直播接口** ### **1. 直播流数据** 比赛的直播流地址在比赛列表和比赛详情接口中"live_url"字段给出，可使用此直播流开发自己的播放器，可实现各类直播打赏、聊天弹幕、互动娱乐等功能。 ~~~ 比赛直播字段示例： "live_urls": [ { "id": 66905, //直播ID "url": "https://XXXXX.m3u8", "url2": "https://XXXXX.flv", "url_type": "m3u8", "language": "zh_CN", //直播语言（中文-zh_CN，越南语-vi_VN，韩语/朝鲜语-ko_KR,日语-ja_JP,英语-en_GB，葡萄牙语-pt_PT，葡萄牙语（巴西）-pt_BR，中国香港(粤语))-zh_HK， 纯净流-origina，为空代表其他 "weight": 10, //直播链接优先级（数值越小，优先级越高） "is_deleted": false //直播是否废弃（添加错会废弃） } ~~~ 如果对flv或者m3U8前端接入遇到技术问题，可在付费后问我方咨询解决方案。 直播组件示例：https://xxxxx/xgplayer/?url=${encoderulcomponent(url)} （因直播源地址含带参数，为防止参数丢失，请用encoderulcomponent进行转接。访问页面后拼?url=${encodeURLComponent(url)}   ） ***** ### **2. 直播接入注意事项** 1、部分直播可能会有时间限制，我方会提前推送新的直播地址，注意更新 2、我方会尽力100%覆盖所有体育比赛，部分比赛直播间错误会删除推送废弃，注意及时调整 ***** ### **3. 关于cdn地址，推流模式** (1) **体育播放域名：**  https://sport.esportstv.vip (2）**通过CDN拉流获取视频直播资源，需注意Refer不能为空：** ① 我们对视频直播的域名进行了相关限制措施，要求客户：Header→Request Headers中的 “Referer” 字段不能为空。（Referer字段所在位置，如下图所示）<br> ② 所以，客户在使用我方直播域名时，请确保Header→Request Headers中的 “Referer” 参数不为空；Referer字段上，需填写贵方自己的网站域名。<br> ③ 若Referer为空，将无法正常拉流获取视频直播资源。 ④e.g：Referer字段 所在位置，如图所示：  ***** ### **4. rtmp直播信号推送** 此模式是直接推送到客户自己的服务器上（例如客户自己的腾讯云），客户拿到流信号，再推送给C端用户 ``` https://pull.esportstv.vip/{AppName}/{StreamName}.m3u8 ``` 举例：https://pull.esportstv.vip/esport/1_208366_66905.m3u8 | 参数 | 数据类型 | 描述 | 备注 | | --- | --- | --- | --- | | match_id | int | 比赛ID |同一个比赛唯一 | | id | int | 直播间id | 一个比赛可能有多个 | | AppName | string | 项目名 | sport：运动；esport：电竞 | | StreamName | string | | 包含运动id、比赛id、直播间id |