這組文章說明如何使用 Azure Functions 中的 Azure Web PubSub 系結，向聯機到 Azure Web PubSub 的用戶端驗證、傳送實時訊息。
| 動作 | 類型 |
|---|---|
| 處理來自 Web PubSub 的用戶端事件 | 觸發程序繫結 |
| 使用 HTTP 觸發程式處理來自 Web PubSub 的用戶端事件，或傳回用戶端存取 URL 和令牌 | 輸入繫結 |
| 叫用服務 API | 輸出繫結 |
安裝擴充功能
您安裝的延伸模組 NuGet 套件取決於您在函式應用程式中使用的 C# 模式：
函式會在隔離的 C# 背景工作進程中執行。 若要深入瞭解，請參閱 在隔離背景工作程序中執行 C# Azure Functions 的指南。
藉由安裝此 NuGet 套件，將擴充功能新增至您的專案。
安裝搭售方案
若要能夠在應用程式中使用這個繫結延伸模組，請確定專案根目錄中的 host.json 檔案包含下列 extensionBundle 參考：
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.0.0, 5.0.0)"
}
}
在此範例中， version 的 [4.0.0, 5.0.0) 值指示 Functions 主機使用至少 4.0.0 但小於 5.0.0的套件版本，其中包括 4.x 的所有潛在版本。 此表示法可有效地在 v4.x 擴充功能套件組合的最新可用次要版本上維護您的應用程式。
可能的話，您應該使用最新的延伸套件組合主要版本，並允許執行階段自動維護最新的次要版本。 您可以在 延伸套件組合發行頁面上檢視最新套件組合的內容。 如需詳細資訊，請參閱 Azure Functions 延伸模組套件組合。
注意
目前尚不支援 Java 的 Web PubSub 延伸模組。
重要概念
(1)-(2) WebPubSubConnection 輸入與 HttpTrigger 繫結，以產生用戶端連線。
(3)-(4) WebPubSubTrigger 觸發程序繫結，或 WebPubSubContext 輸入與 HttpTrigger 繫結，以處理服務要求。
(5)-(6) WebPubSub 輸出繫結，以要求服務執行某些動作。
連接字串設定
根據預設，名為 WebPubSubConnectionString 的應用程式設定會用來儲存您的 Web PubSub 連接字串。 當您選擇為連線使用不同的設定名稱時，您必須明確將該名稱設定為系結定義中的索引鍵名稱。 在本機開發期間，您也必須將此設定新增至 Values local.settings.json 檔案中的集合。
重要
連接字串包含應用程式存取 Azure Web PubSub 服務所需的授權資訊。 連接字串內的存取金鑰類似於服務的根密碼。 為了獲得最佳安全性，函式應用程式在連線到 Web PubSub 服務時應該使用受控識別，而不是使用連接字串。 如需詳細資訊，請參閱 使用 Microsoft Entra ID 授權受控識別要求。
如需如何設定和使用 Web PubSub 和 Azure Functions 的詳細資訊，請參閱 教學課程：使用 Azure Functions 和 Azure Web PubSub 服務建立無伺服器通知應用程式。
注意
在獨立工作者模式下運行時，Azure Web PubSub 綁定目前不支援使用 Microsoft Entra ID 進行受管理身份驗證。 在隔離模型中，您必須繼續使用連接字串，其中包含共用秘密金鑰。