什么是Asp.Net Core SignalR

Asp.Net Core SignalR 是微軟開發(fā)的一套基于Asp.Net Core的與Web進(jìn)行實(shí)時(shí)交互的類庫(kù)，它使我們的應(yīng)用能夠?qū)崟r(shí)的把數(shù)據(jù)推送給Web客戶端。

功能

• 自動(dòng)管理連接

• 允許同時(shí)廣播到所有客戶端

• 也可以廣播到指定的組或者特定的客戶端

• 在Github上開源，傳送門

SignalR 提供了多種連接方式，在現(xiàn)代化應(yīng)用中，WebSocket是最佳的傳輸協(xié)議，在客戶端無法實(shí)現(xiàn)WebSocket協(xié)議的時(shí)候，SignalR就會(huì)采取其他方式，比如Server-Sent或者長(zhǎng)輪詢（在ws未出現(xiàn)之前，我們討論的推拉模式）

中心 Hubs

SignalR是采用中心客戶端和服務(wù)器進(jìn)行通訊。

中心是一種高級(jí)的管道，允許客戶端和服務(wù)器之間相互調(diào)用方法。

中心通過強(qiáng)類型參數(shù)傳遞給方法，進(jìn)行模型綁定

Hubs.Clients

Clients屬性包含了所有的客戶端連接信息，它包含了3個(gè)屬性：

• All?所有客戶端

• Caller?進(jìn)行此次請(qǐng)求的客戶端

• Others?排除此次請(qǐng)求客戶端的其他客戶端
  包含了多個(gè)方法：
  =?AllExcept?在指定的連接除外的所有連接的客戶端上調(diào)用方法

• Client?在特定連接的客戶端上調(diào)用方法

• Clients?在特定連接的客戶端上調(diào)用方法

• Group?調(diào)用指定的組中的一種對(duì)所有連接方法

• GroupExcept?調(diào)用中指定的組，除非指定連接到的所有連接的方法

• Groups?調(diào)用一種對(duì)多個(gè)組的連接方法

• OthersInGroup?調(diào)用一種對(duì)一組的連接，不包括客戶端調(diào)用 hub 方法方法

• User?調(diào)用一種對(duì)與特定用戶關(guān)聯(lián)的所有連接方法

• Users?調(diào)用一種對(duì)與指定的用戶相關(guān)聯(lián)的所有連接方法

每個(gè)屬性和方法返回的對(duì)象都包含一個(gè)SendAsync方法，可以對(duì)客戶端進(jìn)行調(diào)用。

HubContext

可以在應(yīng)用其他地方通過使用IHubContext，達(dá)到調(diào)用Hub的目的。

兩種協(xié)議

• 文本協(xié)議：JSON

• 二進(jìn)制協(xié)議：MessagePack

MessagePack類似于JSON，但傳輸比JSON更快，數(shù)據(jù)大小比JSON更小

服務(wù)器事項(xiàng)

• 創(chuàng)建的Hub必須繼承Microsoft.AspNetCore.SignalR.Hub,Hub類已經(jīng)包含了管理連接、組和發(fā)送接收消息的屬性及事件

• 在Hub中使用的方法應(yīng)該盡量使用異步的方式，因?yàn)镾ignalR在發(fā)送和接收消息的時(shí)候使用的是異步方法。

• 在Startup.ConfigureServices中通過services.AddSignalR對(duì)SignalR進(jìn)行注冊(cè)

• 在Startup.Configure中通過app.UseSignalR方法對(duì)Hub路由進(jìn)行配置

代碼解析

微軟官方示范中的ChatHub：

using Microsoft.AspNetCore.SignalR;
using System.Threading.Tasks;
namespace SignalRChat.Hubs{ ?
?public class ChatHub : Hub{ ? ? ? ?//服務(wù)端方法public async Task SendMessage(string user, string message) ? ? ? ?{ ? ? ? ? ? ?//ReceiveMessage 為客戶端方法，讓所有客戶端調(diào)用這個(gè)方法await Clients.All.SendAsync("ReceiveMessage", user, message);}} }

上述代碼為當(dāng)收到客戶端發(fā)來的SendMessage請(qǐng)求后（發(fā)送聊天信息），我們把消息發(fā)送到所有客戶端，讓他們調(diào)用自身的ReceiveMessage方法。

用戶標(biāo)識(shí)

通常情況下，在用戶進(jìn)行連接后，Connection會(huì)保存用戶的用戶標(biāo)識(shí)，以便對(duì)特定用戶進(jìn)行發(fā)送消息。

可以實(shí)現(xiàn)IUserIdProvider來自定義獲取用戶的方法，例如：

在Startup.ConfigureServices中注冊(cè)：

? ?services.AddSingleton<IUserIdProvider, CustomUserIdProvider>();

Group 分組

分組類似于聊天室中的每個(gè)房間，通過分組，我們可以給特定小組發(fā)送消息。

用戶標(biāo)識(shí)和組名稱都是區(qū)分大小寫的。

微信小程序與SignalR交互

小程序因?yàn)闊o法直接使用websocket，所以無法使用signalR.js，你可以試著把signalR.js中的webcosket使用部分換成wx.xxSocketxxx。

在參考了算神的代碼后，歸了一個(gè)小類庫(kù)，方便大家使用，源碼較長(zhǎng)，我放到了github上，點(diǎn)擊【傳送門】進(jìn)入。

如何使用

調(diào)用類庫(kù)

在要使用的頁面上：

///引入這個(gè)類庫(kù)var signalR = require('../../lib/signalr/signalr.js')///實(shí)例化一個(gè)對(duì)象let _client = new signalR.signalR();

創(chuàng)建 一個(gè)映射方法

這是為了讓小程序收到SignalR的消息之后進(jìn)行回調(diào)

例子里有一個(gè)sayHello方法，我們用字符串作為key。

進(jìn)行連接

_client.connection(url, methodMapping);

• url : signalR服務(wù)器

• methodMapping : 方法和字符串之間的Mapping

調(diào)用SignalR方法

_client.call(methodName, args, success, fail)

• methodName:遠(yuǎn)程方法名

• args：參數(shù)，這里注意一定要數(shù)組格式

• success：調(diào)用成功后的回調(diào)

• fail：失敗后的回調(diào)

寫在最后

最近真的忙，忙成一道閃電，正好遇到這個(gè)問題隨之記錄下。類庫(kù)可能并不完善，你可以在github上提issue，我會(huì)跟進(jìn)的，有好的修改方式，你也可以PR我。

原文地址：https://www.cnblogs.com/inday/p/signalr-wechat-miniapp.html

.NET社區(qū)新聞，深度好文，歡迎訪問公眾號(hào)文章匯總 http://www.csharpkit.com

總結(jié)

以上是生活随笔為你收集整理的Asp.Net Core SignalR 与微信小程序交互笔记的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。