API 文档

推流播放相关

最近更新时间:2021-07-06 16:59:08

直播的在线人数是否有上限?

腾讯云直播默认不限制观看直播的在线人数,只要网络等条件允许都可以观看直播。如果用户配置了带宽限制,当观看人数过多、超出了限制带宽时新的用户无法观看,此情况下在线人数是有限制的。

如何使用播放转码?

考虑到不同的网络因素,满足您使用不同码率不同分辨率的需求,您可以前往 转码配置 设置不同码率不同分辨率的转码模板,更多转码相关信息请参见 最佳实践 - 直播转封装及转码

原始、高清、标清场景

在业务播放场景中,一般会用到三个码率:原始、高清、标清。

  • 原始流与推流码率分辨率一致。
  • 高清流建议使用码率:2000kbps,分辨率:1080p。
  • 标清流建议使用码率:1000kbps,分辨率:720p。

如何使用时移回看?

若您想回看过去某段时间的精彩内容,您可以使用时移功能,时移功能目前仅支持 HLS 协议。具体时移的相关介绍以及开通方法请参考 最佳实践 - 直播时移

如何使用 HTTPS 播放?

若您的播放域名需要支持 HTTPS,您需要准备好有效的证书内容、有效私钥内容前往 域名管理,选择【播放域名管理】>【高级配置】>【HTTPS配置】添加配置,添加成功之后会有个生效时间(2小时),在生效后您的直播流就可以支持 HTTPS 协议播放。

如何使用海外加速节点播放?

云直播 CDN 节点不仅遍布中国大陆区域,同样在全世界各个大洲也有节点覆盖,覆盖广并且稳定。假如您的用户分布在中国香港、中国澳门、中国台湾或境外其他地区,您可以通过在 域名管理 中配置域名时候加速区域选择【全球加速】或【中国港澳台地区及海外地区】,来获得海外节点覆盖的支持。

如何开启播放防盗链?

为防止非法用户盗取您的播放 URL 在别处播放,造成流量损失,强烈建议您给播放地址加上播放防盗链,防止因盗链产生不必要的损失。云直播的播放防盗链主要由四个参数值控制:txTime、key(哈希密钥)、txSecret、有效时间。

防盗链参数 描述 补充说明
txTime 播放 URL 的有效时间 格式为16进制 UNIX 时间。
如果当前 txTime 的值大于当前请求的时间则可以正常播放,否则播放会被后台拒绝。
key MD5 计算方式的密钥 可以自定义,并可以设置主备两个 key。
当您的主 key 意外泄露的时候,您可以使用备用 key 进行拼接播放 URL,并同时更改主 key 的值。
txSecret 播放 URL 中的加密参数 值是通过将 key,StreamName,txTime 依次拼接的字符串进行 MD5 加密算法得出。
txSecret = MD5(key+StreamName+txTime)。
有效时间 地址有效时间 有效时间设置必须大于0。
假设 txTime 设置为当前时间,有效时间设置为300s,则播放 URL 过期时间为当前时间 + 300s。

防盗链计算

防盗链计算需要三个参数,key(随机字符串)、StreamName(流名称) ,txTime(16进制格式)。
假设您设置的 key 为 somestring,流名称(StreamName)为 test,txTime 为 5c2acacc(2019-01-01 10:05:00)。高清码率为:900kbps,转码模板名称为:900
原始流播放地址:

txSecret = MD5(somestringtest5c2acacc) = b77e812107e1d8b8f247885a46e1bd34
http://domain/live/test.flv?txTime=5c2acacc&txSecret=b77e812107e1d8b8f247885a46e1bd34
http://domain/live/test.m3u8?txTime=5c2acacc&txSecret=b77e812107e1d8b8f247885a46e1bd34

高清流播放地址:

txSecret = MD5(somestringtest_9005c2acacc) = 4beae959b16c77da6a65c7edda1dfefe
http://domain/live/test_900.flv?txTime=5c2acacc&txSecret=4beae959b16c77da6a65c7edda1dfefe
http://domain/live/test_900.m3u8?txTime=5c2acacc&txSecret=4beae959b16c77da6a65c7edda1dfefe

开启播放防盗链

  1. 登录进入 域名管理
  2. 选择播放域名或单击所在行的【管理】,进入域名详情页。
  3. 选择【访问控制】,单击【编辑】。
  4. 设置【播放鉴权】为开启,单击【保存】。
注意:

  • 播放鉴权的设置成功后需要30分钟后生效 。
  • HTTP-FLV:正在播放的 URL 在 txTime 过期后依然能正常播放,在 txTime 过期后重新请求播放则会拒绝。
  • HLS:由于 HLS 是短链接,会不断的请求 m3u8 获取最新的 ts 分片。假设您设置 txTime 的值为当前时间 + 10分钟,则在10分钟之后 HLS 播放 URL 请求会被拒绝。针对这个问题您可在业务端动态更新 HLS 的请求地址,或者将 HLS 的播放地址过期时间设置久一点。

播放鉴权配置中主 Key 的格式有什么要求?有效时间时长有没有限制?

鉴权配置中主 Key 值仅支持大写字母,小写字母和数字,最大长度256位。字母数字随机组合搭配即可。更多详情,请参见 播放鉴权配置
有效时间时长建议设置为一场直播的时间长度。

可以创建固定的直播推流地址吗?地址有效时长最多可以设置为多久?

推流地址设置有效时间主要是为了防盗鉴权,若创建固定的推流地址,可能会出现盗推现象并对当前业务造成损失。
直播推流地址有效时长没有限制,可根据个人业务需求设置地址过期时间。同时,也可以通过拼接规则生成有效期更长的推流地址,具体拼装方式请参见 自主拼装直播 URL 相关问题

说明:

推流地址有效期不建议设置太长,否则该推流地址在使用过程中会报错,并提醒鉴权失败。

直播服务中的视频是否会显示腾讯云 Logo?

直播服务中的视频不会显示腾讯云 Logo。

直播延迟多少?

正常情况下,使用 RTMP 协议推流并通过 FLV 协议播放,延迟在2秒 - 3秒左右,如果太长一般是有问题的。如果您发现直播延迟时间特别长,具体排查思路请参见 直播延迟问题排查

直播时是否可以设置最高码率?

不可以的,这是推流端自行设置的,但是推流端设置最高码率也要根据您网络的上传速度来决定。码率(或称最大比特率)上限就是您的网络上传速度,如果设太高就会使直播画面丢帧卡顿。

腾讯云直播不用的直播房间怎么删除?

云直播目前是通过直播流id来关联直播推流和播放,无需进行删除操作;若您使用了即时通信 IM 服务,想要删除 IM 的房间避免达到上限,可参考 解散群组 进行操作。
如果您使用的是频道模式的话,可以调用 DeleteLVBChannel-删除直播频道 接口进行删除,输入待删除的直播频道的 ID 号(支持批量)。

注意:

频道模式为旧版方案,目前已不在更新维护。

直播开启关闭推流接口有什么用?

直播开启关闭推流接口主要用于鉴黄时的禁播场景,例如后台发现某个主播有涉黄或者反动内容,可以随时断流或者禁用这条流。具体调用方法请参见 禁推直播流

如何实现后台播放?

后台播放是终端功能,需要根据客户实际业务逻辑进行开发,只要直播流未中断,可以支持后台播放音频。

修改 HTTPS 配置时,添加证书信息后提醒“证书不正确”,怎么办?

云直播的加密服务使用 Nginx,因此证书类型必须为 Nginx,请确认您当前证书类型是否正确。

播放域名关闭鉴权后,原来生成的播放地址无法播放了?

播放鉴权可以设置有效期,在有效期内即使关闭了访问鉴权,原始地址仍然无法播放。

接口限定访问次数如何理解?

云直播对帐号下所有 SecretId 发送的请求总数有访问次数限制,超过限制的请求不会正常响应。
例如,1秒内不超过200次。指您帐号下所有 SecretId 发送的这类请求在1秒内腾讯云服务器只接收200次,至于这200个是 1个客户发200次、还是200个客户每人1次、查询多个还是一个流,这边是不限制的,只算总请求数。

推流过程中显示“RTMP close”并推流失败,但日志提醒推流成功是什么情况?

可能是您当前推流地址有问题,建议使用 小程序 Demo 测试推流地址是否能正常推流。更多问题排查方法请参见 推流失败问题排查

修改帧率后无法正常推流,需要本地多次重启服务,并经常断开,如何处理?

可能是当前设置帧率过高。15帧以上即可保证视频流畅播放,建议调低帧率。

什么情况下会出现系统主动断开长时间无数据的推流?

在推流时设备出现问题的情况下会出现该类问题。
例如:App 闪退,手机关机等其他非主观原因出现的异常,导致后台在70s内无法采集到数据推流,系统会主动断开。

新版控制台如何配置 API 密钥?

API KEY 为旧版 API 接口鉴权,目前官网 API 接口已升级为3.0版本,您可以通过【API 密钥管理】获取 SecretId 和 Secretkey 使用最新的 API 3.0 接口。

目录