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

2025-04-07

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

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

오버플로 다이어그램은 서비스 클라이언트 라이브러리를 사용하는 오버플로를 보여 줍니다.

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

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

소스 코드 | 패키지 | 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);