C#在.NET Core中的WebSocket支持與應用

在.NET Core中，WebSocket是一種常用的通信協議，它提供了一個全雙工的通信通道，使得客戶端和服務器之間可以實時地發送和接收數據

1. 安裝Microsoft.AspNetCore.WebSockets包：

在項目中使用WebSocket，首先需要安裝Microsoft.AspNetCore.WebSockets包。可以通過NuGet包管理器或者在項目文件夾下的.csproj文件中添加以下代碼來安裝：

<ItemGroup>
   <PackageReference Include="Microsoft.AspNetCore.WebSockets" Version="5.0.10" />
</ItemGroup>

2. 配置WebSocket中間件：

在Startup類的Configure方法中，添加WebSocket中間件。這將允許應用程序處理WebSocket請求。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ...
    app.UseWebSockets();
    // ...
}

3. 創建WebSocket處理器：

創建一個新的類，用于處理WebSocket連接。這個類需要繼承自Microsoft.AspNetCore.Http.Connections.ConnectionHandler類，并重寫OnConnectedAsync、OnDisconnectedAsync和OnReceiveAsync方法。

using Microsoft.AspNetCore.Http.Connections;
using System.Threading.Tasks;

public class MyWebSocketHandler : ConnectionHandler
{
    public override Task OnConnectedAsync(ConnectionContext connection)
    {
        // 處理連接建立時的邏輯
        return base.OnConnectedAsync(connection);
    }

    public override Task OnDisconnectedAsync(ConnectionContext connection)
    {
        // 處理連接斷開時的邏輯
        return base.OnDisconnectedAsync(connection);
    }

    public override Task OnReceiveAsync(ConnectionContext connection, byte[] data)
    {
        // 處理接收到的數據
        return base.OnReceiveAsync(connection, data);
    }
}

4. 注冊WebSocket處理器：

在Startup類的Configure方法中，添加一個路由，將WebSocket請求映射到剛剛創建的處理器。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ...
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapConnectionHandler<MyWebSocketHandler>("/ws");
    });
    // ...
}

5. 客戶端連接：

客戶端可以使用標準的WebSocket API連接到服務器。以下是一個JavaScript示例：

const socket = new WebSocket('ws://localhost:5000/ws');

socket.onopen = (event) => {
    console.log('WebSocket連接已打開', event);
};

socket.onmessage = (event) => {
    console.log('WebSocket收到消息', event.data);
};

socket.onclose = (event) => {
    console.log('WebSocket連接已關閉', event);
};

socket.onerror = (event) => {
    console.error('WebSocket錯誤', event);
};

現在，當客戶端連接到服務器時，服務器會接收到WebSocket連接請求，并觸發MyWebSocketHandler中的OnConnectedAsync方法。客戶端可以通過WebSocket API發送和接收數據，服務器端可以在MyWebSocketHandler的OnReceiveAsync方法中處理接收到的數據。當連接關閉時，服務器會觸發OnDisconnectedAsync方法。