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 | 右下。 |