حالات استخدام مكتبة واجهة المستخدم
ملاحظة
للحصول على وثائق مفصلة عن مكتبة واجهة المستخدم ، تفضل بزيارة كتاب قصص مكتبة واجهة المستخدم . هناك ستجد وثائق مفاهيمية إضافية ، وبدايات سريعة وأمثلة.
تدعم مكتبة واجهة المستخدم العديد من الحالات عبر تجارب الاتصال والدردشة. تتوفر هذه الإمكانات من خلال مكونات واجهة المستخدم ومركباتها. بالنسبة للمركبات ، يتم تضمين هذه الإمكانات مباشرة وكشفها عند دمج المركب في أحد التطبيقات. بالنسبة لمكونات واجهة المستخدم، يتم الكشف عن هذه الإمكانات من خلال مجموعة من وظائف واجهة المستخدم ومكتبات الحالة الأساسية. للاستفادة الكاملة من هذه الإمكانات، نوصي باستخدام مكونات واجهة المستخدم مع مكتبات المكالمات وعملاء الدردشة الرائعة.
حالات استخدام المكالمات
| المجال | استخدام الحالات |
|---|---|
| أنواع المكالمات | انضم إلى اجتماع Teams |
| انضم إلى مكالمة خدمات اتصالات Azure باستخدام معرف المجموعة | |
| Teams Interop | ردهة الاتصال |
| بانر تنبيه النسخ والتسجيل | |
| عناصر التحكم في المكالمات | كتم الصوت/إلغاء كتم صوت المكالمة |
| تشغيل / إيقاف تشغيل الفيديو عند الطلب | |
| مشاركة الشاشة | |
| إنهاء المكالمة | |
| معرض المشاركين | يتم عرض المشاركين عن بعد على الشبكة |
| معاينة الفيديو متاحة في جميع أنحاء المكالمة للمستخدم المحلي | |
| تتوفر الصور الرمزية الافتراضية عند إيقاف تشغيل الفيديو | |
| محتوى الشاشة المشترك المعروض في معرض المشاركين | |
| تكوين المكالمات | إدارة جهاز الميكروفون |
| إدارة أجهزة الكاميرا | |
| إدارة جهاز مكبر الصوت | |
| تتوفر معاينة محلية للمستخدم للتحقق من الفيديو | |
| المشاركون | قائمة المشاركين |
حالات استخدام الدردشة
| المجال | استخدام الحالات |
|---|---|
| أنواع الدردشة | الانضمام إلى دردشة اجتماع Teams |
| الانضمام إلى سلسلة محادثات خدمات اتصالات Azure | |
| إجراءات الدردشة | إرسال رسالة دردشة |
| تلقي رسالة دردشة | |
| أحداث الدردشة | مؤشرات الكتابة |
| إيصال القراءة | |
| تمت إضافة/إزالة المشارك | |
| تم تغيير عنوان الدردشة | |
| المشاركون | قائمة المشاركين |
الهويات المدعومة
يلزم وجود هوية Azure Communications Services لتهيئة مكتبات العميل ذات الحالة ومصادقة الخدمة. لمزيد من المعلومات حول المصادقة، راجع رموز المصادقةوالوصول
Teams حالة استخدام التشغيل البيني
بالنسبة Teams سيناريوهات Interop، يمكن للمطورين استخدام مكونات مكتبة واجهة المستخدم للانضمام إلى اجتماعات Teams من خلال خدمات اتصالات Azure. لتمكين Teams Interop، يمكن للمطورين إما استخدام مركبات الاتصال والدردشة مباشرة أو استخدام مكونات واجهة المستخدم لإنشاء تجربة مخصصة. عند تمكين التطبيقات مع كل من الاتصال والدردشة ، من المهم أن تتذكر أنه لا يمكن تهيئة عميل الدردشة حتى يتم قبول المشارك في المكالمة. بمجرد القبول ، يمكن تهيئة عميل الدردشة للانضمام إلى سلسلة محادثات الاجتماع. انظر الرسم البياني أدناه للحصول على الإرشادات:
عند استخدام مكونات واجهة المستخدم لتقديم تجارب Interop Teams، توفر مكتبة واجهة المستخدم أمثلة للأجزاء الرئيسية من التجربة. على سبيل المثال:
- مثال اللوبي: نموذج لوبي للمشارك لانتظار قبوله في المكالمة.
- شعار الامتثال: نموذج لافتة لإظهار المستخدم ما إذا كان يتم تسجيل المكالمة أم لا.
- نسق Teams: نموذج نسق يجعل مكتبة واجهة المستخدم تبدو وكأنها Microsoft Teams.
التخصيص
تعرض مكتبة واجهة المستخدم أنماطا للمطورين لتعديل المكونات لتناسب شكل وأسلوب تطبيقهم. تعد هذه القدرات مجالا رئيسيا للتمييز بين المركبات ومكونات واجهة المستخدم ، حيث توفر المركبات خيارات تخصيص أقل لصالح تجربة تكامل أبسط.
| حالة الاستخدام | المركبه | مكونات واجهة المستخدم |
|---|---|---|
| Fluent القائمة على السمات | X | X |
| تخطيط التجربة قابل للتركيب | X | |
| يمكن استخدام CSS Styling لتعديل خصائص النمط | X | |
| يمكن استبدال الرموز | X | |
| يمكن تعديل تخطيط معرض المشاركين | X | |
| يمكن تعديل تخطيط التحكم في المكالمات | X | X |
| يمكن حقن نماذج البيانات لتعديل البيانات الوصفية للمستخدم | X | X |
الملاحظة
كجزء من بنية إدارة الحالة المنفصلة لمكتبة واجهة المستخدم ، يمكن للمطورين الوصول إلى عملاء الاتصال والدردشة المميزين مباشرة.
يمكن للمطورين الارتباط بالعميل المزود بحالة لقراءة الحالة والتعامل مع الأحداث وتجاوز السلوك لتمريره إلى مكونات واجهة المستخدم.
| حالة الاستخدام | المركبه | مكونات واجهة المستخدم |
|---|---|---|
| يمكن الوصول إلى حالة عميل الاتصال / الدردشة | X | X |
| يمكن الوصول إلى أحداث العميل والتعامل معها | X | X |
| يمكن الوصول إلى أحداث واجهة المستخدم والتعامل معها | X | X |
الهندسة المعمارية الموصى بها
تتم تهيئة المكونات المركبة والأساسية باستخدام رمز وصول Azure Communication Services. يجب شراء رموز الوصول المميزة من خدمات اتصالات Azure من خلال خدمة موثوق بها تديرها. راجع التشغيل السريع: إنشاء رموز Access والبرنامجالتعليمي للخدمة الموثوق بها لمزيد من المعلومات.
تتطلب مكتبات العملاء هذه أيضا سياق المكالمة أو الدردشة التي سينضمون إليها. على غرار الرموز المميزة لوصول المستخدم ، يجب نشر هذا السياق للعملاء عبر خدمتك الموثوق بها. تلخص القائمة أدناه وظائف التهيئة وإدارة الموارد التي تحتاج إلى تشغيلها.
| مسؤوليات كونتوسو | مسؤوليات مكتبة واجهة المستخدم |
|---|---|
| توفير رمز الوصول المميز من Azure | المرور عبر رمز الوصول المعطى لتهيئة المكونات |
| توفير وظيفة التحديث | تحديث رمز الوصول باستخدام الوظيفة المقدمة من المطور |
| استرداد / تمرير معلومات الانضمام للاتصال أو الدردشة | تمرير معلومات المكالمات والدردشة لتهيئة المكونات |
| استرداد/تمرير معلومات المستخدم لأي نموذج بيانات مخصص | تمرير نموذج البيانات المخصصة إلى المكونات لعرضها |
دعم النظام الأساسي
| SDK | Windows | macOS | Ubuntu | Linux | Android | iOS |
|---|---|---|---|---|---|---|
| SDK لواجهة المستخدم | كروم*، إدج الجديدة | كروم*، سفاري** | كروم* | كروم* | كروم* | رحلات السفاري** |
*تجدر الإشارة إلى أن أحدث إصدار من Chrome مدعوم بالإضافة إلى الإصدارين السابقين.
**لاحظ أن إصدارات Safari 13.1+ مدعومة. الفيديو الصادر ل Safari macOS غير مدعوم بعد، ولكنه مدعوم على iOS. لا يتم دعم مشاركة الشاشة الصادرة إلا على سطح المكتب iOS.
إمكانية الوصول لذوي الاحتياجات الخاصة
تعد إمكانية الوصول حسب التصميم مبدأ عبر منتجات Microsoft. تتبع مكتبة واجهة المستخدم هذا المبدأ في التأكد من إمكانية الوصول الكامل إلى جميع مكونات واجهة المستخدم.
الترجمة
يعد التوطين مفتاحا لصنع منتجات يمكن استخدامها في جميع أنحاء العالم ومن قبل الأشخاص الذين يتحدثون لغات مختلفة. ستوفر مكتبة واجهة المستخدم دعما جاهزا لبعض اللغات والإمكانات مثل RTL. يمكن للمطورين توفير ملفات الترجمة الخاصة بهم لاستخدامها في مكتبة واجهة المستخدم.
هام
هذه الميزة من خدمات اتصالات Azure موجودة حاليًا في المعاينة العامة. يتم توفير APIs وSDKs للمعاينة بدون اتفاقية مستوى الخدمة، ولا يوصى بها لأحمال العمل الإنتاجية. بعض الميزات ربما لا تكون مدعمة أو قد يكون بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
تدعم مكتبة واجهة المستخدم المحمولة لنظامي التشغيل iOS وAndroid حالات استخدام المكالمات باستخدام مركب الاتصال. تمكن المركبات المطورين من دمج تجربة اتصال كاملة بسهولة في تطبيقاتهم باستخدام سطرين فقط من التعليمات البرمجية ؛ تعتني هذه المركبات بدورة حياة المكالمة بأكملها من الإعداد إلى نهاية المكالمة.
الاتصال
| المجال | استخدام الحالات |
|---|---|
| أنواع المكالمات | انضم إلى اجتماع Teams |
| انضم إلى مكالمة خدمات اتصالات Azure باستخدام معرف المجموعة | |
| Teams Interop | ردهة الاتصال |
| بانر تنبيه النسخ والتسجيل | |
| معرض المشاركين | يتم عرض المشاركين عن بعد على الشبكة |
| معاينة الفيديو متاحة في جميع أنحاء المكالمة للمستخدم المحلي | |
| تتوفر الصور الرمزية الافتراضية عند إيقاف تشغيل الفيديو | |
| محتوى الشاشة المشترك المعروض في معرض المشاركين | |
| قائمة المشاركين | |
| تكوين المكالمات | إدارة جهاز الميكروفون |
| إدارة أجهزة الكاميرا | |
| إدارة جهاز مكبر الصوت (بلوتوث سلكي & مدعوم) | |
| تتوفر معاينة محلية للمستخدم للتحقق من الفيديو | |
| عناصر التحكم في المكالمات | كتم الصوت/إلغاء كتم صوت المكالمة |
| تشغيل / إيقاف تشغيل الفيديو عند الطلب | |
| إنهاء المكالمة |
الهويات المدعومة
يلزم وجود هوية Azure Communications Services لتهيئة المركبات والمصادقة على الخدمة. لمزيد من المعلومات حول المصادقة، راجع رموز المصادقةوالوصول
Teams Interop
بالنسبة Teams سيناريوهات Interop، يمكن للمطورين استخدام مكونات مكتبة واجهة مستخدم الجوال للانضمام إلى اجتماعات Teams من خلال خدمات اتصالات Azure. لتمكين Teams Interop ، يمكن للمطورين استخدام مركب الاتصال ، والذي سيعتني بدورة حياة الانضمام إلى مكالمة Interop Teams.
عرض المحتوى المشترك
توفر مكتبة واجهة المستخدم المتنقلة إمكانية المشاركين في الاتصال لعرض المحتوى المشترك عندما يشارك المشاركون الآخرون شاشاتهم أثناء الاتصال. أيضا ، يمكن للمشارك التكبير على الشاشة ، مما يجعل إيماءات القرص فوق الشاشة للحصول على نظرة أفضل على المحتوى المشترك.
النسق
يوفر مركب استدعاء مكتبة واجهة المستخدم لنظامي التشغيل iOS وAndroid القدرة للمطورين على تحديث موضوع التجربة بأكملها عن طريق تمرير لون أساسي. يستخدم المركب هذا اللون الأساسي لتوفير نسق مناسب عبر التجربة.
| Android | iOS |
|---|---|
|
|
حجم الشاشة
يوفر مركب المكالمات التكيف مع أي حجم شاشة من شأنه أن يجلب الدعم من شاشات 5 بوصات إلى الأجهزة اللوحية ، والحصول على تخطيط قائمة المشاركين الديناميكي ، وتوفير الوضوح في العرض ، والتركيز على المحادثة.
| وضع الانقسام | وضع الكمبيوتر اللوحي |
|---|---|
|
|
الترجمة
يعد التوطين مفتاحا لصنع منتجات يمكن استخدامها في جميع أنحاء العالم ومن قبل الأشخاص الذين يتحدثون لغات مختلفة.
التوطين هو مفتاح صنع المنتجات التي يمكن استخدامها في جميع أنحاء العالم. توفر مكتبة واجهة المستخدم المتنقلة الآن الدعم ل 13 لغة: الإنجليزية والإسبانية والفرنسية والألمانية والإيطالية واليابانية والكورية والهولندية والبرتغالية والروسية والتركية والصينية وقدرات RTL.
الهندسة المعمارية الموصى بها
تتم تهيئة المركبات باستخدام رمز وصول Azure Communication Services. يجب شراء رموز الوصول المميزة من خدمات اتصالات Azure من خلال خدمة موثوق بها تديرها. راجع التشغيل السريع: إنشاء رموز Access والبرنامجالتعليمي للخدمة الموثوق بها لمزيد من المعلومات.
تتطلب مكتبات العملاء هذه أيضا سياق المكالمة التي سينضمون إليها. على غرار الرموز المميزة لوصول المستخدم ، يجب نشر هذا السياق للعملاء عبر خدمتك الموثوق بها. تلخص القائمة أدناه وظائف التهيئة وإدارة الموارد التي تحتاج إلى تشغيلها.
| مسؤوليات كونتوسو | مسؤوليات مكتبة واجهة المستخدم |
|---|---|
| توفير رمز الوصول المميز من Azure | المرور عبر رمز الوصول المعطى لتهيئة المكونات |
| توفير وظيفة التحديث | تحديث رمز الوصول باستخدام الوظيفة المقدمة من المطور |
| استرداد / تمرير معلومات الانضمام للاتصال أو الدردشة | تمرير معلومات المكالمات والدردشة لتهيئة المكونات |
| استرداد/تمرير معلومات المستخدم لأي نموذج بيانات مخصص | تمرير نموذج البيانات المخصصة إلى المكونات لعرضها |
دعم النظام الأساسي
| النظام الأساسي | الإصدارات |
|---|---|
| iOS | آي أو إس ١٤ بلس |
| Android | الإصدار 21+ |