更新时间:2024-07-30 GMT+08:00

底部工具栏定制

meetingToolBarItemsForScene

接口描述

该接口用于构建底部toolbar的会控全量菜单。

下图中1区域内支持调整按钮展示顺序或者隐藏按钮。

下图中2区域支持最多8个按钮,多余按钮将不会展示。

下图中3区域按钮仅支持隐藏/显示。

图1 视频会议会控菜单定制位置

注意事项

1、返回的全量数组中,如果隐藏某个区域的按钮,需使用空数组( @[ ] )占位;

2、传入的按钮如果当前场景不支持或当前角色不支持将不会被展示(如普通与会者角色将不会展示邀请功能。)

方法定义

1
- (nullable NSArray <NSArray <HWMToolBarItemModel *> *> *)meetingToolBarItemsForScene:(HWMConfToolBarScene)scene;

参数描述

scene 为需要定制底部工具栏的场景,各场景对应取值如下:

语音会议 : HWMConfToolBarSceneAudioConf;

视频会议 : HWMConfToolBarSceneVideoConf.

返回值

示例代码

以视频会议为例:

以下代码隐藏了视频按钮,并添加自定义按钮。效果如图1所示。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
- (nullable NSArray <NSArray <HWMToolBarItemModel *> *> *)meetingToolBarItemsForScene:(HWMConfToolBarScene)scene {
    // 构建视频会议底部工具栏按钮
    if (scene == HWMConfToolBarSceneVideoConf) {
        // 麦克风
        HWMToolBarItemModel *micItem = [HWMToolBarItemModel defaultMicrophoneItem];
        // 扬声器
        HWMToolBarItemModel *speakerItem = [HWMToolBarItemModel defaultSpeakerItem];
        // 与会者
        HWMToolBarItemModel *participantItem = [HWMToolBarItemModel defaultParticipantItem];
        // 共享
        HWMToolBarItemModel *shareItem = [HWMToolBarItemModel defaultDataShareItem];
        // 聊天
        HWMToolBarItemModel *chatItem = [HWMToolBarItemModel defaultChatItem];
        // 自定义
        HWMToolBarItemModel *customItem = [[HWMToolBarItemModel alloc]init];
        customItem.title = @"自定义";
        customItem.selectedTitle = @"选中自定义";
        customItem.iconImage = [NSImage imageNamed:@"icon-customize-select-normal"];
        customItem.selectedIconImage = [NSImage imageNamed:@"icon-customize-select-selected"];
        customItem.disabledIconImage = [NSImage imageNamed:@"icon-customize-select-normal"];
        // 更多
        HWMToolBarItemModel *moreItem = [HWMToolBarItemModel defaultMoreItem];
        // 离开
        HWMToolBarItemModel *leaveItem = [HWMToolBarItemModel defaultLeaveItem];
        
        // 左边区域
        NSArray *leadingArray = @[micItem, speakerItem];
        // 中间区域
        NSArray *centerArray = @[participantItem, shareItem, chatItem, customItem, moreItem];
        // 右边区域
        NSArray *trailingArray = @[leaveItem];

        // 返回全量数组 需要隐藏某个区域全部按钮时 需使用空数组(@[ ])占位
        return @[leadingArray, centerArray, trailingArray];
    }
    return nil;
}