Biblioteca de cliente de serviço Azure Web PubSub para .NET

O Azure Web PubSub Service é um serviço gerido pelo Azure que ajuda os programadores a construir facilmente aplicações web com funcionalidades em tempo real e padrão de publicação-subscrição. Qualquer cenário que exija mensagens de publicação-subscrição em tempo real entre servidor e clientes ou entre clientes pode usar o serviço Azure Web PubSub. Funcionalidades tradicionais em tempo real, que frequentemente requerem sondagens do servidor ou submissão de pedidos HTTP, também podem usar o serviço Azure Web PubSub.

Pode usar esta biblioteca no lado do seu servidor de aplicações para gerir as ligações do cliente WebSocket, como mostrado no diagrama abaixo:

O diagrama de sobrecarga mostra a sobrecarga ao utilizar a biblioteca de cliente de serviço.

Use esta biblioteca para:

Envia mensagens para hubs e grupos.
Envie mensagens a utilizadores e ligações específicas.
Organizar utilizadores e ligações em grupos.
Ligações próximas
Conceder, revogar e verificar permissões para uma ligação existente

Código-fonte Documentação de referência |

Como Começar

Instalar o pacote

Instale a biblioteca cliente do NuGet:

dotnet add package Azure.Messaging.WebPubSub

Pré-requisitos

Uma assinatura do Azure.
Uma instância existente do serviço Azure Web PubSub.

Criar e autenticar um `WebPubSubServiceClient`

Para interagir com o serviço, terá de criar uma instância da WebPubSubServiceClient classe. Para tornar isto possível, vai precisar da string de ligação ou de uma chave, que pode aceder no portal Azure.

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

Exemplos

Transmitir uma mensagem de texto a todos os clientes

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

serviceClient.SendToAll("Hello World!");

Transmita uma mensagem JSON a todos os clientes

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

serviceClient.SendToAll(RequestContent.Create(
        new
        {
            Foo = "Hello World!",
            Bar = 42
        }),
        ContentType.ApplicationJson);

Transmitir uma mensagem binária a todos os clientes

var serviceClient = new WebPubSubServiceClient(new Uri(endpoint), "some_hub", new AzureKeyCredential(key));

Stream stream = BinaryData.FromString("Hello World!").ToStream();
serviceClient.SendToAll(RequestContent.Create(stream), ContentType.ApplicationOctetStream);