Config
ZegoUIKitPrebuiltCallConfig
通话配置类
属性 | 类型 | 描述 |
---|---|---|
turnOnCameraWhenJoining | Bool | 默认是否启用摄像头,默认值为 true。 |
turnOnMicrophoneWhenJoining | Bool | 默认是否启用麦克风,默认值为 true。 |
useSpeakerWhenJoining | Bool | 默认是否启用扬声器,默认值为 true。 |
audioVideoViewConfig | ZegoAudioVideoViewConfig | 音频和视频视图的配置。如麦克风和摄像头状态图标、是否显示用户名、声浪效果和视频显示模式。 |
layout | ZegoLayout | 配置通话页面音视频窗口的显示布局,包括画中画布局局。 |
bottomMenuBarConfig | ZegoBottomMenuBarConfig | 通话页面底部栏的配置参数,如底部的栏按钮、按钮数量限制、是否自动隐藏、点击其他区域是否隐藏以及颜色风格。 |
hangUpConfirmInfo | ZegoHangUpConfirmInfo | 点击挂断按钮时,是否显示离开房间的对话框信息。如果没有设置,则不显示,反之亦然。 |
videoConfig | ZegoPrebuiltVideoConfig | 视频分辨率配置,默认值为 ZegoPrebuiltVideoConfig(resolution: ZegoPresetResolution.Preset360p)。 |
durationConfig | ZegoCallDurationConfig | 通话时长配置,可显示或隐藏时时长统计,以及设置时长回调。 |
ZegoAudioVideoViewConfig
视图配置类
属性 | 类型 | 描述 |
---|---|---|
showMicrophoneStateOnView | Bool | 是否在视频通话页面展示麦克风状态的图标。默认值为 true。 |
showCameraStateOnView | Bool | 是否在视频通话页面展示摄像头状态的图标。默认值为 true。 |
showUserNameOnView | Bool | 是否在视频通话页面展示用户名称。默认值为 true。 |
showSoundWavesInAudioMode | Bool | 在语音通话模式下,是否在用户头像周围显示声浪。默认值为 true。 |
useVideoViewAspectFill | Bool | 是否以等比例填充模式(黑边模式)显示视频。默认值为 true。 |
ZegoBottomMenuBarConfig
底部菜单栏配置类
属性 | 类型 | 描述 |
---|---|---|
buttons | [ZegoMenuBarButtonName] | 需要在菜单栏上显示的按钮,按照数组的顺序显示。默认值为 [ToggleCameraButton, SwitchCameraButton, HangUpButton, ToggleMicrophoneButton, SwitchAudioOutputButton]。 |
maxCount | Int | 可以显示的按钮的最大数量,最多为 5 个。如果超过这个值,则会显示“更多”按钮。注意,这个值包含了“更多”按钮。 |
hideAutomatically | Bool | 5 秒内没有操作屏幕,或者用户点击屏幕非响应区域的位置,底部菜单栏是否会自动收起。默认值为 true。 |
hideByClick | Bool | 用户是否可以点击屏幕非响应区域的位置,收起菜单栏。默认值为 true。 |
ZegoPrebuiltVideoConfig
视频分辨率配置类
属性 | 类型 | 描述 |
---|---|---|
resolution | ZegoPresetResolution | 自定义视频分辨率。默认为 Preset360p。 |
config | ZegoVideoConfig | 详细的视频参数配置,可选,如果配置了该参数,则忽略 resolution 。 |
ZegoLayout
通话页面布局类
属性 | 类型 | 描述 |
---|---|---|
mode | ZegoUIKitLayoutMode | 通话页面音视频窗口显示样式,包括画中画布局、宫格布局。 |
config | ZegoLayoutConfig | UI 布局配置。 |
ZegoLayoutConfig
通话页面布局配置类。目前只支持ZegoLayoutPictureInPictureConfig一种布局模式。
ZegoLayoutPictureInPictureConfig
画中画布局配置类
属性 | 类型 | 描述 |
---|---|---|
smallViewBackgroundColor | String | 小视图的背景颜色。默认为 #333437 。 |
largeViewBackgroundColor | String | 大视图的背景颜色。默认为 #4A4B4D 。 |
smallViewBackgroundImage | String | 小视图的背景图片。默认为 null 。 |
largeViewBackgroundImage | String | 大视图的背景图片。默认为 null 。 |
smallViewPostion | ZegoViewPosition | 小视图在 UI 上的位置。默认为 TopRight 。 |
switchLargeOrSmallViewByClick | Bool | 大小视图是否可以点击切换。默认为 true 。 |
smallViewSize | Object | 小视图的大小。默认为 { width: 85, height: 151 } 。 |
spacingBetweenSmallViews | Int | 小视图之间的间距。默认为 8 。 |
removeViewWhenAudioVideoUnavailable | Bool | 当音频和视频不可用的时候是否移除 view。默认为 true 。 |
ZegoCallDurationConfig
通话时长配置类
属性 | 类型 | 描述 |
---|---|---|
showDuration | boolean | 是否显示通话时间时长,默认值为 true。 |
onDurationUpdate | (seconds: number) => void | 通话时长更新的回调。每隔 1s 触发一次,不建议运行耗时任务。 |
ZegoHangUpConfirmInfo
离开通话确认对话框信息配置类
属性 | 类型 | 描述 |
---|---|---|
title | String | 标题文本。 |
message | String | 确认消息文本。 |
cancelButtonName | String | 取消按钮文本。 |
confirmButtonName | String | 确认按钮文本。 |
ZegoLayoutMode
通话页面布局模式枚举类
枚举 | 描述 |
---|---|
PictureInPicture | 画中画布局。 |
ZegoMenuBarButtonName
菜单栏按钮名称枚举类
枚举 | 描述 |
---|---|
HangUpButton | 挂断按钮。 |
ToggleCameraButton | 摄像头开关按钮。 |
ToggleMicrophoneButton | 麦克风开关按钮。 |
SwitchCameraButton | 前后摄像头切换按钮。 |
SwitchAudioOutputButton | 音频外放切换按钮。 |
ZegoPresetResolution
视频分辨率枚举类
枚举 | 描述 |
---|---|
Preset180p | 180P。 |
Preset270p | 270P。 |
Preset360p | 360P。 |
Preset540p | 540P。 |
Preset720p | 720P。 |
Preset1080p | 1080P。 |
ZegoViewPosition
视图位置类
枚举 | 描述 |
---|---|
TopLeft | 左上。 |
TopRight | 右上。 |
BottomLeft | 左下。 |
BottomRight | 右下。 |