Rychlý start: Začlenění webového pubSub pro Socket.IO do aplikace

Tento rychlý start ukazuje, jak vytvořit web pubSub pro Socket.IO prostředek a rychle ho začlenit do Socket.IO aplikace, aby se zjednodušil vývoj, urychlil nasazení a dosáhl škálovatelnosti bez složitosti.

Kód zobrazený v tomto rychlém startu je v CommonJS. Pokud chcete použít modul ECMAScript, podívejte se na ukázku chatu pro Socket.IO se službou Azure Web PubSub.

Důležité

Nezpracované připojovací řetězec se v tomto článku zobrazují jenom pro demonstrační účely.

Připojovací řetězec obsahuje informace o autorizaci vyžadované pro vaši aplikaci pro přístup ke službě Azure Web PubSub. Přístupový klíč uvnitř připojovací řetězec je podobný kořenovému heslu pro vaši službu. V produkčních prostředích vždy chraňte přístupové klíče. Pomocí služby Azure Key Vault můžete bezpečně spravovat a obměňovat klíče a zabezpečit připojení WebPubSubServiceClient.

Vyhněte se distribuci přístupových klíčů ostatním uživatelům, jejich pevnému kódování nebo jejich uložení kdekoli ve formátu prostého textu, který je přístupný ostatním uživatelům. Otočte klíče, pokud se domníváte, že mohly být ohroženy.

Požadavky

• Účet Azure s aktivním předplatným. Pokud žádné nemáte, můžete si vytvořit bezplatný účet.
• Znalost knihovny Socket.IO

Vytvoření webového pubSub pro prostředek Socket.IO

Pokud chcete vytvořit Web PubSub pro Socket.IO, můžete pomocí následujícího tlačítka jedním kliknutím vytvořit nebo postupovat podle níže uvedených akcí a hledat na webu Azure Portal.

• Pomocí následujícího tlačítka vytvořte web pubSub pro Socket.IO prostředek v Azure.

  

• Hledání na panelu hledání na webu Azure Portal

  1. Přejděte na Azure Portal.

  2. Vyhledejte socket.io, na panelu hledání a pak vyberte Web PubSub pro Socket.IO.

     

• Hledání z Marketplace

  1. Přejděte na Azure Portal.

  2. Vyberte tlačítko Vytvořit prostředek v levém horním rohu webu Azure Portal. Do vyhledávacího pole zadejte socket.io a stiskněte enter. Ve výsledku hledání vyberte web pubSub pro Socket.IO .

     

  3. Klikněte na Vytvořit na místní stránce.

     

Odesílání zpráv pomocí knihoven Socket.IO a web pubSub pro Socket.IO

V následujících krocích vytvoříte projekt Socket.IO a integrujete ho s web pubSub pro Socket.IO.

Inicializace projektu Node a instalace požadovaných balíčků

mkdir quickstart
cd quickstart
npm init
npm install @azure/web-pubsub-socket.io socket.io-client

Psaní kódu serveru

server.js Vytvořte soubor a přidejte následující kód pro vytvoření serveru Socket.IO a integraci s web pubSub pro Socket.IO.

Nezpracované připojovací řetězec se v tomto článku zobrazují jenom pro demonstrační účely. V produkčních prostředích vždy chraňte přístupové klíče. Pomocí služby Azure Key Vault můžete bezpečně spravovat a obměňovat klíče a zabezpečit připojení WebPubSubServiceClient.

/*server.js*/
const { Server } = require("socket.io");
const { useAzureSocketIO } = require("@azure/web-pubsub-socket.io");

let io = new Server(3000);

// Use the following line to integrate with Web PubSub for Socket.IO
useAzureSocketIO(io, {
    hub: "Hub", // The hub name can be any valid string.
    connectionString: process.argv[2]
});

io.on("connection", (socket) => {
    // Sends a message to the client
    socket.emit("hello", "world");

    // Receives a message from the client
    socket.on("howdy", (arg) => {
        console.log(arg);   // Prints "stranger"
    })
});

Psaní kódu klienta

client.js Vytvořte soubor a přidejte následující kód pro připojení klienta k web pubSub pro Socket.IO.

/*client.js*/
const io = require("socket.io-client");

const socket = io("<web-pubsub-socketio-endpoint>", {
    path: "/clients/socketio/hubs/Hub",
});

// Receives a message from the server
socket.on("hello", (arg) => {
    console.log(arg);
});

// Sends a message to the server
socket.emit("howdy", "stranger")

Pokud používáte Web PubSub pro Socket.IO <web-pubsub-socketio-endpoint> a path vyžaduje se, aby se klient připojil ke službě. Najdete ho <web-pubsub-socketio-endpoint> na path webu Azure Portal.

1. Přejděte do okna s klíčem podsítě Web PubSub pro Socket.IO

2. Zadejte název centra a zkopírujte koncový bod klienta a cestu klienta.

   

Spustit aplikaci

1. Spusťte serverové aplikace:

   node server.js "<connection-string>"
   

   Jedná se <connection-string> o připojovací řetězec, který obsahuje koncový bod a klíče pro přístup k vašemu webu PubSub pro Socket.IO prostředek. Připojovací řetězec najdete také na webu Azure Portal.

   

2. Spusťte klientskou aplikaci v jiném terminálu:

   node client.js