.NET용 Azure Web PubSub 서비스 클라이언트 라이브러리

아티클
02/21/2024

Azure Web PubSub 서비스는 개발자가 실시간 기능 및 게시-구독 패턴을 사용하여 웹 애플리케이션을 쉽게 빌드할 수 있도록 도와주는 Azure 관리 서비스입니다. 서버와 클라이언트 간 또는 클라이언트 간에 실시간 게시-구독 메시징이 필요한 시나리오에서는 Azure Web PubSub 서비스를 사용할 수 있습니다. 서버에서 폴링하거나 HTTP 요청을 제출해야 하는 경우가 많은 기존의 실시간 기능도 Azure Web PubSub 서비스를 사용할 수 있습니다.

아래 다이어그램과 같이 앱 서버 쪽에서 이 라이브러리를 사용하여 WebSocket 클라이언트 연결을 관리할 수 있습니다.

The overflow diagram shows the overflow of using the service client library.

이 라이브러리를 사용하여 다음을 수행합니다.

허브 및 그룹에 메시지를 보냅니다.
특정 사용자 및 연결에 메시지를 보냅니다.
사용자와 연결을 그룹으로 구성합니다.
연결 종료
기존 연결에 대한 권한 부여, 철회 및 확인

소스 코드 | 패키지 | API 참조 설명서 | 제품 설명서 | 샘플

시작하기

패키지 설치

NuGet에서 클라이언트 라이브러리를 설치합니다.

dotnet add package Azure.Messaging.WebPubSub

필수 구성 요소

Azure 구독.
기존 Azure Web PubSub 서비스 인스턴스.

`WebPubSubServiceClient` 만들기 및 인증

서비스와 상호 작용하려면 WebPubSubServiceClient 클래스의 인스턴스를 만들어야 합니다. 이를 가능하게 하려면 Azure Portal에서 액세스할 수 있는 연결 문자열 또는 키가 필요합니다.

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

예제

모든 클라이언트에게 문자 메시지 브로드캐스트

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

serviceClient.SendToAll("Hello World!");

모든 클라이언트에 JSON 메시지 브로드캐스트

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

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

모든 클라이언트에 이진 메시지 브로드캐스트

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);