组件
组件说明
组件由多个模块组成, 主要模块包括:音频拉流组件,音视频推流组件, 媒体拉流组件,用户自定义组件。 通过集成SDK的相关控件, 让使用者进行更加快速, 高效的开发工作。开发者使用组件存在原生组件限制,请参考小程序原生组件说明
使用流程:
- 假如您的项目是如下结构
─ meetingDemo // 云会议Demo-meeting演示
├─ pages // 项目页面
│ ├─ chat // 聊天页面
│ ├─ login // 首页,登录页面
│ ├─ meeting // 视频会议页面
│ ├─ option // 选项页面
│ └─ setting // 设置页面
│
└─ utils
└─ RTCSDK // 导入SDK目录到项目中
├─ component
│ ├─ RTCAudioPlayer // 音频拉流组件(房间内所有声音由该组件输出)
│ ├─ RTCVideoPlayer // 媒体拉流组件(播放远端视频,屏幕共享,影音共享)
│ ├─ RTCVideoPusher // 视频推流组件(用于将本端的音视频推向服务端)
│ └─ RTCScreenMarkV4 // 屏幕共享标注组件(观看屏幕共享标注功能)
│
└─ RTC_Miniapp_SDK.min.js // SDK文件
- 在(/pages/meeting/meeting.json)中引入相关组件
// 可根据业务需求选择需要的组件
{
"usingComponents": {
"RTCVideoPlayer": "/utils/RTCSDK/components/RTCVideoPlayer/RTCVideoPlayer",
"RTCVideoPusher": "/utils/RTCSDK/components/RTCVideoPusher/RTCVideoPusher",
"RTCAudioPlayer": "/utils/RTCSDK/components/RTCAudioPlayer/RTCAudioPlayer",
"RTCScreenMarkV4": "/utils/RTCSDK/components/RTCScreenMarkV4/RTCScreenMarkV4",
}
}
- 在wxml需要的地方添加以下代码
<!-- 音频播放组件 -->
<RTCAudioPlayer config='{{RTCAudioPlayer}}' debug='{{false}}'></RTCAudioPlayer>
<!-- 音视频推流组件 -->
<RTCVideoPusher config='{{RTCVideoPusherConfig}}' debug='{{false}}' extend='{{RTCVideoPusherExtend}}'>
<!-- 这里是组件插槽,可显示昵称等个性化内容 -->
<view class='nickname'>自己的昵称</view>
</RTCVideoPusher>
<!-- 视频播放组件 -->
<RTCVideoPlayer config='{{RTCVideoPlayerConfig}}' debug='{{false}}' extend='{{RTCVideoPlayerExtend}}'>
<!-- 这里是组件插槽,可显示昵称等个性化内容 -->
<view class='nickname'>别人的昵称</view>
</RTCVideoPlayer>
- 在JS中控制属性值
//以下操作需要进入房间成功后操作
//---------------------音频操作---------------------
const RTCAudioPlayerConfig = {
soundMode: 'speaker', // 声音输出方式,有效值为 speaker(扬声器)、ear(听筒)
autoPauseIfNavigate: false, // 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
autoPauseIfOpenNative: false, // 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放
}
this.setData({ RTCAudioPlayerConfig });
//---------------------音视频推流组件---------------------
const RTCVideoPusherConfig = {
orientation: 'vertical', // vertical,horizontal,
aspect: '3:4', // 宽高比,可选值有 3:4, 9:16
beauty: 5, // 美颜,取值范围 0-9 ,0 表示关闭
whiteness: 5, // 美白,取值范围 0-9 ,0 表示关闭
devicePosition: 'front', // 前置或后置,值为front, back,此属性不支持动态修改,如需切换摄像头请调用api
muted: false, // 默认静音
enableCamera: true, // 默认打开摄像头
localMirror: 'auto', // 控制本地预览画面是否镜像,"auto"(默认值,前置摄像头镜像,后置摄像头不镜像)、"enable"(前后置摄像头均镜像)、"disable"(前后置摄像头均不镜像)
remoteMirror: false, // 设置推流的画面是否镜像
minBitrate: 100, // 最小码率
maxBitrate: 800, // 最大码率
waitingImage: 'http://sdk.cloudroom.com/pages/imgs/cr_meeting/be_closed.jpg', // 进入后台时推流的等待画面
}
this.setData({ RTCVideoPusherConfig }); //渲染字段
//---------------------媒体拉流组件---------------------
const RTCVideoPlayerConfig = {
userId: "remote_userID", //假设已知对端的userID
camId: -1, //观看的摄像头ID,-1是观看默认摄像头
type: 'video', // 媒体类型,可取值 video,screen,media
orientation: 'vertical', // 画面方向,可选值有 vertical,horizontal
objectFit: 'fillCrop', // 填充模式,可选值有 contain,fillCrop
autoPauseIfNavigate: true, // 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
autoPauseIfOpenNative: true, // 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放
}
this.setData({ RTCVideoPlayerConfig }); //渲染字段
- 以上已经配置了一个简单并且可正常渲染出本端视频,房间音频以及远端视频的配置,更详细可参考下方文档说明。
音频拉流组件
<RTCAudioPlayer>
音频拉流组件集成了房间内的声音,他人视频,屏幕共享,媒体共享的声音都需要引入该组件输出
wxml属性:
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| config | 是 | object | 音频配置对象,参考下方 |
| debug | 否 | boolean | 开启调式需要父盒子有足够大小高宽用于渲染组件 |
| bindstatechange | 否 | function | 监听live-player组件的statechange事件,在参数event.detail中包含播放状态 |
| bindnetstatus | 否 | function | 监听live-player组件的netstatus事件,在参数event.detail中包含网络状态 |
音频配置对象:
| 参数 | 动态改变 | 类型 | 说明 |
|---|---|---|---|
| soundMode | 支持 | string | speaker(默认),ear,扬声器输出或者听筒输出 |
| autoPauseIfNavigate | 支持 | boolean | 默认值false,当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放 |
| autoPauseIfOpenNative | 支持 | boolean | 默认值true,当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放 |
实现动态改变推荐使用:
this.setData('RTCAudioPlayerConfig.soundMode': 'ear'); //更改声音为听筒输出
音视频推流组件
<RTCVideoPusher>
音视频推流组件是将自己的视频画面、麦克风声音上送给服务器的组件。开发者需要注意的是如果客户端关闭了麦克风、摄像头权限会通过API形式回调给业务,由业务处理
wxml属性:
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| config | 是 | object | 推流配置对象,参考下方 |
| debug | 否 | boolean | 开启调式 |
| bindaudiovolumenotify | 否 | function | 监听live-pusher组件的bindaudiovolumenotify事件,返回麦克风采集的音量大小 |
| bindstatechange | 否 | function | 监听live-pusher组件的statechange事件,在参数event.detail中包含状态变化 |
| bindnetstatus | 否 | function | 监听live-pusher组件的netstatus事件,在参数event.detail中包含网络状态 |
| binderror | 否 | function | 监听live-pusher组件的error事件,在参数event.detail中包含渲染错误信息 |
推流配置对象:
| 参数 | 动态改变 | 类型 | 说明 |
|---|---|---|---|
| orientation | 支持 | string | 画面方向,可选值: "vertical"(默认)、"horizontal" |
| aspect | 支持 | string | 宽高比,可选值有"3:4"(默认),"9:16" |
| beauty | 支持 | number | 美颜,取值范围 0-9 ,0 表示关闭 ,默认值5 |
| whiteness | 支持 | number | 美白,取值范围 0-9 ,0 表示关闭 ,默认值5 |
| devicePosition | 不支持 | string | 初始化使用前置或后置摄像头,值为"front"(默认), "back",如需切换摄像头请调用API |
| minBitrate | 支持 | number | 最小码率,100的倍数,默认值100 |
| maxBitrate | 支持 | number | 最大码率,100的倍数,默认值800 |
| audioVolumeType | 支持 | string | "media"(默认)媒体音量、"voicecall"(通话音量),此修改将影响全局的音量设置 |
| waitingImage | 支持 | string | 进入后台时推流的等待画面,填入完整URL或者绝对地址 |
| localMirror | 支持 | string | 控制本地预览画面是否镜像,可选值:"auto"(默认值,前置摄像头镜像,后置摄像头不镜像)、"enable"(前后置摄像头均镜像)、"disable"(前后置摄像头均不镜像) |
| remoteMirror | 支持 | boolean | 设置推流画面是否镜像,默认值false |
| zIndex | 支持 | number | 层级属性,2.9.3以上小程序基础库支持 |
| enableCamera | 不支持 | boolean | 打开摄像头,如需开关摄像头请调用API,默认值true |
| muted | 不支持 | boolean | 是否静音,如需开关麦克风请调用API,默认值false |
实现动态改变推荐使用:
this.setData('RTCVideoPusherConfig.beauty': 0); //只改变对象某一属性,关闭美颜效果
this.setData('RTCVideoPusherConfig.whiteness': 0); //只改变对象某一属性,关闭美白效果
组件方法:
snapshot(quality,returnBase64)
- 功能: 拍照
- 参数:
- quality ---- 图片的质量,默认原图,基础库 2.10.0 开始支持。有效值为 raw、compressed
- returnBase64 ---- 是否在结果中返回base64数据(boolean)
- 返回值: Promise对象
媒体拉流组件
<RTCVideoPlayer>
媒体拉流组件是将他人视频、屏幕共享、影音共享UI显示组件,开发者需要注意原生组件限制。
wxml属性:
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| config | 是 | object | 媒体拉流配置对象,参考下方 |
| debug | 否 | boolean | 开启调式 |
| bindstatechange | 否 | function | 监听live-player组件的statechange事件,在参数event.detail中包含userId、type及播放状态 |
| bindnetstatus | 否 | function | 监听live-player组件的netstatus事件,在参数event.detail中包含userId、type及网络状态 |
| userInfo | 否 | object | 已废弃,可在config中传入userId |
媒体拉流配置对象:
| 参数 | 动态改变 | 类型 | 说明 |
|---|---|---|---|
| type | 支持 | string | 媒体类型,可取值 "video"(默认),"screen","media" |
| userId | 支持 | string | 观看用户的userId |
| camId | 支持 | number | 观看用户的某个摄像头。默认值-1,观看用户的默认摄像头。媒体类型为 "video" 时有效。 |
| orientation | 支持 | string | 画面方向,可选值: "vertical"(默认)、"horizontal" |
| objectFit | 支持 | string | 填充模式,可选值有 "fillCrop"(默认)、"contain" |
| autoPauseIfNavigate | 支持 | boolean | 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放,默认值false |
| autoPauseIfOpenNative | 支持 | boolean | 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放,默认值true |
| zIndex | 支持 | number | 层级属性,2.9.3以上小程序基础库支持 |
组件方法:
snapshot(quality,returnBase64)
- 功能: 拍照
- 参数:
- quality ---- 图片的质量,默认原图,基础库 2.10.0 开始支持。有效值为 raw、compressed
- returnBase64 ---- 是否在结果中返回base64数据(boolean)
- 返回值: Promise对象
屏幕共享标注组件
<RTCScreenMarkV4>
屏幕共享标注组件需要房间内已开启了屏幕共享并且源端开启了屏幕共享标注才会正常工作的组件,用于观看其他端的画笔标注
开发者需要注意以下事项:
- 当前组件仅支持观看其他端绘制画笔。
- 由于覆盖在原生组件之上,请您务必阅读小程序原生组件说明
- 部分机型首次渲染画笔慢是小程序提供的截图能力缓慢,并不是SDK造成的。
wxml属性:
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| config | 是 | object | 与RTCVideoPlayer组件的config属性保持一致 |