你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
LiveTry 是一种基于浏览器的工具,可帮助你使用 Azure Web PubSub 的实时消息传送功能-无需代码或本地设置。 只需单击几下鼠标,即可使用客户端和服务器端 API 创建客户端、加入组和发送消息。
本指南逐步讲解 LiveTry 中的两种常见消息传送方案,同时帮助你了解 连接、 组和 消息等重要概念。
学习内容
可以探索实时应用程序中经常使用的两种消息传送模式:
- 服务器到组消息传送:使用
sendToGroup
API 将消息广播到组中的所有客户端。 - 客户端到组消息传送:Azure Web PubSub 支持一项功能,允许组中的客户端将消息直接发送到同一组中的其他客户端,而无需通过应用服务器进行路由,从而减少延迟。
重要概念
在开始之前,让我们先快速回顾一下在 LiveTry 中交互的核心 Azure Web PubSub 概念:
- 中心:用于隔离和组织消息传送逻辑的逻辑单元。 客户端始终连接到中心。 使用 LiveTry 时,实际流量将流经该资源。 对于本教程,我们建议指定不与生产流量重叠的测试中心名称。
- 连接:客户端与 Azure Web PubSub 服务之间的持久 WebSocket 连接。
- 组:服务器托管的连接子集。 发送到组的消息只传送到组内的连接。
- 消息:客户端和服务之间交换的载荷。 消息可以广播到所有用户、针对组或定向到单个连接。
方案 1:将消息从服务器发送到组
在此方案中,你将使用 sendToGroup
REST API 模拟服务器端广播。 此方案演示服务如何将消息从后端路由到指定组中的所有客户端。
步骤
- 在 Azure 门户中,进入您的 Azure Web PubSub 资源。
- 打开“LiveTry”边栏选项卡。
- 单击“ + 添加客户端 ”以创建多个连接。
- 将每个客户端分配到一个组(例如,
group1
)。 - 在“发布消息”部分的“ 服务器 ”选项卡下,选择“ 发送到”组。
- 输入组名称(
group1
)、示例消息并调用sendToGroup
API。 - 切换到 “客户端 ”选项卡,观察消息显示在每个客户端的消息日志中。
正在学习的内容
使用 RESTful API 将消息发送到一组客户端。 LiveTry 演示了服务器到组通信的工作原理,而无需部署后端。 Azure Web PubSub 还提供适用于 C#、JavaScript、Java 和 Python 的服务器 SDK。
若要直观展示消息广播过程,请尝试对多个客户端重复这些步骤。 LiveTry 最多支持五个并发模拟客户端。
方案 2:从客户端向组发送消息
在此方案中,你将创建一个客户端,将消息发送到同一组中的其他客户端,类似于用户在聊天室中发布消息。
步骤
- 在 LiveTry 中,添加两个或多个客户端,并为字段指定相同的值
Initial Groups
。 - 对于发送消息的客户端,请选择 “允许客户端发送到所有组”。
- 切换到该客户端的面板,指定组名称,输入消息,然后单击“ 调用”。
- 组中的其他客户端实时接收消息。
正在学习的内容
此方案展示了 客户端到组消息传送,这在服务器往返引入不必要的延迟的应用程序中很理想。 它是 Web PubSub 客户端发布/订阅模型的核心部分。
小窍门
打开多个浏览器选项卡以模拟多个用户或设备。
尝试合并更多操作,例如 joinGroup
,leaveGroup
,或 sendToConnection
。
使用明确的组名称来更好地组织试验。