跳到主要内容

推拉流自定义组件

由于微信开发者工具模拟器并不支持 rtmp 协议,所以推拉流组件在模拟器中无法正常显示,建议在真机中查看推拉流组件的效果。

引入推拉流组件配置属性需要的枚举值:

import {
ORIENTATION,
ASPECT,
LOCALMIRROR,
AUDIOREVERBTYPE,
BEAUTYSTYLE,
FILTER,
OBJECTFIT,
REFERRERPOLICY,
RCAudioOutputDevice,
RCAudioVolumeType
} from '@rongcloud/plugin-wechat-rtc'
提示

以下属性和自定义事件,除拉流组件的 id 属性,其他均为可选配置项,可按业务需求添加。

推流组件

配置属性

<rc-livepusher style="{{style}}"></rc-livepusher>
参数类型说明
styleString组件样式,默认样式为 width:100%;height:100px,可以传入配置样式修改
minBitrateNumber最小码率,默认为 200
maxBitrateNumber最大码率,默认为 1000
audioVolumeTypeRCAudioVolumeType音量类型,包括:自动、媒体音量、通话音量,默认为 RCAudioVolumeType.AUTO,即自动
beautyNumber美颜,取值范围为 0-9,默认为 0,代表关闭
whitenessNumber美白,取值范围为 0-9,默认为 0,代表关闭
autoFocusBoolean是否自动聚焦,默认为 true
orientationORIENTATION画面方向,默认为 ORIENTATION.VERTICAL,即竖直
aspectASPECT宽高比,默认为 ASPECT.NINEDIVIDESIXTEEN,即 9/16
waitingImageString进入后台时推流的等待画面
zoomBoolean调整焦距,默认为 false
remoteMirrorBoolean设置推流画面是否镜像,产生的效果在 live-player 反应到,默认为 false
localMirrorLOCALMIRROR控制本地预览画面是否镜像,默认为 LOCALMIRROR.AUTO,即前置摄像头镜像,后置摄像头不镜像
audioReverbTypeAUDIOREVERBTYPE音频混响类型,默认为 AUDIOREVERBTYPE.CLOSE,代表关闭
enableAgcBoolean是否开启音频自动增益,默认为 false
enableAnsBoolean是否开启音频噪声抑制,默认为 false
videoWidthNumber上推的视频流的分辨率宽度,默认为 360
videoHeightNumber上推的视频流的分辨率高度,默认为 640
beautyStyleBEAUTYSTYLE美颜类型,默认为 BEAUTYSTYLE.SMOOTH,代表光滑
filterFILTER色彩滤镜,默认为 FILTER.STANDARD,即标准

增加自定义事件

推流自定义事件的抛出值可参考 微信小程序 live-pusher 中的说明

参数类型说明
bindstatechangeFunction状态变化事件
bindnetstatusFunction网络状态通知
binderrorFunction渲染错误事件
bindbgmstartFunction背景音开始播放时触发
bindbgmprogressFunction背景音进度变化时触发
bindbgmcompleteFunction背景音播放完成时触发
bindaudiovolumenotifyFunction麦克风采集的音量大小通知

拉流组件

每个 stream 对应一个拉流组件,订阅多个 stream 时,需引入多个拉流组件并传入 id。id 为房间内其他人发布的资源 stream 的唯一标识,可通过 stream.getMsid() 获取。id 为必须配置项

配置属性

<rc-liveplayer id="{{id}}"></rc-liveplayer>
参数类型说明
idString播放组件 id
styleString组件样式,默认样式为 width:100%;height:100px,可以传入配置样式修改
mutedBoolean是否静音,默认为 false
objectFitOBJECTFIT填充模式,视频短边被填充为黑色或裁剪视频长边,默认为:视频短边被填充为黑色
orientationORIENTATION画面方向,竖直或水平,默认为竖直
autoPauseIfNavigateBoolean跳转到本小程序的其他页面时,是否自动暂停本页面的音视频播放,默认为 true
autoPauseIfOpenNativeBoolean跳转到其它微信原生页面时,是否自动暂停本页面的音视频播放,默认为 true
pictureInPictureModestring/Array设置小窗模式: push, pop,空字符串或通过数组形式设置多种模式(如: ["push", "pop"]);[]: 取消小窗、push: 路由 push 时触发小窗、pop : 路由 pop 时触发小窗
referrerPolicyREFERRERPOLICY发送访问来源策略,默认为不发送

增加自定义事件

拉流自定义事件的抛出值可参考 微信小程序 live-player 中的说明

参数类型说明
bindstatechangeFunction播放状态变化事件
bindfullscreenchangeFunction全屏变化事件
bindnetstatusFunction网络状态通知
bindaudiovolumenotifyFunction播放音量大小通知
bindenterpictureinpictureFunction播放器进入小窗
bindleavepictureinpictureFunction播放器退出小窗