Condividi tramite


Guida introduttiva: Connessione all'istanza di PubSub Web di Azure dall'interfaccia della riga di comando

Questa guida introduttiva illustra come connettersi all'istanza di PubSub Web di Azure e pubblicare messaggi ai client connessi usando l'interfaccia della riga di comando di Azure.

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Prerequisiti

  • Questa guida introduttiva richiede la versione 2.22.0 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.

Creare un gruppo di risorse

Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure. Usare il comando az group create per creare un gruppo di risorse denominato myResourceGroup nel eastus percorso.

az group create --name myResourceGroup --location EastUS

Creare un'istanza di Web PubSub

Eseguire az extension add per installare o aggiornare l'estensione webpubsub alla versione corrente.

az extension add --upgrade --name webpubsub

Usare il comando az webpubsub create dell'interfaccia della riga di comando di Azure per creare un Web PubSub nel gruppo di risorse creato. Il comando seguente crea una risorsa Web PubSub gratuita nel gruppo di risorse myResourceGroup in EastUS:

Importante

Ogni risorsa Web PubSub deve avere un nome univoco. Sostituire <your-unique-resource-name> con il nome di Web PubSub negli esempi seguenti.

az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1

L'output di questo comando mostra le proprietà della risorsa appena creata. Prendere nota delle due proprietà elencate di seguito:

  • Nome risorsa: nome specificato al --name parametro precedente.
  • hostName: nell'esempio il nome host è <your-unique-resource-name>.webpubsub.azure.com/.

A questo punto, l'account Azure è l'unico autorizzato a eseguire qualsiasi operazione su questa nuova risorsa.

Riprodurre con l'istanza

Connettersi al servizio

Usare il comando az webpubsub client dell'interfaccia della riga di comando di Azure per avviare una connessione client WebSocket al servizio creato nel passaggio precedente, fornendo le informazioni seguenti:

  • Nome hub: stringa da 1 a 127 caratteri. Deve iniziare con caratteri (a-z, A-Z) alfabetici e contenere solo caratteri alfanumerici (0-9, a-z, A-Z) o caratteri di sottolineatura (_).

Hub è un set logico delle connessioni WebSocket connesse. Per informazioni dettagliate sui concetti, vedere Informazioni su Hub, gruppi e connessioni .

Importante

Sostituire <your-unique-resource-name> con il nome della risorsa Web PubSub creata nei passaggi precedenti.

  • Nome hub: myHub1.
  • Nome del gruppo di risorse: myResourceGroup.
  • ID utente: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"

È possibile notare che il comando ha stabilito una connessione WebSocket al servizio Web PubSub e che è stato ricevuto un messaggio JSON che indica che è ora connesso correttamente e che viene assegnato con un oggetto univoco connectionId:

{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}

Provare a partecipare ai gruppi usando joingroup <group-name> e inviare messaggi ai gruppi usando sendtogroup <group-name>:

joingroup group1
sendtogroup group1 hello

Pubblicare messaggi e gestire i client

L'interfaccia della riga di comando di Azure fornisce anche i comandi az webpubsub service per gestire le connessioni client.

Aprire un altro comando dell'interfaccia della riga di comando ed è possibile trasmettere messaggi ai client:

  • Nome hub: myHub1.
  • Nome del gruppo di risorse: myResourceGroup.
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"

Tornare al comando dell'interfaccia della riga di comando precedente ed è possibile vedere che il client ha ricevuto il messaggio:

{"type":"message","from":"server","dataType":"text","data":"Hello World"}

È anche possibile elencare tutti i comandi disponibili usando --help l'opzione e riprodurre con i comandi elencati.

az webpubsub service --help

Passaggi successivi

Questa guida introduttiva offre un'idea di base su come connettersi al servizio Web PubSub e su come pubblicare messaggi nei client connessi.

Nelle applicazioni reali è possibile usare gli SDK in diversi linguaggi per creare un'applicazione personalizzata. Sono inoltre disponibili estensioni per le funzioni per creare facilmente applicazioni serverless.

Usare queste risorse per iniziare a creare un'applicazione personalizzata: