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.
If you don't have an Azure subscription, create an Azure free account before you begin.
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:
Fontos
Minden Web PubSub-erőforrásnak egyedi névvel kell rendelkeznie. Az alábbi példákban cserélje le <az egyedi erőforrás nevét> a Web PubSub nevére.
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
--namemegadott 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.
Fontos
Cserélje le <az egyedi erőforrás nevét> az előző lépésekből létrehozott Web PubSub-erőforrás nevére.
- 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: