حالات استخدام مكتبة واجهة المستخدم
استخدم المكونات والمركبات في مكتبة واجهة مستخدم Azure Communication Services لإنشاء تجارب الاتصال والدردشة في تطبيقاتك.
في مركب، يتم تضمين قدرات المكالمات والدردشة مباشرة وعرضها عند دمج المركب في تطبيق. في مكون واجهة المستخدم، يتم عرض إمكانات الاتصال والدردشة من خلال مجموعة من وظائف واجهة المستخدم والمكتبات الأساسية ذات الحالة. للاستفادة الكاملة من هذه الإمكانات، نوصي باستخدام مكونات واجهة المستخدم مع مكتبات عميل الاتصال والدردشة ذات الحالة.
احصل على المزيد من الوثائق المفاهيمية وقوالب التشغيل السريع والأمثلة في كتاب قصة مكتبة واجهة المستخدم.
حالات استخدام المكالمات
| المنطقة | حالات الاستخدام |
|---|---|
| أنواع المكالمات | الانضمام إلى اجتماع Microsoft Teams |
| الانضمام إلى مكالمة Azure Communication Services باستخدام معرف مجموعة | |
| الانضمام إلى غرفة خدمات اتصالات Azure | |
| بدء مكالمة صادرة لمستخدم Azure Communication Services آخر | |
| بدء مكالمة صادرة إلى رقم هاتف | |
| إمكانية التشغيل التفاعلي لـ Teams | الانضمام إلى ساحة انتظار المكالمات |
| عرض شعار تنبيه النسخ والتسجيل | |
| عناصر تحكم المكالمة | كتم صوت مكالمة وإلغاء كتمها |
| تشغيل الفيديو وإيقاف تشغيله أثناء مكالمة | |
| تشغيل مشاركة الشاشة | |
| إنهاء مكالمة | |
| معرض المشاركين | إظهار المشاركين عن بعد على شبكة |
| توفير معاينة الفيديو خلال مكالمة لمستخدم محلي | |
| توفير الأفاتار الافتراضية عند إيقاف تشغيل الفيديو | |
| إظهار محتوى الشاشة المشتركة في معرض المشاركين | |
| تكوين المكالمة | إدارة جهاز الميكروفون |
| إدارة جهاز الكاميرا | |
| إدارة جهاز السماعة | |
| إتاحة المعاينة المحلية للمستخدم للتحقق من الفيديو | |
| المشاركون | إظهار قائمة المشاركين |
حالات استخدام الدردشة
| المنطقة | دردشة Azure Communication Services | دردشة إمكانية التشغيل التفاعلي في Teams |
|---|---|---|
| أنواع الدردشة | الانضمام إلى مؤشر ترابط دردشة Azure Communication Services | الانضمام إلى دردشة اجتماع Microsoft Teams |
| إجراءات الدردشة | إرسال رسائل نصية وتلقيها | إرسال رسائل نصية وتلقيها |
| إرسال رسائل نصية منسقة وتلقيها* | إرسال رسائل نصية منسقة وتلقيها* | |
| - | تلقي الصور المضمنة | |
| إرسال مرفقات الملفات وتلقيها | تلقي مرفقات الملفات* | |
| أحداث الدردشة | إرسال مؤشرات الكتابة وتلقيها | إرسال مؤشرات الكتابة وتلقيها** |
| إرسال إيصالات القراءة وتلقيها | إرسال إيصالات القراءة وتلقيها | |
| إظهار وقت إضافة مشارك أو إزالته | إظهار وقت إضافة مشارك أو إزالته | |
| المشاركون | إظهار قائمة المشاركين | إظهار قائمة المشاركين |
*إرسال رسائل نصية منسقة ودعم مرفقات الملفات قيد المعاينة العامة حاليا. يتم توفير واجهات برمجة التطبيقات وSDKs للمعاينة دون اتفاقية على مستوى الخدمة. نوصي بعدم استخدامها لأحمال عمل الإنتاج. قد لا تكون بعض الميزات مدعومة، أو قد تكون لها قدرات مقيدة. لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
**قد لا يظهر اسم العرض لحدث الكتابة من مستخدم Teams بشكل صحيح.
الهويات المدعومة
لتهيئة مركب، والمصادقة على الخدمة، يجب أن يكون لدى المستخدم هوية Azure Communication Services. لمزيد من المعلومات، راجع المصادقة على Azure Communication Services و Quickstart: إنشاء رموز الوصول المميزة وإدارتها.
إمكانية التشغيل التفاعلي لـ Teams
بالنسبة لسيناريوهات إمكانية التشغيل التفاعلي ل Teams، يمكنك استخدام المركبات الخاصة بمكتبة واجهة المستخدم لإضافة مستخدم إلى اجتماع Teams عبر Communication Services. لتمكين إمكانية التشغيل التفاعلي ل Teams، استخدم الميزات الافتراضية في مركب المكالمة أو مركب الدردشة، أو استخدم مكونات واجهة المستخدم لإنشاء تجربة مخصصة.
عند إضافة كل من الاتصال والدردشة إلى أحد التطبيقات، من المهم أن تتذكر أنه لا يمكن تهيئة عميل الدردشة حتى يتم قبول المشارك في المكالمة. بعد قبول المشارك، يمكن تهيئة عميل الدردشة للانضمام إلى مؤشر ترابط دردشة الاجتماع. يظهر النمط في الشكل التالي:
إذا كنت تستخدم مكونات واجهة المستخدم لتقديم تجارب التشغيل التفاعلي ل Teams، فابدأ باستخدام أمثلة مكتبة واجهة المستخدم لإنشاء أجزاء رئيسية من التجربة:
- مثال ساحة الانتظار. نموذج ساحة انتظار حيث يمكن للمشارك الانتظار ليتم قبوله في مكالمة.
- شعار التوافق. نموذج شعار يظهر المستخدم إذا كان يتم تسجيل المكالمة.
- نسق Teams. نموذج نسق يجعل عناصر مكتبة واجهة المستخدم تبدو مثل Microsoft Teams.
- مشاركة الصور*. يمكن لعينة من مستخدم Azure Communication Service النهائي تلقي الصور المرسلة من قبل مستخدم Teams.
- مشاركة الملفات*. يمكن لعينة من مستخدم Azure Communication Service النهائي تلقي مرفقات الملفات المرسلة من قبل مستخدم Teams.
التخصيص
استخدم أنماط مكتبة واجهة المستخدم لتعديل المكونات لمطابقة شكل وأسلوب التطبيق الخاص بك. التخصيص هو الفرق الرئيسي بين مكونات المركبات وواجهة المستخدم في Communication Services. تحتوي المركبات على خيارات تخصيص أقل لتجربة تكامل أبسط.
يقارن الجدول التالي مكونات المركبات وواجهة المستخدم لحالات استخدام التخصيص:
| حالة الاستخدام | المركبه | مكونات واجهة المستخدم |
|---|---|---|
| استخدام السمات المستندة إلى Fluent | X | X |
| إنشاء تخطيط التجربة | س | |
| استخدام تصميم CSS لتعديل خصائص النمط | س | |
| استبدال الأيقونات | س | |
| تعديل تخطيط معرض المشاركين | س | |
| تعديل تخطيط التحكم في المكالمة | X | X |
| إدخال نماذج البيانات لتعديل بيانات تعريف المستخدم | X | X |
الملاحظة
يتم فصل بنية إدارة الحالة لمكتبة واجهة المستخدم، بحيث يمكنك الوصول إلى عملاء الاتصال والدردشة المناسبين مباشرة. يمكنك ربط العميل ذي الحالة لقراءة الحالة ومعالجة الأحداث وتجاوز السلوك لتمريره إلى مكونات واجهة المستخدم.
يقارن الجدول التالي مكونات المركبات وواجهة المستخدم لحالات استخدام إمكانية الملاحظة:
| حالة الاستخدام | المركبه | مكونات واجهة المستخدم |
|---|---|---|
| الوصول إلى حالة عميل المكالمة والدردشة | X | X |
| الوصول إلى أحداث العميل ومعالجتها | X | X |
| الوصول إلى أحداث واجهة المستخدم ومعالجتها | X | X |
البنية الموصى بها
تهيئة مكون مركب وقاعدة باستخدام رمز مميز للوصول إلى Azure Communication Services. من المهم الحصول على رموز الوصول المميزة من Communication Services من خلال خدمة موثوق بها تديرها. لمزيد من المعلومات، راجع التشغيل السريع: إنشاء وإدارة رموز الوصول المميزة والبرنامج التعليمي للخدمة الموثوق بها.
يجب أن تحتوي مكتبات عملاء المكالمات والدردشة على سياق المكالمة أو الدردشة التي تنضم إليها. مثل الرموز المميزة لوصول المستخدم، قم بنشر السياق للعملاء باستخدام الخدمة الموثوق بها الخاصة بك.
يلخص الجدول التالي دالات التهيئة وإدارة الموارد المطلوبة لإضافة سياق إلى مكتبة عميل:
| مسؤوليات Contoso | مسؤوليات مكتبة واجهة المستخدم |
|---|---|
| توفير رمز مميز للوصول من Azure | المرور عبر رمز الوصول المميز المتوفر لتهيئة المكونات |
| توفير دالة تحديث | تحديث الرمز المميز للوصول باستخدام دالة يوفرها المطور |
| استرداد معلومات الانضمام إلى المكالمة أو الدردشة وتمريرها | تمرير معلومات الاتصال والدردشة لتهيئة المكونات |
| استرداد معلومات المستخدم وتمريرها لأي نموذج بيانات مخصص | تمرير نموذج بيانات مخصص إلى المكونات للعرض |
دعم النظام الأساسي
| SDK | النوافذ | macOS | Ubuntu | Linux | Android | iOS |
|---|---|---|---|---|---|---|
| UI SDK | Chrome*، Microsoft Edge | Chrome*, Safari** | كروم* | كروم* | كروم* | سفاري** |
* يتم دعم الإصدار الحالي من Chrome والإصدارين السابقين.
** يتم دعم إصدار Safari 13.1 والإصدارات الأحدث. الفيديو الصادر ل Safari macOS غير مدعوم حتى الآن، ولكنه مدعوم لنظام التشغيل iOS. يتم دعم مشاركة الشاشة الصادرة فقط على iOS لسطح المكتب.
إمكانية الوصول
تعد إمكانية الوصول حسب التصميم مبدأ عبر منتجات Microsoft. تتبع مكتبة واجهة المستخدم هذا المبدأ، ويمكن الوصول إلى جميع مكونات واجهة المستخدم بشكل كامل.
الترجمة
الترجمة هي المفتاح لصنع منتجات للمستخدمين في جميع أنحاء العالم والذين يتحدثون لغات مختلفة. توفر مكتبة واجهة المستخدم الدعم الافتراضي لبعض اللغات والقدرات، بما في ذلك اللغات من اليمين إلى اليسار. يمكنك توفير ملفات الترجمة الخاصة بهم لاستخدامها مع مكتبة واجهة المستخدم.
المشكلات المعروفة
- لا تدعم مكتبة واجهة المستخدم تحديث نوع الرسالة عند تحرير الرسائل الموجودة في الوقت الحالي. ستؤدي إضافة تنسيق نص منسق إلى رسالة موجودة إلى إضافة تصميم html إلى محتوى النص. نظرا لأن هذا لا يغير نوع الرسالة، فقد يؤدي إلى عرض محتوى html كنص عادي في مؤشر ترابط الرسالة.
CallComposite استخدم و ChatComposite في مكتبة واجهة مستخدم Azure Communication Services لإنشاء تجارب الاتصال في تطبيقات iOS وAndroid. باستخدام سطرين من التعليمات البرمجية، يمكنك بسهولة دمج تجربة مكالمة ودردشة كاملة في التطبيق الخاص بك. تدير المركبات في Communication Services دورة حياة المكالمة والدردشة بأكملها، من الإعداد حتى انتهاء المكالمة والدردشة.
استدعاء حالات الاستخدام
يمكنك استخدام مركب الاستدعاء في Communication Services لإنشاء حالات الاستخدام هذه:
| المنطقة | حالات الاستخدام |
|---|---|
| أنواع المكالمات | الانضمام إلى اجتماع Microsoft Teams |
| الانضمام إلى اجتماع Microsoft Teams باستخدام معرف الاجتماع ورمز المرور | |
| الانضمام إلى مكالمة باستخدام معرف مجموعة | |
| الانضمام إلى مكالمة باستخدام معرف غرفة | |
| إجراء المكالمات وتلقيها 1:1 | |
| إمكانية التشغيل التفاعلي لـ Teams | الانضمام إلى ساحة انتظار المكالمات |
| عرض شعار تنبيه النسخ والتسجيل | |
| قبول/رفض المشاركين في ساحة الانتظار | |
| التسميات التوضيحية المغلقة | إمكانية التشغيل التفاعلي لـ Teams |
| مكالمة جماعية ومكالمة الغرف ومكالمة 1:1 | |
| معرض المشاركين | إظهار المشاركين عن بعد على شبكة |
| توفير معاينة الفيديو خلال مكالمة لمستخدم محلي | |
| توفير الأفاتار الافتراضية عند إيقاف تشغيل الفيديو | |
| إظهار محتوى الشاشة المشتركة في معرض المشاركين | |
| تمكين تخصيص أفاتار المشارك | |
| إظهار قائمة المشاركين | |
| إدارة المكالمات | إدارة جهاز الميكروفون |
| إدارة جهاز الكاميرا | |
| إدارة جهاز السماعة (سلكي أو Bluetooth) | |
| إتاحة المعاينة المحلية للمستخدم للتحقق من الفيديو | |
| الاشتراك في الأحداث | |
| عناصر تحكم المكالمة | كتم صوت مكالمة وإلغاء كتمها |
| تشغيل الفيديو أو إيقاف تشغيله أثناء مكالمة | |
| إنهاء مكالمة | |
| تعليق مكالمة واستئنافها بعد انقطاع الصوت | |
| CallKit ودعم TelecomManager | |
| تخصيص التجربة | تخصيص شريط الأزرار |
| تكوين العنوان والعنوان الفرعي | |
| تمكين حوار تأكيد مكالمة النهاية | |
| تخطي شاشة الإعداد |
تكامل المكالمات
إمكانية التشغيل التفاعلي لـ Teams
بالنسبة لسيناريوهات إمكانية التشغيل التفاعلي ل Teams، يمكنك استخدام المركبات الخاصة بمكتبة واجهة المستخدم لإضافة مستخدم إلى اجتماع Teams عبر Communication Services. لتمكين إمكانية التشغيل التفاعلي ل Teams، استخدم مكالمة مركبة. يدير المركب دورة الحياة بأكملها للانضمام إلى مكالمة إمكانية التشغيل التفاعلي ل Teams.
يوضح الشكل التالي مثالا على تجربة المستخدم قبل إضافة المتصل إلى اجتماع Teams:
تكامل الغرف
توفر Azure Communication Services مفهوما لغرفة للمطورين الذين يقومون بإنشاء محادثات منظمة مثل المواعيد الظاهرية أو الأحداث الظاهرية. تسمح الغرف حاليا بإجراء مكالمات صوتية ومتصلة بالفيديو.
الغرفة هي حاوية تدير النشاط بين المستخدمين النهائيين ل Azure Communication Services. توفر الغرفة لمطوري التطبيقات تحكما أفضل في من يمكنه الانضمام إلى مكالمة، ومتى يجتمعون وكيفية تعاونهم. لمعرفة المزيد حول الغرف، راجع الوثائق المفاهيمية.
تتم دعوة المستخدم إلى غرفة باستخدام واجهة برمجة تطبيقات الغرف ك 1 من 3 أدوار التالية:
- مقدم العرض (افتراضي)
- الحضور
- المستهلك
يكمن التمييز بين كل دور في القدرات التي يمتلكونها أثناء استدعاء الغرفة عند استخدام CallComposite. يتم تفصيل الإمكانات المحددة المرتبطة بكل دور هنا.
إشعار
تخدم واجهة برمجة تطبيقات الغرف الغرض من إنشاء الغرف وإدارة المستخدمين وتعديل عمر الغرف. من المهم ملاحظة أن واجهة برمجة تطبيقات الغرف هي خدمة خلفية منفصلة عن مكتبة واجهة المستخدم.
مكالمة واحدة إلى واحد ودعم إعلامات PUSH
تدعم مكتبة واجهة المستخدم مكالمة VoIP واحد إلى واحد لطلب المستخدمين بواسطة معرف الاتصال. لتلقي المكالمات الواردة، تدعم مكتبة واجهة مستخدم المكالمات أيضا التسجيل في إشعارات PUSH. لمعرفة المزيد حول تكامل نظام Android وiOS الأساسي واستخدام واجهة برمجة التطبيقات، راجع كيفية إجراء مكالمة واحدة لواحد وتلقي إشعارات PUSH.
ميزات الاتصال
إمكانية الوصول
تعد إمكانية وصول ذوي الاحتياجات الخاصة محور تركيز مكتبات المكالمات. يمكنك استخدام قارئ شاشة لإنشاء إعلانات مهمة حول حالة المكالمة وللمساعدة في التأكد من أن المستخدمين ضعاف البصر يمكنهم المشاركة بفعالية عند استخدام التطبيق.
التسميات التوضيحية المغلقة
تتيح التسميات التوضيحية المغلقة مجموعة واسعة من السيناريوهات، بما في ذلك إمكانية التشغيل التفاعلي مع Teams ومكالمات مجموعة خدمات الاتصالات Azure ومكالمات الغرف والمكالمات الأحادية. تضمن هذه الميزة إمكانية متابعة المستخدمين مع المحادثات في بيئات الاتصال المختلفة، ما يعزز إمكانية الوصول وتجربة المستخدم. ومع ذلك، من المهم ملاحظة أن المستخدمين بحاجة إلى تحديد اللغة يدويا للتسميات التوضيحية باستخدام مكتبة واجهة المستخدم خارج الصندوق، حيث لا يكتشف النظام تلقائيا اللغة المنطوقة.
إشعار
لن تتم فوترة التسميات التوضيحية المغلقة في بداية المعاينة العامة الخاصة بها. هذا لفترة محدودة فقط، من المحتمل أن تتم فوترة استخدام التسميات التوضيحية بدءا من يونيو.
إذا كنت تبحث عن معلومات أكثر تفصيلا حول التسميات التوضيحية المغلقة، فلا تتردد في زيارة الوثائق لمراجعة التفسيرات وإرشادات الاستخدام. بالإضافة إلى ذلك، إذا كنت ترغب في الانتقال مباشرة إلى تكوين التسميات التوضيحية المغلقة مباشرة داخل مكتبة واجهة المستخدم، يمكنك متابعة برنامجنا التعليمي لسهولة الإعداد.
حدث
يمكن للمطورين الآن الاشتراك في الأحداث داخل مكالمة مركبة، ما يمكنهم من إرفاق المستمعين بأحداث معينة طوال دورة حياة المكالمة. يوفر هذا التحسين المزيد من فرص التحكم والتخصيص، ما يسمح للمطورين بتشغيل إجراءات مخصصة استنادا إلى أحداث مثل الانضمام إلى المشاركين، أو ترك المشاركون المكالمة. سواء كان ذلك لتسجيل التفاعلات، أو تحديث واجهات المستخدم ديناميكيا، أو تحسين الوظائف الإجمالية.
لمزيد من المعلومات، راجع How to handle events.
الترجمة
الترجمة هي المفتاح لصنع منتجات للمستخدمين في جميع أنحاء العالم والذين يتحدثون لغات مختلفة. تدعم مكتبة واجهة المستخدم 12 لغة: الإنجليزية والإسبانية والفرنسية والألمانية والإيطالية واليابانية والكورية والهولندية والبرتغالية والروسية والتركية والصينية. كما أنه يدعم اللغات من اليمين إلى اليسار. لمزيد من المعلومات، راجع كيفية إضافة الترجمة إلى تطبيقك.
تعدد المهام وصورة في صورة
تدعم مكتبة واجهة المستخدم الصورة في وضع الصورة لشاشة المكالمة. أثناء إجراء المكالمة، يمكن للمستخدم النقر فوق الزر رجوع على شاشة المكالمة لتمكين تعدد المهام، والذي يعيد المستخدم إلى الشاشة السابقة. إذا تم تمكين صورة في صورة، عرض نظام صورة في صورة للاتصال. لمعرفة المزيد حول تعدد المهام و Picture-in-Picture لكل من نظام Android وiOS الأساسي واستخدام واجهة برمجة التطبيقات، راجع كيفية استخدام Picture-in-Picture.
اتجاه الشاشة
تدعم مكتبة واجهة المستخدم إعداد اتجاه الشاشة لكل شاشة بشكل منفصل قبل تشغيل تجربة المكتبة. يسمح هذا لمطوري التطبيقات بإعداد اتجاه ثابت لتجربة الاتصال، والتي من شأنها محاذاة اتجاه التطبيق الخاص بهم. لمعرفة المزيد حول قائمة الاتجاه المدعوم لكل من نظام Android وiOS الأساسي واستخدام واجهة برمجة التطبيقات، راجع كيفية استخدام ميزة الاتجاه.
حجم الشاشة
يمكنك تكييف مركب استدعاء Azure Communication Services للتكيف مع أحجام الشاشة من 5 بوصات إلى حجم الكمبيوتر اللوحي. استخدم وضع الانقسام ووضع الكمبيوتر اللوحي في مركب المكالمة للحصول على تخطيط كشف المشاركين الديناميكي وتوفير الوضوح في طريقة العرض والتركيز على المحادثة.
| وضع التقسيم | الوضع اللوحي |
|---|---|
|
|
عرض إدخال البيانات
استخدم مكتبة واجهة المستخدم للأنظمة الأساسية الأصلية للأجهزة المحمولة لمنح المشاركين المحليين والنائية خيار تخصيص كيفية ظهورهم كمستخدمين في مكالمة. يمكن للمشارك المحلي اختيار أفاتار محلي واسم عرض مخصص وعنوان التنقل والعنوان الفرعي على شاشة الإعداد عند بدء المكالمة. يمكن للمستخدم البعيد إنشاء أفاتار مخصص عند الانضمام إلى الاجتماع. لمزيد من المعلومات، راجع كيفية تخصيص طريقة عرض ما قبل الاجتماع.
عرض المحتوى المشترك
من خلال مكتبة واجهة المستخدم للأنظمة الأساسية الأصلية للأجهزة المحمولة، يمكن للمشاركين في المكالمات عرض المحتوى المشترك عندما يشارك المشاركون الآخرون شاشاتهم أثناء مكالمة Teams. يمكن للمشارك عن بعد استخدام إيماءات التمدد والتصغير لتكبير المحتوى المشترك أو تصغيره في المكالمة.
عمليات تكامل نظام التشغيل
دعم CallKit
تدعم مكتبة واجهة المستخدم تكامل CallKit للتعامل مع التفاعل مع CallKit للمكالمات. لمعرفة المزيد حول تكامل النظام الأساسي ل iOS واستخدام واجهة برمجة التطبيقات، راجع كيفية استخدام CallKit.
دعم TelecomManager
تدعم مكتبة واجهة المستخدم الآن التكامل مع TelecomManager، ما يسمح بمعالجة وظائف تعليق المكالمة واستئنافها. لمعرفة المزيد حول تكامل نظام Android الأساسي واستخدام واجهة برمجة التطبيقات، راجع كيفية استخدام TelecomManager.
تخصيص تجربة المكالمة
وضع الصوت فقط
يسمح وضع الصوت فقط في مكتبة واجهة المستخدم للمشاركين بالانضمام إلى المكالمات باستخدام الصوت فقط، دون مشاركة الفيديو أو تلقيه. يتم استخدام هذه الميزة للحفاظ على النطاق الترددي وزيادة الخصوصية. عند التنشيط، يقوم وضع الصوت فقط تلقائيا بتعطيل وظائف الفيديو لكل من إرسال التدفقات وتلقيها، ويضبط واجهة المستخدم لتعكس هذا التغيير عن طريق إزالة عناصر التحكم المتعلقة بالفيديو. يمكن تمكين هذا الوضع من خلال تكوين CallComposite، والمزيد من المعلومات المتوفرة من خلال البدء السريع للصوت فقط.
تعطيل مطالبة إنهاء المكالمة
عند تطوير التطبيقات التي تدمج قدرات الاتصال، فإن ضمان تجربة مستخدم سلسة وبديهية أمر بالغ الأهمية. أحد المجالات التي يمكن تبسيط تجربة المستخدم فيها هو أثناء عملية إنهاء المكالمة. على وجه التحديد، قد يجد المطورون أنه من المفيد تعطيل مطالبة تأكيد المكالمة اليسرى التي تظهر عندما يرغب المستخدم في إنهاء المكالمة. هذه الميزة، على الرغم من أنها مفيدة في منع إنهاء المكالمات العرضية، يمكن أن تعوق أحيانا تجربة المستخدم، خاصة في البيئات التي تكون فيها السرعة والكفاءة أمرين حاسمين. كيفية تعطيل تأكيد المكالمة
بيئات الاتصالات السريعة: في إعدادات مثل أرضيات التداول أو مراكز مكالمات الطوارئ أو مراكز خدمة العملاء حيث يجب تنفيذ القرارات والإجراءات بسرعة، يمكن أن تعيق الخطوة الإضافية لتأكيد إنهاء المكالمة كفاءة سير العمل.
تخصيص شريط الأزرار
تسمح الوظيفة للمطورين بإضافة إجراءات جديدة إلى القائمة السياقية أو إزالة الأزرار الحالية في شريط الأزرار، ما يوفر المرونة لتقديم إجراءات مخصصة وتخصيص واجهة المستخدم وفقا لاحتياجات التطبيق المحددة.
- إضافة أزرار مخصصة: يمكن للمطورين إدخال أزرار جديدة في شريط الأزرار السياقية لتشغيل إجراءات مخصصة.
- إزالة الأزرار الموجودة: يمكن إزالة الأزرار الافتراضية غير الضرورية لتبسيط الواجهة: الكاميرا والميكروفون والتحديد الصوتي.
ضع في اعتبارك القيود التالية أثناء تنفيذ هذه الميزة:
- الأيقونات والتسميات: تتم إضافة الأيقونات للإجراءات الجديدة فقط. تحتفظ أيقونات شريط الأزرار بالأيقونات المعرفة مسبقا ويجب أن تكون التسميات موجزة لتناسب بعد القائمة.
- اعتبارات إمكانية وصول ذوي الاحتياجات الخاصة: يجب على المطورين التأكد من إمكانية الوصول إلى جميع الأزرار المخصصة، بما في ذلك التسمية المناسبة لقارئات الشاشة.
| إزالة الأزرار | إضافة إجراءات مخصصة |
|---|---|
|
|
حالات الاستخدام
- إجراءات مخصصة أثناء الاتصال: يمكن لتطبيق الأعمال إضافة زر مخصص "الإبلاغ عن مشكلة"، مما يسمح للمستخدمين بالإبلاغ مباشرة عن المشكلات التقنية أثناء المكالمة.
- العلامة التجارية وتجربة المستخدم: يمكن لتطبيق المؤسسة إزالة الأزرار غير ذات الصلة بحالة الاستخدام وإضافة أزرار ذات علامة تجارية تعزز تجربة المستخدم.
لضمان تجربة اتصال متسقة، نوصي بدمج أيقونات Fluent UI في مشروعك؛ متوفر في مستودع Fluent UI GitHub. من خلال القيام بذلك، تتطابق الأيقونات المخصصة مع تصميم Call Composite، ما يخلق مظهرا متماسكا واحترافية.
أفضل الممارسات
- تصميم نظيف: تجنب اكتظاظ شريط القوائم السياقي. أضف فقط الأزرار الضرورية لتجربة المستخدم.
- اختبار المستخدم: إجراء اختبار المستخدم لضمان أن التخصيصات تلبي احتياجات المستخدم ولا تخلط أو تطغى عليها.
- إضافة آلية تقديم الملاحظات: إذا أضفت أزرارا لإجراءات مثل "مشكلة التقرير"، فتأكد من وجود نظام خلفية قوي للتعامل مع الملاحظات التي تم جمعها، يمكنك إعادة استخدام الآلية التي توفرها مكتبة واجهة المستخدم بشكل افتراضي.
لمزيد من المعلومات، راجع كيفية تخصيص شريط الأزرار.
تخطي شاشة الإعداد
توفر مكتبة واجهة المستخدم القدرة على الانضمام إلى مكالمة تخطي شاشة الإعداد لتجربة الانضمام إلى المكالمة. بشكل افتراضي، يمر المستخدم بشاشة إعداد للانضمام إلى مكالمة. هنا، يقوم المستخدم بتعيين تكوين المكالمة مثل تشغيل الكاميرا أو إيقاف تشغيلها، وتشغيل الميكروفون أو إيقاف تشغيله، واختيار جهاز الصوت قبل الانضمام إلى مكالمة. تتطلب هذه الشاشة تفاعل المستخدم للانضمام إلى مكالمة، والتي قد تكون غير ضرورية لبعض المستخدمين. لذلك نقدم القدرة على الانضمام إلى مكالمة عن طريق تخطي شاشة الإعداد وتوفير واجهات برمجة التطبيقات لتكوين المكالمة. لمزيد من المعلومات، راجع كيفية استخدام تخطي ميزة شاشة الإعداد.
تطبيق السمات
يمكنك استخدام مركب استدعاء مكتبة واجهة المستخدم لنظامي التشغيل iOS وAndroid لإنشاء نسق مخصص لتجربة المتصل. لإنشاء تجربة النظام الأساسي، مرر مجموعة من ألوان النسق كما هو موضح في الجدول التالي. لمزيد من المعلومات، راجع كيفية إنشاء النسق.
| Android | iOS |
|---|---|
|
|
العنوان والعنوان الفرعي
تتيح لك مكتبة واجهة المستخدم إدخال سلاسل مخصصة، مما يسهل تخصيص واجهة الاستدعاء لتناسب احتياجاتك المحددة. يمكنك تخصيص عنوان المكالمة وعنوانها الفرعي، سواء أثناء مرحلة الإعداد أو أثناء إجراء المكالمة.
على سبيل المثال، في بيئة الشركة، يمكنك تعيين العنوان ليعكس جدول أعمال الاجتماع والعنوان الفرعي للإشارة إلى إعلان، وبالنسبة لدعم العملاء، يمكن للوكلاء استخدام العناوين لعرض طبيعة الاستعلام، وتعزيز الوضوح والتواصل.
بالإضافة إلى ذلك، أثناء المكالمات مع المناقشات الحساسة للوقت، يمكنك استخدام العنوان الفرعي لعرض مدة المكالمة، مما يضمن أن جميع المشاركين على دراية بالقيود الزمنية.
لمزيد من المعلومات، تفضل بزيارة البرنامج التعليمي: كيفية إعداد العنوان والعنوان الفرعي.
حالات استخدام الدردشة
هام
هذه الميزة من Azure Communication Services قيد المعاينة حاليا.
يتم توفير واجهات برمجة التطبيقات وSDKs للمعاينة دون اتفاقية على مستوى الخدمة. نوصي بعدم استخدامها لأحمال عمل الإنتاج. قد لا تكون بعض الميزات مدعومة، أو قد تكون لها قدرات مقيدة.
لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
| المنطقة | حالات الاستخدام |
|---|---|
| أنواع الدردشة | الانضمام إلى مؤشر ترابط دردشة Azure Communication Services |
| إجراءات الدردشة | إرسال رسالة دردشة |
| تلقي رسالة دردشة | |
| أحداث الدردشة | إظهار مؤشرات الكتابة |
| إظهار إيصال بالقراءة | |
| إظهار وقت إضافة مشارك أو إزالته | |
| إظهار التغييرات على عنوان الدردشة |
المرونة
ChatComposite تم تصميم ليتناسب مع تخطيطات وطرق عرض مختلفة في التطبيق الخاص بك. على سبيل المثال، يمكنك اختيار وضع الدردشة في طريقة عرض تنقل أو طريقة عرض مشروطة أو طريقة عرض أخرى. من ChatComposite شأنه ضبط نفسه والتأكد من أن المستخدم لديه تجربة سلسة.
| في طريقة عرض التنقل | في طريقة العرض المشروطة |
|---|---|
|
|
الهويات المدعومة
لتهيئة مركب، والمصادقة على الخدمة، يجب أن يكون لدى المستخدم هوية Azure Communication Services. لمزيد من المعلومات، راجع المصادقة على Azure Communication Services و Quickstart: إنشاء رموز الوصول المميزة وإدارتها.
البنية الموصى بها
تهيئة مركب باستخدام رمز مميز للوصول إلى Azure Communication Services. من المهم الحصول على رموز الوصول المميزة من Azure Communication Services من خلال خدمة موثوق بها تديرها. لمزيد من المعلومات، راجع التشغيل السريع: إنشاء وإدارة رموز الوصول المميزة والبرنامج التعليمي للخدمة الموثوق بها.
يجب أن تحتوي مكتبات عملاء المكالمات والدردشة على سياق المكالمة التي تنضم إليها. مثل الرموز المميزة لوصول المستخدم، قم بنشر السياق للعملاء باستخدام الخدمة الموثوق بها الخاصة بك. يلخص الجدول التالي دالات التهيئة وإدارة الموارد المطلوبة لإضافة سياق إلى مكتبة عميل:
| مسؤوليات Contoso | مسؤوليات مكتبة واجهة المستخدم |
|---|---|
| توفير رمز مميز للوصول من Azure | المرور عبر رمز الوصول المميز المتوفر لتهيئة المكونات |
| توفير دالة تحديث | تحديث الرمز المميز للوصول باستخدام دالة يوفرها المطور |
| استرداد معلومات الانضمام إلى المكالمة أو الدردشة وتمريرها | تمرير معلومات الاتصال والدردشة لتهيئة المكونات |
| استرداد معلومات المستخدم وتمريرها لأي نموذج بيانات مخصص | تمرير نموذج بيانات مخصص إلى المكونات للعرض |
دعم النظام الأساسي
| النظام الأساسي | الإصدارات |
|---|---|
| iOS | iOS 14 والإحدث |
| Android | واجهة برمجة التطبيقات 21 والإحدث |
دليل استكشاف الأخطاء وإصلاحها
عند حدوث استكشاف الأخطاء وإصلاحها للمكالمات الصوتية أو مكالمات الفيديو، قد يطلب منك توفير CallID؛ يتم استخدام هذا المعرف لتحديد مكالمات Communication Services.
يمكن استرداد CallID هذا عبر شريط الإجراءات الموجود أسفل شاشة المكالمة؛ ترى زر القطع الناقص؛ بمجرد أن ينفذ المستخدم إجراء الضغط، خيار "مشاركة معلومات التشخيص"؛ يمكن للمستخدم مشاركة معلومات التشخيص المطلوبة لتعقب أي مشكلات من قبل فريق الدعم.
للوصول البرمجي إلى CallID، راجع "كيفية الحصول على معلومات التصحيح برمجيا".
يمكنك معرفة المزيد حول إرشادات استكشاف الأخطاء وإصلاحها هنا: صفحة "استكشاف الأخطاء وإصلاحها في Azure Communication Services".
| شاشة الاتصال | قائمة معلومات التشخيص | مشاركة معرف الاتصال |
|---|---|---|
|
|
|