推拉流自定义组件
由于微信开发者工具模拟器并不支持 rtmp 协议,所以推拉流组件在模拟器中无法正常显示,建议在真机中查看推拉流组件的效果。
引入推拉流组件配置属性需要的枚举值:
import {
ORIENTATION,
ASPECT,
LOCALMIRROR,
AUDIOREVERBTYPE,
BEAUTYSTYLE,
FILTER,
OBJECTFIT,
REFERRERPOLICY,
RCAudioOutputDevice,
RCAudioVolumeType
} from '@rongcloud/plugin-wechat-rtc'
提示
以下属性和自定义事件,除拉流组件的 id 属性,其他均为可选配置项,可按业务需求添加。
推流组件
配置属性
<rc-livepusher style="{{style}}"></rc-livepusher>
参数 | 类型 | 说明 |
---|---|---|
style | String | 组件样式,默认样式为 width:100%;height:100px,可以传入配置样式修改 |
minBitrate | Number | 最小码率,默认为 200 |
maxBitrate | Number | 最大码率,默认为 1000 |
audioVolumeType | RCAudioVolumeType | 音量类型,包括:自动、媒体音量 、通话音量,默认为 RCAudioVolumeType.AUTO,即自动 |
beauty | Number | 美颜,取值范围为 0-9,默认为 0,代表关闭 |
whiteness | Number | 美白,取值范围为 0-9,默认为 0,代表关闭 |
autoFocus | Boolean | 是否自动聚焦,默认为 true |
orientation | ORIENTATION | 画面方向,默认为 ORIENTATION.VERTICAL,即竖直 |
aspect | ASPECT | 宽高比,默认为 ASPECT.NINEDIVIDESIXTEEN,即 9/16 |
waitingImage | String | 进入后台时推流的等待画面 |
zoom | Boolean | 调整焦距,默认为 false |
remoteMirror | Boolean | 设置推流画面是否镜像,产生的效果在 live-player 反应到,默认为 false |
localMirror | LOCALMIRROR | 控制本地预览画面是否镜像,默认为 LOCALMIRROR.AUTO ,即前置摄像头镜像,后置摄像头不镜像 |
audioReverbType | AUDIOREVERBTYPE | 音频混响类型,默认为 AUDIOREVERBTYPE.CLOSE,代表关闭 |
enableAgc | Boolean | 是否开启音频自动增益,默认为 false |
enableAns | Boolean | 是否开启音频噪声抑制,默认为 false |
videoWidth | Number | 上推的视频流的分辨率宽度,默认为 360 |
videoHeight | Number | 上推的视频流的分辨率高度,默认为 640 |
beautyStyle | BEAUTYSTYLE | 美颜类型,默认为 BEAUTYSTYLE.SMOOTH,代表光滑 |
filter | FILTER | 色彩滤镜,默认为 FILTER.STANDARD,即标准 |
增加自定义事件
推流自定义事件的抛出值可参考 微信小程序 live-pusher 中的说明。
参数 | 类型 | 说明 |
---|---|---|
bindstatechange | Function | 状态变化事件 |
bindnetstatus | Function | 网络状态通知 |
binderror | Function | 渲染错误事件 |
bindbgmstart | Function | 背景音开始播放时触发 |
bindbgmprogress | Function | 背景音进度变化时触发 |
bindbgmcomplete | Function | 背景音播放完成时触发 |
bindaudiovolumenotify | Function | 麦克风采集的音量大小通知 |
拉流组件
每个 stream 对应一个拉流组件,订阅多个 stream 时,需引入多个拉流组件并传入 id。id 为房间内其他人发布的资源 stream 的唯一标识,可通过 stream.getMsid() 获取。id 为必须配置项。
配置属性
<rc-liveplayer id="{{id}}"></rc-liveplayer>
参数 | 类型 | 说明 |
---|---|---|
id | String | 播放组件 id |
style | String | 组件样式,默认样式为 width:100%;height:100px,可以传入配置样式修改 |
muted | Boolean | 是否静音,默认为 false |
objectFit | OBJECTFIT | 填充模式,视频短边被填充为黑色或裁剪视频长边,默认为:视频短边被填充为黑色 |
orientation | ORIENTATION | 画面方向,竖直或水平,默认为竖直 |
autoPauseIfNavigate | Boolean | 跳转到本小程序的其他页面时,是否自动暂停本页面的音视频播放,默认为 true |
autoPauseIfOpenNative | Boolean | 跳转到其它微信原生页面时,是否自动暂停本页面的音视频播放,默认为 true |
pictureInPictureMode | string/Array | 设置小窗模式: push, pop,空字符串或通过数组形式设置多种模式(如: ["push", "pop"]);[]: 取消小窗、push: 路由 push 时触发小窗、pop : 路由 pop 时触发小窗 |
referrerPolicy | REFERRERPOLICY | 发送访问来源策略,默认为不发送 |
增加自定义事件
拉流自定义事件的抛出值可参考 微信小程序 live-player 中的说明。
参数 | 类型 | 说明 |
---|---|---|
bindstatechange | Function | 播放状态变化事件 |
bindfullscreenchange | Function | 全屏变化事件 |
bindnetstatus | Function | 网络状态通知 |
bindaudiovolumenotify | Function | 播放音量大小通知 |
bindenterpictureinpicture | Function | 播放器进入小窗 |
bindleavepictureinpicture | Function | 播放器退出小窗 |