举手发言

功能说明

小鱼易连会议控制管理模块提供了举手发言功能，允许参会者在被强制禁言时，通过举手向会议主持人申请发言。主持人可以允许或拒绝发言请求，允许发言的参会者将被解除禁言状态，发言结束后可再次恢复禁言状态。

此功能广泛应用于需要主持人控制发言权限的会议场景。小鱼易连 Web SDK 封装了举手发言相关操作，并结合服务端 API 和终端 SDK 实现完整的业务流程：

参会者申请发言：通过举手请求解除禁言；
主持人同意发言：主持人通过管理界面允许发言；
结束发言：发言结束后，恢复禁言状态；
取消举手：参会者可以在申请发言阶段取消请求；

提示

强制禁言及解除禁言操作需通过服务端 API 或者会控操作界面实现，具体方法请参考服务端 API 文档。

实现方法

通过小鱼易连 Web SDK，参会者和主持人可通过以下步骤实现举手发言功能：

1. 举手发言

参会者调用 onHandUp 方法发起举手申请。此时，参会者端显示取消举手，主持人端显示该参会者的静音图标会变为举手图标，提示主持人有发言申请：

await XYClient.onHandUp();

主持人端效果：

参会者端效果：

2. 主持人允许发言

主持人在会控界面点击参会者的举手图标，同意发言请求，解除该参会者的禁言状态（需通过服务端 API 或者会控界面操作）。

会控操作如下：

3. 发言结束恢复禁言

当发言结束时，参会者可调用

await XYClient.onMute();

参会者端效果：

4. 取消举手请求

如果参会者在举手阶段改变主意，可以调用 onHandDown 方法取消发言申请。主持人端的举手图标会同步消失。

await XYClient.onHandDown();

参会者端效果：

5. 监听取消举手事件

通过监听 cancel-handup 事件，可以捕获主持人通过会控清除举手的操作。

XYClient.on("cancel-handup", (e) => {
  console.log("主持人已取消举手请求", e);
});

示例代码

以下示例展示了完整的举手发言操作流程：

import XYRTC from '@xylink/xy-rtc-sdk';

// 举手发言
document.getElementById("handUp").addEventListener("click", async () => {
  await XYRTCClient.onHandUp();
  console.log("举手申请已发送");
});

// 取消举手
document.getElementById("handDown").addEventListener("click", async () => {
  await XYRTCClient.onHandDown();
  console.log("已取消举手申请");
});

// 结束发言
document.getElementById("mute").addEventListener("click", async () => {
  await XYRTCClient.onMute();
  console.log("发言已结束，恢复静音");
});

// 监听取消举手事件
XYRTCClient.on("cancel-handup", (e) => {
  console.log("主持人已取消举手请求", e);
});

// UI
<button id="handUp">举手发言</button>
<button id="handDown">取消举手</button>
<button id="mute">结束发言</button>

API 参考

方法

事件

2025-01-14 11:19:59

导出PDF文档