腾讯云直播SDK微信小程序_音视频解决方案_同尘科技
是小程序内部用于支持音视频下行(播放)能力的功能标签,本文主要介绍该标签的使用方法。
版本支持
微信 App iOS 最低版本要求:6.5.21。微信 App Android 最低版本要求:6.5.19。 小程序基础库最低版本要求:1.7.0。说明 通过 wx.getSystemInfo 可以获取当前基础库版本信息。
使用限制
出于政策和合规的考虑,微信暂时没有放开所有小程序对 和 标签的支持:个人账号和企业账号的小程序暂时只开放如下表格中的类目:
一级类目/主体类型 | 二级类目 | 资质要求 | 类目适用范围 | 小程序直播内容场景 |
社交 | 直播 | (3选1): 1.《信息网络传播视听节目许可证》 2.《网络文化经营许可证》(经营范围含网络表演) 3.《统一社会信用代码》 及 《情况说明函件》(适用于政府主体) |
适用于提供在线直播等服务注意:1. 如提供时政信息服务,需补充:时政信息类目2. 选择该类目后首次提交代码审核,需经当地互联网主管机关审核确认,预计审核时长7天左右 | 涉及娱乐性质,如明星直播、生活趣事直播、宠物直播等。选择该类目后首次提交代码审核,需经当地互联网主管机关审核确认,预计审核时长7天左右 |
教育 | 在线视频课程 | (5选1): 1. 《事业单位法人证书》(适用公立学校) 2. 区、县级教育部门颁发的《民办学校办学许可证》(适用培训机构) 3. 《信息网络传播视听节目许可证》 4. 全国校外线上培训管理服务平台备案 5. 教育部门的批准文件 |
适用于教育行业提供,网课、在线培训、讲座等教育类视频/直播等服务 | 网课、在线培训、讲座等教育类直播 |
医疗 | 互联网医院 | (2选1): 1. 卫生健康部门的《设置医疗机构批准书》; 2. 合作医院的《医疗机构执业许可证》与执业登记机关的审核合格文件 |
适用于互联网医院主体/医疗服务平台提供在线看诊、疾病咨询等线上医疗服务 | 问诊、大型健康讲座等直播 |
| 公立医疗机构 | 《医疗机构执业许可证》与《事业单位法人证书》 | 适用于公立医疗机构提供的就医、健康咨询/问诊、医疗保健信息等服务 | |
金融 | 银行 | (2选1): 1.《金融许可证》 2.《金融机构许可证》 |
适用于提供银行业务在线服务或交易等服务 | 金融产品视频客服理赔、金融产品推广直播等 |
| 信托 | (2选1): 1.《金融许可证》 2.《金融机构许可证》 |
适用于提供信托理财业务在线服务或交易等服务 | |
| 公募基金 | (3选1): 1.《经营证券期货业务许可证》且业务范围必须包含“基金” 2.《基金托管业务许可证》 3.《基金销售业务资格证书》 |
适用于基金管理公司从事股票、债券等金融工具的投资服务 | |
| 私募基金 | (2选1):1.《私募基金备案证明》2.《私募投资基金管理人登记证书》 | 仅适用于私募基金展示、介绍、咨询等服务 注:暂不支持涉及私募产品公开募集或在线交易等服务 | |
| 证券/期货 | 《经营证券期货业务许可证》 | 适用于提供证券资讯、证券咨询、证券期货经营等的在线服务 | |
| 证券、期货投资咨询 | (2选1): 1.《证券投资咨询业务资格证书》 2.《经营证券期货业务许可证》 |
适用于提供证券、期货投资等在线咨询服务 | |
| 保险 | (8选1): 1.《保险公司法人许可证》 2.《经营保险业务许可证》 3.《保险营销服务许可证》 4.《经营保险代理业务许可证》 5.《经营保险经纪业务许可证》 6.《经营保险公估业务许可证》 7.《经营保险资产管理业务许可证》 8.《保险兼业代理业务许可证》 |
适用于提供保险业务在线服务或交易等服务 | |
| 征信业务 | (2选1): 1. 经营个人征信业务:《个人征信业务经营许可证》、《营业执照》 2. 经营企业征信业务:经所在地的中国人民银行及其派出机构备案的《企业征信业务经营备案证》、《营业执照》 |
适用于银行或征信机构提供征信业务服务,包括:信贷记录、逾期记录、失信人查询等 | |
| 新三板信息服务平台 | 全国中小企业股份转让系统有限责任公司的书面许可与《非经营性互联网信息服务备案核准》 | 适用于提供新三板信息行情资讯等服务 | |
| 股票信息服务平台(港股/美股) | 《非经营性互联网信息服务备案核准》 | 适用于提供港股、美股行情资讯、行情分析等服务 注:如提供股票交易服务,需补充:金融业-证券/期货类目 | |
| 消费金融 | 银监会核准开业的审批文件与《金融许可证》与《营业执照》 | 适用于提供消费金融线上服务或交易等服务 | |
汽车 | 汽车预售服务 | (3选1): 1. 汽车厂商:《营业执照》与《工信部道路机动车辆生产企业准入许可》 2. 汽车经销商/4s店:《营业执照》与《厂商授权销售文件》与《工信部道路机动车辆生产企业准入许可》 3. 下属子/分公司:《营业执照》与《工信部道路机动车辆生产企业准入许可》与《股权关系证明函》(含双方盖章) |
适用于提供汽车在线预付款等服务 注:平台暂不支持在线整车销售,如涉及整车销售服务,建议改为价格指导或移除相关功能 | 汽车预售、推广直播 |
政府主体账号 | – | – | – | 政府相关工作推广直播、领导讲话直播等 |
IT 科技 | 音视频设备 | 《中国国家强制性产品认证证书》 | 为多方提供电话会议/视频会议等服务;智能家居场景下控制摄像头 | 适用于提供音视频设备、信息技术设备、电信终端设备等线下硬件在线销售及服务。 |
| 多方通信 | 《增值电信业务经营许可证》(业务范围需含”国内多方通信服务业务”) | | 仅适用于为多方提供电话会议/视频会议等服务 |
房地产服务 | 房地产营销 | (3选1): 1.《商品房预售许可证》 2.《商品房销售许可证》 3.《商品房现售备案证明》 |
房地产营销直播服务、在线音视频带看等 | 适用于房地产开发商提供购房意向款、优惠券、权益券等营销活动 |
说明可申请直播标签的小程序类目以 微信文档 说明为主,小程序类目的资质要求详见 非个人主体类目申请。符合类目要求的小程序,需要在小程序管理后台的 开发 > 接口设置” 中自助开通该组件权限,如下图所示:
注意 如果以上设置都正确,但小程序依然不能正常工作,可能是微信内部的缓存没更新,请删除小程序并重启微信后,再进行尝试。
属性定义
属性名 | 类型 | 默认值 | 说明 |
src | String | – | 用于音视频下行的播放 URL,支持 RTMP、FLV 等协议 |
mode | String | live | live,RTC |
autoplay | Boolean | false | 是否自动播放 |
muted | Boolean | false | 是否静音 |
orientation | String | vertical | vertical,horizontal |
object-fit | String | contain | contain,fillCrop |
background-mute | Boolean | false | 当微信切到后台时,是否关闭播放声音 |
min-cache | Number | 1 | 最小缓冲延迟, 单位:秒 |
max-cache | Number | 3 | 最大缓冲延迟, 单位:秒 |
bindstatechange | EventHandler | – | 用于指定一个 javascript 函数来接受播放器事件 |
bindfullscreenchange | EventHandler | – | 用于指定一个 javascript 函数来接受全屏事件 |
debug | Boolean | false | 是否开启调试模式 |
示例代码
超低时延
的 RTC 模式支持500ms以内的超低时延链路,可以应用在视频通话和远程遥控等场景中,要使用超低时延播放,需要注意如下几点:推流端如果是微信小程序,请使用 的 RTC 模式。推流端如果是 iOS 或者 Android SDK,请使用 setVideoQuality 的 MAIN_PUBLISHER 模式。 的 min-cache
和 max-cache
请不要自行设置,使用默认值。播放地址请使用超低延时播放地址,也就是带了防盗链签名的 rtmp://
地址,如下:
对比项目 | 示例 | 时延 |
普通直播 URL | rtmp://3891.liveplay.myqcloud.com/live/3891_test_clock_for_rtmpacc | > 2s |
超低延时 URL | rtmp://3891.liveplay.myqcloud.com/live/3891_test_clock_for_rtmpacc?bizid=bizid&txTime=5FD4431C&txSecret=20e6d865f462dff61ada209d53c71cf9 | < 500ms |
属性详解
src
用于音视频下行的播放 URL,支持 RTMP 协议(URL 以 “rtmp://” 打头)和 FLV 协议(URL 以 “http://” 打头且以 “.flv” 结尾) ,腾讯云推流 URL 的获取方法见 DOC。说明 标签是不支持 HLS(m3u8) 协议的,因为
对象操作
参数 | 说明 |
wx.createLivePlayerContext() | 通过 wx.createLivePlayerContext() 可以将 标签和 javascript 对象关联起来,之后即可操作该对象 |
play | 开始播放,如果 的 autoplay 属性设置为 false(默认值),那么就可以使用 play 来手动启动播放 |
stop | 停止播放 |
pause | 暂停播放,停留在最后画面 |
resume | 继续播放,与 pause 成对使用 |
mute | 设置静音 |
requestFullScreen | 进入全屏幕 |
exitFullScreen | 退出全屏幕 |
var player = wx.createLivePlayerContext('pusher');player.requestFullScreen({ success: function(){ console.log('enter full screen mode success!') } fail: function(){ console.log('enter full screen mode failed!') } complete: function(){ console.log('enter full screen mode complete!') }});
内部事件
通过 标签的 bindstatechange 属性可以绑定一个事件处理函数,该函数可以监听推流模块的内部事件和异常通知。
关键事件
code | 事件定义 | 含义说明 |
2001 | PLAY_EVT_CONNECT_SUCC | 已经连接到云端服务器 |
2002 | PLAY_EVT_RTMP_STREAM_BEGIN | 服务器开始传输音视频数据 |
2003 | PLAY_EVT_RCV_FIRST_I_FRAME | 网络接收到首段音视频数据 |
2004 | PLAY_EVT_PLAY_BEGIN | 视频播放开始,可以在收到此事件之前先用默认图片代表等待状态 |
2006 | PLAY_EVT_PLAY_END | 视频播放结束 |
2007 | PLAY_EVT_PLAY_LOADING | 进入缓冲中状态,此时播放器在等待或积攒来自服务器的数据 |
-2301 | PLAY_ERR_NET_DISCONNECT | 网络连接断开,且重新连接亦不能恢复,播放器已停止播放 |
说明 播放 HTTP:// 打头的 FLV 协议地址时,如果观众遇到播放中直播流断开的情况,小程序是不会抛出 PLAY_EVT_PLAY_END 事件的,这是因为 FLV 协议中没有定义停止事件,所以只能通过监听 PLAY_ERR_NET_DISCONNECT 来替代之。
警告事件
内部警告并非不可恢复的错误,小程序内部的音视频 SDK 会启动相应的恢复措施,警告的目的主要用于提示开发者或者最终用户,例如:
code | 事件定义 | 含义说明 |
2101 | PLAY_WARNING_VIDEO_DECODE_FAIL | 当前视频帧解码失败。 |
2102 | PLAY_WARNING_AUDIO_DECODE_FAIL | 当前音频帧解码失败。 |
2103 | PLAY_WARNING_RECONNECT | 网络断连,已启动自动重连恢复(重连超过三次就直接抛送 PLAY_ERR_NET_DISCONNECT 了)。 |
2104 | PLAY_WARNING_RECV_DATA_LAG | 视频流不太稳定,可能是观看者当前网速不充裕。 |
2105 | PLAY_WARNING_VIDEO_PLAY_LAG | 当前视频播放出现卡顿。 |
2106 | PLAY_WARNING_HW_ACCELERATION_FAIL | 硬解启动失败,采用软解。 |
2107 | PLAY_WARNING_VIDEO_DISCONTINUITY | 当前视频帧不连续,视频源可能有丢帧,可能会导致画面花屏。 |
3001 | PLAY_WARNING_DNS_FAIL | DNS 解析失败(仅播放 RTMP:// 地址时会抛送)。 |
3002 | PLAY_WARNING_SEVER_CONN_FAIL | 服务器连接失败(仅播放 RTMP:// 地址时会抛送)。 |
3003 | PLAY_WARNING_SHAKE_FAIL | 服务器握手失败(仅播放 RTMP:// 地址时会抛送)。 |
示例代码
Page({ onPlay: function(ret) { if(ret.detail.code == 2004) { console.log('视频播放开始',ret); } },
/** * 生命周期函数--监听页面加载 */ onLoad: function (options) { //... }})
特别说明
组件是由客户端创建的原生组件,它的层级是最高的,可以使用 和 覆盖在上面。请勿在 中使用 组件。组件的 RTC 模式有并发播放限制,目前最多同时10路并发播放。说明 设置该限制原因并非技术能力限制,而是希望您只考虑在互动场景中使用(例如连麦时只给主播使用,或者夹娃娃直播中只给操控娃娃机的玩家使用),避免因为盲目追求低延时而产生不必要的费用损失(低延迟线路的价格要高于 CDN 线路的价格)。
对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?