# void setUIConfig(Object config)

设置插件通话界面,需保证在通话开始前设置

# 参数

# Object req

属性 类型 默认值 必填 说明 最低版本
btnText string 接听页面按钮文案,与使用setCustomBtnText 一致
callerUI UIConfig caller 通话 UI 设置
listenerUI UIConfig listener 通话 UI 设置
handsFree boolean true 是否开启免提(true 为扬声器输出,false 为听筒输出)。
仅在设备端生效
插件 2.3.0,WMPF >= 2.0
isSelfWindowMax boolean false 视频通话时,控制主窗口默认是否显示本端。(true 为本端,false 为对端) 2.3.4
customBoxHeight string '90vh' 接听页自定义按钮点击后弹层高度。仅支持 70vh 或 90vh。 2.3.10

UIConfig

属性 类型 默认值 必填 说明 最低版本
cameraRotation number 0 视频画面旋转角度,有效值为 0, 90, 180, 270
aspectRatio number 4/3 视频画面画面纵横比,使用方法见示例
horMirror boolean false 视频画面水平镜像
vertMirror boolean false 视频画面垂直镜像
enableToggleCamera boolean true 视频通话是否支持切换摄像头。false 时不显示切换摄像头按钮。
仅在手机微信内生效。WMPF 默认开摄像头,且不显示开关按钮。
objectFit string 'fill' 视频画面与容器比例不一致时的表现形式。支持 fill/contain,使用方法见示例 2.3.8

aspectRatio 与 objectFit 的设置示例:

# 返回值

# 示例代码

const wmpfVoip = requirePlugin('wmpf-voip').default

wmpfVoip.setUIConfig({
  btnText: '去开门',
  callerUI: {
    aspectRatio: 16 / 9,
  },
  handsFree: false,
})