推拉流自定义组件
警告
由于微信开发者工具模拟器并不支持 RTMP 协议,所以推拉流组件在模拟器中无法正常显示,建议在真机中查看推拉流组件的效果。
引入推拉流组件配置属性需要的枚举值:
typescript
import {
ORIENTATION,
ASPECT,
LOCALMIRROR,
AUDIOREVERBTYPE,
BEAUTYSTYLE,
FILTER,
OBJECTFIT,
REFERRERPOLICY,
RCAudioOutputDevice,
RCAudioVolumeType
} from '@rongcloud/plugin-wechat-rtc'
提示
以下属性和自定义事件,除拉流组件的 id 属性,其他均为可选配置项,可按业务需求添加。
推流组件
配置属性
html
<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 为必须配置项。
配置属性
html
<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 | 发送访问来源策略,默认为不发送 |