跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

舞台管理

最后更新 查看 MarkdownAgent 设置

本指南介绍如何在 Cloudflare RealtimeKit 中针对网络研讨会 (WebRTC) 用例使用舞台管理 API。

传统发布-订阅模型允许用户发布媒体并让其他人选择订阅,而 RealtimeKit 则提供可选的托管配置。在此配置中,可以将权限较低的用户默认设为不发布媒体。用户随后可以请求发布媒体的权限,由特权用户选择授予或拒绝访问。

使用 RealtimeKit 的舞台管理 API,用户可以执行以下操作:

  • 离开和加入舞台
  • 管理舞台请求和权限
  • 移除参与者

访问舞台 API

可以在 meeting.stage 命名空间下访问舞台模块。

属性

状态

meeting.stage.status 属性返回本地用户当前的舞台状态。

可能的状态值:

  • ON_STAGE - 用户当前在舞台上,并共享音频和视频。
  • OFF_STAGE - 用户正在观看会话,但不在舞台上,也不共享音频或视频。
  • REQUESTED_TO_JOIN_STAGE - 用户有一个待处理的加入舞台并共享音频和视频的请求。此状态会保持到主持人接受或拒绝请求。
  • ACCEPTED_TO_JOIN_STAGE - 主持人已接受用户加入舞台的请求。

主持人控制

RealtimeKit 的舞台管理 API 允许主持人接收和管理舞台请求,以及离开和加入舞台。

加入舞台

此方法将用户连接到媒体室,使其能够与会议中的其他对等方互动。

离开舞台

使用此方法后,用户将与媒体室断开连接,无法再与其他对等方通信。此外,房间中的其他人也将无法再看到其音频和视频。

授予访问权限

特权用户可以使用 grantAccess 方法为一组用户授予舞台访问权限。

参数:

拒绝访问

特权用户可以使用 denyAccess 方法拒绝一组用户访问舞台。

参数:

移除用户

特权用户可以使用 kick 方法从舞台移除一组用户。

参数:

参与者控制

RealtimeKit 的舞台管理 API 允许参与者请求和管理舞台访问权限。

请求访问

此方法用于创建可由主持人批准的新舞台请求。每个用户(观众或主持人)都必须调用此方法才能加入舞台。

主持人调用此方法时,其状态将更新为 ACCEPTED_TO_JOIN_STAGE。

取消访问请求

可以调用此方法取消舞台请求。

事件

meeting.stage 模块发出以下事件:

舞台访问请求已更新

舞台访问请求有更新时发出。

舞台访问请求已接受

主持人接受加入舞台请求或直接邀请用户上台时发出。

舞台状态已更新

本地用户的舞台状态更改时发出。

新舞台请求

新参与者请求加入舞台时发出。

舞台请求已批准

主持人批准舞台请求时发出。

舞台请求已拒绝

主持人拒绝舞台请求时发出。

这篇文档对您有帮助吗?