azure-web-pubsub-ts
使用 Azure Web PubSub 構建即時應用程式
使用 Azure Web PubSub SDK 在您的應用程式中實作基於 WebSocket 的即時訊息傳遞。此技能提供生產就緒的模式，用於發布/訂閱訊息、群組管理和 TypeScript 連線處理。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「azure-web-pubsub-ts」。 產生具有使用者 ID 和群組成員資格的用戶端權杖
預期結果:
權杖已產生，URL 為 wss://resource.webpubsub.azure.com/client/access/hubs/chat?access_token=xxx，userId=user123，groups=[chat-room]，roles=[webpubsub.joinLeaveGroup, webpubsub.sendToGroup]
正在使用「azure-web-pubsub-ts」。 傳送訊息至 chat-room 群組中的所有使用者
預期結果:
訊息已成功廣播至群組 chat-room 中的 12 個連線。訊息內容：{type: 'message', data: 'Hello everyone!'}
安全審計
安全This skill contains legitimate Azure Web PubSub SDK documentation. Static analyzer produced 35 false positive external_commands findings by misinterpreting markdown code block backticks as shell execution. Network and environment variable patterns are standard Azure SDK usage. No malicious intent detected.
中風險問題 (1)
低風險問題 (2)
風險因素
🌐 網路存取 (2)
🔑 環境變數 (3)
品質評分
你能建構什麼
即時聊天應用程式
使用 Azure Web PubSub 群組和使用者定向訊息建構多房間聊天系統，支援使用者驗證、群組訊息和上線狀態指示。
即時儀表板更新
使用廣播訊息將即時資料更新推送至已連線的儀表板。非常適合監控系統、分析顯示或即時指標視覺化。
多人遊戲大廳
使用群組和連線管理 API 建立遊戲房間，支援玩家配對、遊戲內訊息和工作階段管理。
試試這些提示
使用環境變數中的連線字串設定 Azure Web PubSub 伺服器端用戶端。建立名為 'chat' 的中樞，並產生基本用戶端存取權杖。
為使用者 'user123' 產生具有加入群組、傳送至群組角色的用戶端存取權杖，並自動加入 'chat-room' 群組。將過期時間設定為 60 分鐘。
建立透過協商端點連線的 WebPubSubClient。為已連線、群組訊息和已中斷事件註冊處理常式。在連線後加入 'chat-room' 群組。
為 'chat' 中樞實作 Express 中介軟體處理常式，包含 handleConnect 驗證、handleUserEvent 處理和 onConnected 記錄。包含為已驗證使用者產生權杖的協商端點。
最佳實務
- 生產環境中使用 DefaultAzureCredential 而非存取金鑰，以獲得更好的安全性
- 在呼叫 client.start() 之前註冊所有事件處理常式，以避免遺漏初始事件
- 在 handleConnect 中驗證驗證，以在交握早期階段拒絕未經授權的連線
避免
- 將連線字串或存取金鑰直接硬編碼在原始碼中，而不是使用環境變數
- 存取 process.env 變數時沒有使用 TypeScript 非空斷言或備援值
- 在驗證用戶端連線狀態為 'connected' 之前就傳送訊息