你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 LiveTry 浏览 Azure Web PubSub 功能

LiveTry 是一种基于浏览器的工具,可帮助你使用 Azure Web PubSub 的实时消息传送功能-无需代码或本地设置。 只需单击几下鼠标,即可使用客户端和服务器端 API 创建客户端、加入组和发送消息。

本指南逐步讲解 LiveTry 中的两种常见消息传送方案,同时帮助你了解 连接消息等重要概念。

学习内容

可以探索实时应用程序中经常使用的两种消息传送模式:

  • 服务器到组消息传送:使用 sendToGroup API 将消息广播到组中的所有客户端。
  • 客户端到组消息传送:Azure Web PubSub 支持一项功能,允许组中的客户端将消息直接发送到同一组中的其他客户端,而无需通过应用服务器进行路由,从而减少延迟。

重要概念

在开始之前,让我们先快速回顾一下在 LiveTry 中交互的核心 Azure Web PubSub 概念:

  • 中心:用于隔离和组织消息传送逻辑的逻辑单元。 客户端始终连接到中心。 使用 LiveTry 时,实际流量将流经该资源。 对于本教程,我们建议指定不与生产流量重叠的测试中心名称。
  • 连接:客户端与 Azure Web PubSub 服务之间的持久 WebSocket 连接。
  • :服务器托管的连接子集。 发送到组的消息只传送到组内的连接。
  • 消息:客户端和服务之间交换的载荷。 消息可以广播到所有用户、针对组或定向到单个连接。

方案 1:将消息从服务器发送到组

在此方案中,你将使用 sendToGroup REST API 模拟服务器端广播。 此方案演示服务如何将消息从后端路由到指定组中的所有客户端。

步骤

  1. 在 Azure 门户中,进入您的 Azure Web PubSub 资源。
  2. 打开“LiveTry”边栏选项卡
  3. 单击“ + 添加客户端 ”以创建多个连接。
  4. 将每个客户端分配到一个组(例如, group1)。
  5. 在“发布消息”部分的“ 服务器 ”选项卡下,选择“ 发送到”组
  6. 输入组名称(group1)、示例消息并调用 sendToGroup API。
  7. 切换到 “客户端 ”选项卡,观察消息显示在每个客户端的消息日志中。

正在学习的内容

使用 RESTful API 将消息发送到一组客户端。 LiveTry 演示了服务器到组通信的工作原理,而无需部署后端。 Azure Web PubSub 还提供适用于 C#、JavaScript、Java 和 Python 的服务器 SDK。

若要直观展示消息广播过程,请尝试对多个客户端重复这些步骤。 LiveTry 最多支持五个并发模拟客户端。

方案 2:从客户端向组发送消息

在此方案中,你将创建一个客户端,将消息发送到同一组中的其他客户端,类似于用户在聊天室中发布消息。

步骤

  1. LiveTry 中,添加两个或多个客户端,并为字段指定相同的值 Initial Groups
  2. 对于发送消息的客户端,请选择 “允许客户端发送到所有组”。
  3. 切换到该客户端的面板,指定组名称,输入消息,然后单击“ 调用”。
  4. 组中的其他客户端实时接收消息。

正在学习的内容

此方案展示了 客户端到组消息传送,这在服务器往返引入不必要的延迟的应用程序中很理想。 它是 Web PubSub 客户端发布/订阅模型的核心部分。

小窍门

打开多个浏览器选项卡以模拟多个用户或设备。 尝试合并更多操作,例如 joinGroupleaveGroup,或 sendToConnection。 使用明确的组名称来更好地组织试验。

后续步骤

  • 详细了解 Azure Web PubSub 中的关键概念
  • 若要生成本地示例,请按照 快速入门指南进行作
  • 在使用 Azure Web PubSub 进行开发时,浏览“操作指南”下的常见任务指南。