İstemciler arasında yayımlama/abone olma

Bu hızlı başlangıç kılavuzunda

• Web PubSub kaynağınıza bağlanma
• gruplardan iletilere abone olma
• gruplara ileti yayımlama

Önkoşullar

• Web PubSub kaynağı. Henüz oluşturmadıysanız şu yönergeleri izleyebilirsiniz: Web PubSub kaynağı oluşturma
• Visual Studio Code gibi bir kod düzenleyicisi
• Kullanmayı planladığınız dilin bağımlılıklarını yükleme

İstemci SDK'sını yükleme

Not

Bu kılavuz, hala önizleme aşamasında olan Web PubSub hizmeti tarafından sağlanan istemci SDK'sını kullanır. Arabirim sonraki sürümlerde değişebilir.

JavaScript

mkdir pubsub_among_clients
cd pubsub_among_clients

# The SDK is available as an NPM module.
npm install @azure/web-pubsub-client

C#

mkdir pubsub_among_clients
cd pubsub_among_clients

# Create a new .net console project
dotnet new console

# Install the client SDK, which is available as a NuGet package
dotnet add package Azure.Messaging.WebPubSub.Client --prerelease

Web PubSub'a bağlanma

Tarayıcı, mobil uygulama 📱veya IoT cihazı 💡gibi 💻bir istemci, kaynağınıza bağlanmak ve kaynağınızla kimlik doğrulaması yapmak için bir İstemci Erişim URL'si kullanır. Bu URL, desenini izler wss://<service_name>.webpubsub.azure.com/client/hubs/<hub_name>?access_token=<token>. İstemcinin İstemci Erişim URL'sini almak için birkaç yolu olabilir. Bu hızlı başlangıç için aşağıdaki diyagramda gösterilen Azure portal kopyalayıp yapıştırabilirsiniz. Kodunuzda İstemci Erişimi URL'sini sabit kodlamamak en iyi yöntemdir. Üretim dünyasında genellikle bu URL'yi isteğe bağlı olarak döndürmek için bir uygulama sunucusu kurarız. İstemci Erişimi URL'si oluşturma alıştırmayı ayrıntılı olarak açıklar.

Yukarıdaki diyagramda gösterildiği gibi, istemciye ileti gönderme ve adlı group1belirli bir gruba katılma izinleri vardır.

JavaScript

Adlı index.js bir dosya oluşturun ve aşağıdaki kodu ekleyin

const { WebPubSubClient } = require("@azure/web-pubsub-client");

// Instantiate the client object. 
// <client-access-url> is copied from Azure portal mentioned above.
const client = new WebPubSubClient("<client-access-url>");

C#

Program.cs Dosyayı düzenleyin ve aşağıdaki kodu ekleyin

using Azure.Messaging.WebPubSub.Clients;

// Instantiate the client object. 
// <client-access-uri> is copied from Azure portal mentioned above.
var client = new WebPubSubClient(new Uri("<client-access-uri>"));

Gruba abone olma

Gruplardan ileti almak için, istemci

• iletileri almak istediği gruba katılmalı
• olayı işlemek group-message için bir geri çağırması var

Aşağıdaki kod, istemcinin adlı group1gruptan iletilere abone olduğunu gösterir.

JavaScript

// ...code from the last step

// Provide callback to the "group-message" event. 
client.on("group-message", (e) => {
  console.log(`Received message: ${e.message.data}`);
});

// Before joining group, you must invoke start() on the client object.
client.start();

// Join a group named "group1" to subscribe message from this group.
// Note that this client has the permission to join "group1", 
// which was configured on Azure portal in the step of generating "Client Access URL".
client.joinGroup("group1");

C#

// ...code from the last step

// Provide callback to group messages.
client.GroupMessageReceived += eventArgs =>
{
    Console.WriteLine($"Receive group message from {eventArgs.Message.Group}: {eventArgs.Message.Data}");
    return Task.CompletedTask;
};

// Before joining group, you must invoke start() on the client object.
await client.StartAsync();

// Join a group named "group1" to subscribe message from this group.
// Note that this client has the permission to join "group1", 
// which was configured on Azure portal in the step of generating "Client Access URL".
await client.JoinGroupAsync("group1");

Gruba ileti yayımlama

Önceki adımda, 'den group1ileti almak için gereken her şeyi ayarladık, şimdi de bu gruba ileti gönderiyoruz.

JavaScript

// ...code from the last step

// Send message "Hello World" in the "text" format to "group1".
client.sendToGroup("group1", "Hello World", "text");

C#

// ...code from the last step

// Send message "Hello World" in the "text" format to "group1".
await client.SendToGroupAsync("group1", BinaryData.FromString("Hello World"), WebPubSubDataType.Text);

Sonraki adımlar

İstemci SDK'sını kullanarak artık nasıl yapılacağını biliyorsunuz

• Web PubSub kaynağınıza bağlanma
• grup iletilerine abone olma
• gruplara ileti yayımlama

Ardından, bir uygulama sunucusundan istemcilerinize gerçek zamanlı olarak ileti göndermeyi öğreneceksiniz.

Uygulama sunucusundan ileti gönderme