التشغيل السريع- الاتصال بمثيل Azure Web PubSub وتشغيله
يوضح لك هذا التشغيل السريع كيفية الاتصال بمثيل Azure Web PubSub ونشر الرسائل إلى العملاء المتصلين باستخدام Azure CLI.
إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
المتطلبات الأساسية
استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.
عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
- يتطلب هذا التشغيل السريع استخدام الإصدار 2.22.0 أو أحدث من CLI Azure. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.
إنشاء مجموعة موارد
وتُعد مجموعة الموارد عبارة عن حاوية منطقية يتم فيها توزيع موارد Azure وإدارتها. استخدم الأمر az group create لإنشاء مجموعة موارد باسم myResourceGroup في eastus الموقع.
az group create --name myResourceGroup --location EastUS
إنشاء مثيل Web PubSub
قم بتشغيل ملحق az add لتثبيت أو ترقية ملحق webpubsub إلى الإصدار الحالي.
az extension add --upgrade --name webpubsub
استخدم الأمر Azure CLI az webpubsub create لإنشاء Web PubSub في مجموعة الموارد التي قمت بإنشائها. ينشئ الأمر التالي مورد Web PubSub مجاني ضمن مجموعة الموارد myResourceGroup في EastUS:
هام
يجب أن يكون لكل مورد Web PubSub ويب اسمًا فريدًا. استبدل <your-unique-resource-name> باسم Web PubSub في الأمثلة التالية.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
يظهر إخراج هذا الأمر خصائص المورد المنشأ حديثًا. دوّن اثنتين من الخصائص المذكورة أدناه:
- اسم المورد: الاسم الذي قدمته للمعلمة
--nameأعلاه. - اسم المضيف: في المثال، اسم المضيف هو
<your-unique-resource-name>.webpubsub.azure.com/.
في هذه المرحلة، حساب Azure هو الوحيد المصرح به لتنفيذ أي عمليات على هذا المورد الجديد.
تشغيل المثيل
الاتصال بالخدمة
استخدم أمر az webpubsub clientلـ Azure CLI لبدء اتصال عميل WebSocket بالخدمة التي تم إنشاؤها من الخطوة السابقة، مما يوفر المعلومات التالية:
- اسم المركز: سلسلة من 1 إلى 127 حرفًا. يجب أن تبدأ بأحرف أبجدية
(a-z, A-Z)وأن تحتوي فقط على أحرف وأرقام(0-9, a-z, A-Z)أو شرطة سفلية(_).
المركز هو مجموعة منطقية من اتصالات WebSocket المتصلة. تحقق من المراكز والمجموعات والاتصالات للحصول على تفاصيل حول المفاهيم.
هام
استبدل <your-unique-resource-name> باسم مورد Web PubSub الذي تم إنشاؤه من الخطوات السابقة.
- اسم المحور: myHub1.
- اسم مجموعة الموارد: myResourceGroup.
- معرف المستخدم: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"
يمكنك ملاحظة أن الأمر قام بتأسيس اتصال WebSocket بخدمة Web PubSub وقد تلقيت رسالة JSON تشير إلى أنه الآن متصل بنجاح، ويتم تعيينه مع connectionId فريد:
{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}
العب بها وحاول الانضمام إلى المجموعات باستخدام joingroup <group-name>وأرسل الرسائل إلى المجموعات باستخدام sendtogroup <group-name>:
joingroup group1
sendtogroup group1 hello
نشر الرسائل وإدارة العملاء
يوفر Azure CLI أيضًا أوامر خدمة webpubsub az لإدارة اتصالات العميل.
افتح أمر CLI آخر ثم يمكنك بث الرسائل إلى العملاء:
- اسم المحور: myHub1.
- اسم مجموعة الموارد: myResourceGroup.
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"
التبديل مرة أخرى إلى الأمر CLI السابق، ويمكنك مشاهدة تلقي رسالة العميل:
{"type":"message","from":"server","dataType":"text","data":"Hello World"}
يمكنك أيضًا سرد كافة الأوامر المتوفرة باستخدام الخيار --help والتحكم في الأوامر المذكورة.
az webpubsub service --help
الخطوات التالية
يعطيك هذا البرنامج التعليمي فكرة أساسية حول كيفية الاتصال بخدمة Web PubSub ونشر الرسائل للعملاء المتصلين.
في تطبيقات العالم الحقيقي، يمكنك استخدام SDK في لغات مختلفة لبناء تطبيقك. كما نوفر لك ملحقات Function لبناء تطبيقات بلا خادم بسهولة.
استخدم هذه الموارد لبدء إنشاء التطبيق الخاص بك: