Pustaka klien layanan Azure Web PubSub untuk .NET

Layanan Azure Web PubSub adalah layanan yang dikelola Azure dan bertujuan memudahkan pengembang membuat aplikasi web dengan fitur real-time dan pola terbitkan-berlangganan. Skenario apa pun yang memerlukan olahpesan terbitkan-berlangganan real-time antara server dan klien atau di antara klien dapat menggunakan layanan Azure Web PubSub. Fitur real-time tradisional yang sering memerlukan polling dari server atau pengiriman permintaan HTTP juga dapat menggunakan layanan Azure Web PubSub.

Anda dapat menggunakan pustaka ini di sisi server aplikasi Anda untuk mengelola koneksi klien WebSocket, seperti yang ditunjukkan pada diagram di bawah ini:

Gunakan pustaka ini untuk:

• Mengirim pesan ke hub dan grup.
• Mengirim pesan ke pengguna dan koneksi tertentu.
• Mengatur pengguna dan sambungan ke dalam grup.
• Menutup koneksi
• Memberikan,mencabut, dan memeriksa izin untuk koneksi yang sudah ada

Kode sumber | Paket | dokumentasi referensi API | Dokumentasi produk | Sampel

Memulai

Pasang paket

Memasang pustaka klien dari NuGet:

dotnet add package Azure.Messaging.WebPubSub

Prasyarat

• Langganan Azure.
• Instans layanan Azure Web PubSub yang sudah ada.

Membuat dan mengautentikasi WebPubSubServiceClient

Untuk berinteraksi dengan layanan, Anda harus membuat instans kelas WebPubSubServiceClient. Untuk mewujudkan hal ini, Anda memerlukan string koneksi atau kunci, yang dapat Anda akses di portal Microsoft Azure.

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

Contoh

Siaran pesan teks ke semua klien

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

serviceClient.SendToAll("Hello World!");

Siaran pesan JSON ke semua klien

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

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

Siaran pesan biner ke semua klien

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

Pemecahan Masalah

Menyiapkan pembuatan log konsol

Anda juga dapat mengaktifkan pengelogan konsol jika ingin menggali lebih dalam permintaan yang Anda buat terhadap layanan.

Langkah berikutnya

Gunakan sumber daya ini untuk mulai membangun aplikasi Anda sendiri:

Tutorial: Menerbitkan dan berlangganan pesan di Azure Web PubSub

Tutorial: Membuat ruang obrolan sederhana dengan Azure Web PubSub

Tutorial: Menggunakan subprotokola yang didukung layanan untuk streaming klien

Tutorial: Bangun obrolan tanpa server dengan Azure Functions dan Web PubSub

Tutorial: Mengonfigurasi pendengar peristiwa

Bermain dengan demo langsung

Jelajahi sampel Azure Web PubSub lainnya