使用 Azure Web PubSub 为 TypeScript 应用构建实时消息系统

解决实时通信的架构难题：通过集成 Azure Web PubSub SDK，让 AI 帮你快速实现无需维护复杂 WebSocket 服务器的实时消息推送、用户群组管理及事件驱动的通信流。

为什么需要这个技能

构建实时应用（如聊天室、实时通知、协作编辑）时，维护一个可扩展的 WebSocket 服务器极其复杂，需要处理心跳检测、连接状态同步、负载均衡及消息广播等繁琐细节。

Azure Web PubSub 将这些基础设施托管化。通过本技能，你可以让 AI 快速生成服务端管理代码（发送消息、管理权限）和客户端集成代码（接收推送、加入群组），将开发重心从“维持连接”转移到“业务逻辑”上。

适用场景

• 实时聊天应用：实现一对一私信或多人群聊功能。
• 实时通知系统：在用户端实时推送系统告警或状态变更。
• 多玩家同步：在轻量级多人在线游戏中同步状态。
• 协作工具：实现文档实时编辑状态同步或在线状态显示。

核心工作流

1. 服务端管理 (WebPubSubServiceClient)

服务端主要负责权限控制和指令下发。通过 WebPubSubServiceClient，你可以：

• 生成访问令牌：为客户端创建带权限的 accessToken，规定用户可加入的群组及角色。
• 精准推送：支持向所有连接 (sendToAll)、特定用户 (sendToUser) 或特定连接 ID 推送消息。
• 群组管控：动态创建群组并管理成员的加入与退出。

2. 客户端集成 (WebPubSubClient)

客户端通过 WebSocket 连接到 Azure 节点：

• 连接与监听：在 start() 之前注册 connected 和 group-message 等事件处理器。
• 交互发送：通过 sendToGroup 向特定频道发送消息，并可配置 noEcho 避免自身接收重复消息。

3. 事件处理中间件 (Express Handler)

利用 @azure/web-pubsub-express 构建后端 Hook，处理连接请求 (handleConnect) 和自定义用户事件 (handleUserEvent)，实现细粒度的业务拦截和验证。

下载和安装

下载 azure-web-pubsub-ts 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐