Pustaka klien layanan Azure Web PubSub untuk .NET

Azure Web PubSub Service adalah layanan yang dikelola Azure yang membantu pengembang dengan mudah membangun aplikasi web dengan fitur real time dan pola terbitkan-berlangganan. Skenario apa pun yang memerlukan pesan 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 mengirimkan permintaan HTTP juga dapat menggunakan layanan Azure Web PubSub.

Anda dapat menggunakan pustaka ini di sisi server aplikasi 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.
• Atur pengguna dan koneksi ke dalam grup.
• Tutup sambungan
• Memberikan, mencabut, dan memeriksa izin untuk koneksi yang sudah ada

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

Memulai Langkah Awal

Memasang paket

Instal pustaka klien dari NuGet:

dotnet add package Azure.Messaging.WebPubSub

Prasyarat

• Sebuah 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 memungkinkan 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

Menyiarkan pesan teks ke semua klien

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

serviceClient.SendToAll("Hello World!");

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

Menyiarkan 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 pencatatan konsol

Anda juga dapat mengaktifkan pencatatan konsol jika Anda ingin menggali lebih dalam permintaan yang Anda kirim ke 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 subprotokol yang didukung oleh layanan untuk streaming klien

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

Tutorial: Mengonfigurasi pendengar peristiwa

Mencoba demo langsung

Jelajahi sampel Azure Web PubSub lainnya