Azure SignalR 服務是一種完全托管的服務，可簡化將實時 Web 功能添加到應用程序的過程。它基于 ASP.NET Core SignalR 構建，但將其作為獨立的云服務提供，讓你無需管理基礎設施即可輕松擴展。本文將通過一個使用 C# 和 .NET Core 的簡單示例，引導你快速入門 Azure SignalR 服務的無服務器模式。

先決條件

在開始之前，請確保你已具備以下條件：

1. 一個有效的 Microsoft Azure 賬戶（可創建免費賬戶）。
2. .NET Core SDK 3.1 或更高版本 已安裝在你的開發機器上。
3. Visual Studio Code 或 Visual Studio 等代碼編輯器。
4. Azure CLI 或 Azure PowerShell（可選，用于資源管理）。

第一步：創建 Azure SignalR 服務資源

1. 登錄到 Azure 門戶。
2. 點擊“創建資源”，在市場中搜索“SignalR 服務”，然后選擇它。
3. 點擊“創建”并配置以下基本信息：

• 資源組：創建新組或選擇現有組。

• 資源名稱：輸入一個全局唯一的名稱（例如 mySignalRService）。

• 區域：選擇離你的用戶最近的區域。

• 定價層：對于入門和測試，選擇“免費 F1”層。對于生產環境，請考慮標準層。

• 服務模式：這是關鍵步驟。選擇“無服務器”模式。在這種模式下，你無需預配置容量，只需為實際使用的連接和消息付費。

1. 點擊“查看 + 創建”，然后點擊“創建”。部署完成后，導航到你的新資源。

第二步：獲取連接字符串

在 SignalR 服務資源的概覽頁面或“密鑰”設置中，找到“連接字符串”。它通常以 Endpoint=https://...;AccessKey=...;Version=1.0; 的格式呈現。復制主連接字符串。這是你的應用程序連接到 Azure SignalR 服務所必需的憑證。

第三步：創建 .NET Core 控制臺應用程序（客戶端）

我們將創建一個簡單的控制臺應用來模擬客戶端連接和消息發送。

1. 打開終端或命令提示符，創建一個新目錄并初始化項目：
`bash
mkdir SignalRClient
cd SignalRClient
dotnet new console
`

2. 添加必要的 NuGet 包：
`bash
dotnet add package Microsoft.AspNetCore.SignalR.Client
dotnet add package Microsoft.Extensions.Logging.Console
`

1. 編輯 Program.cs 文件，替換為以下代碼。請務必將 <your-connection-string> 替換為你在第二步中復制的實際連接字符串。

using System;
using System.Threading.Tasks;
using Microsoft.AspNetCore.SignalR.Client;
using Microsoft.Extensions.Logging;
namespace SignalRClient
{
class Program
{
static async Task Main(string[] args)
{
// 使用你的 Azure SignalR 服務連接字符串
var connectionString = "<your-connection-string>";
// 從連接字符串中提取終結點和訪問密鑰（簡化處理，生產環境建議使用更安全的方式）
var endpoint = connectionString.Split(';')[0].Replace("Endpoint=", "");
// 構建 Hub 連接。在無服務器模式下，我們直接連接到 Azure SignalR 服務。
// "chat" 是 Hub 的名稱，需要與你的服務器端邏輯（如果有）或協商端點匹配。
var connection = new HubConnectionBuilder()
.WithUrl($"{endpoint}/client/?hub=chat")
.ConfigureLogging(logging =>
{
logging.AddConsole();
logging.SetMinimumLevel(LogLevel.Debug);
})
.Build();
// 定義一個從服務器（或通過服務中轉）接收消息的處理程序
connection.On<string, string>("ReceiveMessage", (user, message) =>
{
Console.WriteLine($"{user}: {message}");
});
try
{
// 啟動連接
await connection.StartAsync();
Console.WriteLine("連接已建立。輸入消息（輸入 'exit' 退出）:");
// 簡單的循環來發送消息
string input;
do
{
input = Console.ReadLine();
if (!string.IsNullOrEmpty(input) && input.ToLower() != "exit")
{
// 發送消息到名為 "SendMessage" 的 Hub 方法
await connection.InvokeAsync("SendMessage", "ConsoleUser", input);
}
} while (input?.ToLower() != "exit");
}
catch (Exception ex)
{
Console.WriteLine($"連接錯誤: {ex.Message}");
}
finally
{
// 關閉連接
await connection.DisposeAsync();
}
}
}
}

重要說明：在純粹的無服務器場景下，通常沒有常駐的應用程序服務器來托管 Hub 邏輯。Azure SignalR 服務無服務器模式允許客戶端直接連接到服務，并通過 Azure Functions 或 Event Grid 等事件驅動服務來處理上游消息（例如 SendMessage）。上述客戶端代碼主要演示了連接和基本通信模式。要處理 SendMessage 調用，你需要配置一個 Azure Function（使用 SignalR 服務綁定）來接收并廣播消息。

第四步：運行與測試

1. 在項目目錄中，運行應用程序：
`bash
dotnet run
`

1. 如果連接成功，你將看到“連接已建立”的提示。輸入一些文本并按回車鍵發送。由于目前沒有配置后端函數來處理和廣播消息，ReceiveMessage 處理程序可能不會被觸發（除非你有另一個已連接的客戶端或已配置的后端）。

后續步驟與最佳實踐

• 集成 Azure Functions：要構建完整的無服務器實時應用，請創建一個 Azure Function（例如 HTTP 觸發器），使用 SignalR 輸出綁定來廣播從客戶端接收到的消息。這樣，當客戶端調用 InvokeAsync 時，它可以向一個 Function 端點發送 HTTP 請求，由該 Function 通過 SignalR 服務將消息廣播給所有連接的客戶端。
• 安全性：在生產環境中，切勿將連接字符串硬編碼在客戶端代碼中。應使用 Azure Key Vault 或服務器端（如 Function）進行令牌頒發，實現安全的客戶端連接。
• 監控與診斷：利用 Azure 門戶中的 SignalR 服務“診斷和解決問題”部分以及 Azure Monitor 來監控連接、消息和錯誤。
• 擴展：無服務器模式的優勢在于自動擴展。隨著連接數的增長，Azure 會自動管理底層資源，你只需按實際使用量付費。

通過以上步驟，你已經成功創建了一個 Azure SignalR 服務資源（無服務器模式），并建立了一個能夠與之通信的基本 C# 客戶端。這為構建可擴展的實時應用程序（如聊天室、實時儀表板、協作工具等）奠定了堅實的基礎。