Rövid útmutató: Csatlakozás az Azure Web PubSub-példányhoz a parancssori felületről

Ez a rövid útmutató bemutatja, hogyan csatlakozhat az Azure Web PubSub-példányhoz, és hogyan tehet közzé üzeneteket a csatlakoztatott ügyfelek számára az Azure CLI használatával.

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

Előfeltételek

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

• Ehhez a rövid útmutatóhoz az Azure CLI 2.22.0-s vagy újabb verziója szükséges. Az Azure Cloud Shell használata esetén a legújabb verzió már telepítve van.

Erőforráscsoport létrehozása

Az erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az az group create paranccsal hozzon létre egy, a eastus helyen elnevezett myResourceGroup erőforráscsoportot.

az group create --name myResourceGroup --location EastUS

Web PubSub-példány létrehozása

Futtassa az az extension add parancsot a webpubsub bővítmény telepítéséhez vagy frissítéséhez az aktuális verzióra.

az extension add --upgrade --name webpubsub

Az Azure CLI az webpubsub create paranccsal hozzon létre egy Web PubSub-t a létrehozott erőforráscsoportban. Az alábbi parancs létrehoz egy ingyenes Web PubSub-erőforrást a myResourceGroup erőforráscsoportban az EastUS-ban:

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

A parancs kimenete az újonnan létrehozott erőforrás tulajdonságait jeleníti meg. Jegyezze fel az alábbi két tulajdonságot:

• Erőforrás neve: A fenti paraméternek --name megadott név.
• hostName: A példában a gazdagép neve .<your-unique-resource-name>.webpubsub.azure.com/

Ezen a ponton az Azure-fiók az egyetlen jogosult az új erőforráson végzett műveletek végrehajtására.

Lejátszás a példánysal

Csatlakozás a szolgáltatáshoz

Az Azure CLI az webpubsub-ügyfél parancsával elindíthat egy WebSocket-ügyfélkapcsolatot az előző lépésben létrehozott szolgáltatással, és adja meg a következő információkat:

• Központi név: 1–127 karakter hosszúságú sztring. Betűrendes karakterekkel (a-z, A-Z) kell kezdődnie, és csak alfa-numerikus (0-9, a-z, A-Z) karaktereket vagy aláhúzásjeleket (_)kell tartalmaznia.

A hub a csatlakoztatott WebSocket-kapcsolatok logikai halmaza. A fogalmakkal kapcsolatos részletekért tekintse meg a Központokkal, csoportokkal és kapcsolatokkal kapcsolatos információkat.

• Központ neve: myHub1.
• Erőforráscsoport neve: myResourceGroup.
• Felhasználói azonosító: felhasználó1

az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"

Láthatja, hogy a parancs WebSocket-kapcsolatot létesített a Web PubSub szolgáltatással, és egy JSON-üzenetet kapott, amely jelzi, hogy sikeresen csatlakozik, és egyedi connectionId:

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

Játsszon vele, és próbáljon meg csatlakozni a csoportokhoz a következő használatával joingroup <group-name> , és küldjön üzeneteket a csoportoknak a következő használatával sendtogroup <group-name>:

joingroup group1

sendtogroup group1 hello

Üzenetek közzététele és az ügyfelek kezelése

Az Azure CLI az webpubsub szolgáltatásparancsokat is biztosít az ügyfélkapcsolatok kezeléséhez.

Nyisson meg egy másik PARANCSSOR-parancsot, és üzeneteket küldhet az ügyfeleknek:

• Központ neve: myHub1.
• Erőforráscsoport neve: myResourceGroup.

az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"

Váltson vissza az előző PARANCSSOR-parancsra, és láthatja, hogy az ügyfél üzenetet kapott:

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

Az összes elérhető parancsot lehetőséggel --help is listázhatja, és lejátszhatja a felsorolt parancsokat.

az webpubsub service --help

Következő lépések

Ez a rövid útmutató alapvető képet nyújt arról, hogyan csatlakozhat a Web PubSub szolgáltatáshoz, és hogyan tehet közzé üzeneteket a csatlakoztatott ügyfelek számára.

A valós alkalmazásokban SDK-kat használhat különböző nyelveken, és létrehozhatja saját alkalmazását. Függvénybővítményeket is biztosítunk a kiszolgáló nélküli alkalmazások egyszerű létrehozásához.

Használja ezeket az erőforrásokat a saját alkalmazás létrehozásához: