Delen via


Quickstart: Web PubSub opnemen voor Socket.IO in uw app

In deze quickstart ziet u hoe u een Web PubSub maakt voor Socket.IO resource en deze snel opneemt in uw Socket.IO-app om de ontwikkeling te vereenvoudigen, de implementatie te versnellen en schaalbaarheid te realiseren zonder complexiteit.

Code die in deze quickstart wordt weergegeven, bevindt zich in CommonJS. Als u een ECMAScript-module wilt gebruiken, raadpleegt u de chatdemo voor Socket.IO met Azure Web PubSub.

Belangrijk

Onbewerkte verbindingsreeks worden alleen in dit artikel weergegeven voor demonstratiedoeleinden.

Een verbindingsreeks bevat de autorisatiegegevens die nodig zijn voor uw toepassing voor toegang tot de Azure Web PubSub-service. De toegangssleutel in de verbindingsreeks is vergelijkbaar met een hoofdwachtwoord voor uw service. Beveilig uw toegangssleutels altijd in productieomgevingen. Gebruik Azure Key Vault om uw sleutels veilig te beheren en te roteren en uw verbinding te beveiligen.WebPubSubServiceClient

Vermijd het distribueren van toegangssleutels naar andere gebruikers, het coderen ervan of het opslaan van ze ergens in tekst zonder opmaak die toegankelijk is voor anderen. Draai uw sleutels als u denkt dat ze mogelijk zijn aangetast.

Vereisten

  • Een Azure-account met een actief abonnement. Als u nog geen account hebt, kunt u een gratis account aanmaken.
  • Enige bekendheid met de Socket.IO-bibliotheek.

Een Web PubSub maken voor Socket.IO-resource

Als u een Web PubSub voor Socket.IO wilt maken, kunt u de volgende knop met één klik gebruiken om de onderstaande acties te maken of te volgen om te zoeken in Azure Portal.

  • Gebruik de volgende knop om een Web PubSub te maken voor Socket.IO-resource in Azure

    Implementeren op Azure

  • Zoeken vanuit de zoekbalk van De Azure-portal

    1. Ga naar de Azure Portal.

    2. Zoek socket.io in de zoekbalk en selecteer vervolgens Web PubSub voor Socket.IO.

      Schermopname van het doorzoeken van de Web PubSub naar Socket.IO-service in Azure Portal.

  • Zoeken vanuit Marketplace

    1. Ga naar de Azure Portal.

    2. Selecteer de knop Een resource maken in de linkerbovenhoek van Azure Portal. Typ socket.io in het zoekvak en druk op Enter. Selecteer de Web PubSub voor Socket.IO in het zoekresultaat.

      Schermopname van de Web PubSub voor Socket.IO-service in de marketplace.

    3. Klik op Maken op de pop-outpagina.

      Schermopname van de Web PubSub voor Socket.IO-service in Azure Portal.

Berichten verzenden met Socket.IO bibliotheken en Web PubSub voor Socket.IO

In de volgende stappen maakt u een Socket.IO project en integreert u met Web PubSub voor Socket.IO.

Een Node-project initialiseren en vereiste pakketten installeren

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

Servercode schrijven

Maak een server.js bestand en voeg de volgende code toe om een Socket.IO-server te maken en te integreren met Web PubSub voor Socket.IO.

Onbewerkte verbindingsreeks worden alleen in dit artikel weergegeven voor demonstratiedoeleinden. Beveilig uw toegangssleutels altijd in productieomgevingen. Gebruik Azure Key Vault om uw sleutels veilig te beheren en te roteren en uw verbinding te beveiligen.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"
    })
});

Clientcode schrijven

Maak een client.js bestand en voeg de volgende code toe om de client te verbinden met Web PubSub voor 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")

Wanneer u Web PubSub gebruikt voor Socket.IO <web-pubsub-socketio-endpoint> en path is vereist dat de client verbinding maakt met de service. De <web-pubsub-socketio-endpoint> en path zijn te vinden in Azure Portal.

  1. Ga naar de sleutelblade van Web PubSub voor Socket.IO

  2. Typ de naam van uw hub en kopieer het clienteindpunt en het clientpad

    Schermopname van de Web PubSub voor Socket.IO-service op de blade Clienteindpunten van Azure Portal.

De app uitvoeren

  1. Voer de server-app uit:

    node server.js "<connection-string>"
    

    Dit <connection-string> is de verbindingsreeks die het eindpunt en de sleutels bevat voor toegang tot uw Web PubSub voor Socket.IO-resource. U kunt de verbindingsreeks ook vinden in Azure Portal

    Schermopname van de Web PubSub voor Socket.IO-service in azure Portal verbindingsreeks blade.

  2. Voer de client-app uit in een andere terminal:

    node client.js