浏览 2676
扫码
live-pusher
基础库 1.7.0 开始支持,低版本需做兼容处理
实时音视频录制。
需要用户授权 scope.camera、scope.record
暂只针对如下类目开放,需要先通过类目审核,再在小程序管理后台,“设置”-“接口设置”中自助开通该组件权限。
| 一级类目 | 二级类目 |
|---|---|
| 社交 | 直播 |
| 教育 | 在线教育 |
| 医疗 | 互联网医院,公立医院 |
| 政务民生 | 所有二级类目 |
| 金融 | 基金、信托、保险、银行、证券/期货、非金融机构自营小额贷款、征信业务、消费金融 |
| 属性名 | 类型 | 默认值 | 说明 | 最低版本 |
|---|---|---|---|---|
| url | String | 推流地址。目前仅支持 flv, rtmp 格式 | ||
| mode | String | RTC | SD(标清), HD(高清), FHD(超清), RTC(实时通话) | |
| autopush | Boolean | false | 自动推流 | |
| muted | Boolean | false | 是否静音 | |
| enable-camera | Boolean | true | 开启摄像头 | |
| auto-focus | Boolean | true | 自动聚集 | |
| orientation | String | vertical | vertical,horizontal | |
| beauty | Number | 0 | 美颜 | |
| whiteness | Number | 0 | 美白 | |
| aspect | String | 9:16 | 宽高比,可选值有 3:4, 9:16 | |
| min-bitrate | Number | 200 | 最小码率 | |
| max-bitrate | Number | 1000 | 最大码率 | |
| waiting-image | String | 进入后台时推流的等待画面 | ||
| waiting-image-hash | String | 等待画面资源的MD5值 | ||
| zoom | Boolean | false | 调整焦距 | 2.1.0 |
| background-mute | Boolean | false | 进入后台时是否静音 | |
| bindstatechange | EventHandle | 状态变化事件,detail = {code} | ||
| bindnetstatus | EventHandle | 网络状态通知,detail = {info} | 1.9.0 | |
| binderror | EventHandle | 渲染错误事件,detail = {errMsg, errCode} | 1.7.4 |
注意:
默认宽度为100%、无默认高度,请通过wxss设置宽高。 - 开发者工具上暂不支持。
- 相关api:wx.createLivePusherContext
错误码(errCode)
| 代码 | 说明 |
|---|---|
| 10001 | 用户禁止使用摄像头 |
| 10002 | 用户禁止使用录音 |
状态码(code)
| 代码 | 说明 |
|---|---|
| 1001 | 已经连接推流服务器 |
| 1002 | 已经与服务器握手完毕,开始推流 |
| 1003 | 打开摄像头成功 |
| 1004 | 录屏启动成功 |
| 1005 | 推流动态调整分辨率 |
| 1006 | 推流动态调整码率 |
| 1007 | 首帧画面采集完成 |
| 1008 | 编码器启动 |
| -1301 | 打开摄像头失败 |
| -1302 | 打开麦克风失败 |
| -1303 | 视频编码失败 |
| -1304 | 音频编码失败 |
| -1305 | 不支持的视频分辨率 |
| -1306 | 不支持的音频采样率 |
| -1307 | 网络断连,且经多次重连抢救无效,更多重试请自行重启推流 |
| -1308 | 开始录屏失败,可能是被用户拒绝 |
| -1309 | 录屏失败,不支持的Android系统版本,需要5.0以上的系统 |
| -1310 | 录屏被其他应用打断了 |
| -1311 | Android Mic打开成功,但是录不到音频数据 |
| -1312 | 录屏动态切横竖屏失败 |
| 1101 | 网络状况不佳:上行带宽太小,上传数据受阻 |
| 1102 | 网络断连, 已启动自动重连 |
| 1103 | 硬编码启动失败,采用软编码 |
| 1104 | 视频编码失败 |
| 1105 | 新美颜软编码启动失败,采用老的软编码 |
| 1106 | 新美颜软编码启动失败,采用老的软编码 |
| 3001 | RTMP -DNS解析失败 |
| 3002 | RTMP服务器连接失败 |
| 3003 | RTMP服务器握手失败 |
| 3004 | RTMP服务器主动断开,请检查推流地址的合法性或防盗链有效期 |
| 3005 | RTMP 读/写失败 |
网络状态数据(info)
| 键名 | 说明 |
|---|---|
| videoBitrate | 当前视频编/码器输出的比特率,单位 kbps |
| audioBitrate | 当前音频编/码器输出的比特率,单位 kbps |
| videoFPS | 当前视频帧率 |
| videoGOP | 当前视频 GOP,也就是每两个关键帧(I帧)间隔时长,单位 s |
| netSpeed | 当前的发送/接收速度 |
| netJitter | 网络抖动情况,抖动越大,网络越不稳定 |
| videoWidth | 视频画面的宽度 |
| videoHeight | 视频画面的高度 |
示例代码:
<live-pusher url="https://domain/push_stream" mode="RTC" autopush bindstatechange="statechange" style="width: 300px; height: 225px;" />
Page({statechange(e) {console.log('live-pusher code:', e.detail.code)}})
Bug & Tip
- tip: live-pusher 组件是由客户端创建的原生组件,它的层级是最高的,不能通过 z-index 控制层级。可使用 cover-view cover-image覆盖在上面。
- tip: 请勿在 scroll-view、swiper、picker-view、movable-view 中使用 live-pusher 组件。
- tip: css 动画对 live-pusher 组件无效。<
原文:
https://developers.weixin.qq.com/miniprogram/dev/component/live-pusher.html
