يمكنك تحسين التجربة الإجمالية للمستخدمين من خلال اتّباع هذه الأدلة لتصميم إضافات Google Meet.
أفضل ممارسات التفويض
ننصحك باتّباع أفضل الممارسات التالية لأي إضافات Google Meet تتطلّب المصادقة أو التفويض.
استخدام ميزة "تسجيل الدخول باستخدام حساب Google"
يكون العديد من مستخدمي إضافات Google Workspace قد سجّلوا الدخول إلى Google قبل الانضمام إلى الاجتماع. لذلك، يمكن أن يؤدي توفُّر ميزة "تسجيل الدخول بنقرة واحدة" كخيار إلى توفير عدة نقرات على المستخدمين عند اتّباع عملية تسجيل الدخول. لمزيد من المعلومات، اطّلِع على مقالة إدارة طُرق تسجيل الدخول للإضافة.
فتح صفحة تسجيل الدخول التابعة لجهة خارجية في نافذة جديدة
بالإضافة إلى تسجيل الدخول باستخدام حساب Google، قد يقدّم تطبيقك آليات إضافية لتسجيل الدخول. في هذه الحالة، استخدِم نافذة حوار بدلاً من فتح صفحة تسجيل الدخول في علامة تبويب جديدة. بهذه الطريقة، سيظل بإمكان المستخدم الاطّلاع على مكالمة Meet والعودة إليها، وسيؤدي ذلك إلى تقليل عدد النقرات الإجمالية.
طلب النطاقات بشكلٍ صحيح لواجهات Google APIs
إذا كانت إضافة Meet تستدعي واجهات Google APIs، حينئذٍ عليك تقديم قائمة كاملة بنطاقات OAuth التي تتطلبها الإضافة. يتم ذلك في صفحة "إعدادات التطبيق" في Google Workspace Marketplace. بعد إضافة هذه النطاقات، يظهر للمستخدمين طلب عند تثبيت إضافة Meet يوضّح لهم نوع البيانات التي يسمحون لتطبيقك بالوصول إليها.
قبل نشر الإضافة، عليك أيضًا إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. يتطلّب ذلك إضافة نطاقات التفويض نفسها تمامًا من "إعدادات التطبيق" في Google Workspace Marketplace. يتطلّب إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth أيضًا ضبط معلومات العلامة التجارية وسياسة الخصوصية وبنود الخدمة التي تظهر عند طلب النطاقات. للنشر بشكلٍ علني، يجب إرسال كل هذه المعلومات للتحقّق منها.
عند كتابة رمز لاستدعاء Google Workspace APIs، فإنّ اتّباع دليل البدء السريع في JavaScript هو أسهل طريقة للبدء. يتّبع هذا النهج أفضل الممارسات لاستخدام ميزة "تسجيل الدخول باستخدام حساب Google" ونوافذ الحوار. يُرجى العِلم أنّ تهيئة عميل الرمز المميّز في JavaScript تتطلّب طلب النطاقات التي يستخدمها التطبيق فعليًا في وقت التشغيل بشكلٍ منفصل. لتقديم أفضل تجربة للمستخدمين، يجب أن تتطابق هذه النطاقات المطلوبة مع النطاقات في صفحة "إعدادات التطبيق" في Google Workspace Marketplace. توفّر هذه الميزة الاحتياطية حلاً بديلاً في حال ألغى المستخدم النطاقات.
أفضل ممارسات الصيانة
تتعلّق أفضل الممارسات التالية بكتابة تطبيقات ويب قابلة للصيانة، ولكنّها مهمة بشكلٍ خاص عند كتابة أي إضافات Meet.
استخدام أحدث إصدار من حزمة تطوير إضافات Google Meet
يتم تعديل حزمة تطوير إضافات Meet بانتظام. تتّبع حزمة تطوير البرامج (SDK) نظام الترقيم الدلالي للإصدارات. للعثور على أحدث إصدار:
- عند استخدام gstatic: يتضمّن أحدث إصدار من حزمة تطوير البرامج (SDK) عنوان URL لـ gstatic الوارد في تعليمات استخدام حزمة تطوير البرامج (SDK).
- عند استخدام npm: شغِّل الأمر
npm update @googleworkspace/meet-add-onsمن داخل الدليل الذي يحتوي على ملفpackage.jsonللموقع الإلكتروني الذي يستضيف إضافة Meet.
إنشاء مشروع مرحلة الإعداد على Google Cloud
بعد نشر إضافة Google Meet على Google Workspace Marketplace، تصبح أي عمليات نشر جديدة لإضافة Google Meet متاحة على الفور لمستخدمي Meet. سيظهر للمستخدمين هذه التحديثات فور إفراغ ذاكرات التخزين المؤقت أو انتهاء صلاحيتها. لذلك، ننصحك بعدم نشر التغييرات على موقعك الإلكتروني المخصّص للإنتاج إلى أن يتم اختبار التغييرات بدقة.
لتجنُّب النشر مباشرةً إلى قناة الإنتاج، ننصحك بـ إنشاء مشروع منفصل على Google Cloud يتم نشره بشكلٍ خاص لمؤسستك. سيستضيف مشروع على السحابة الإلكترونية هذا كلاً من بيئتَي الإعداد والتطوير لإضافة Meet. يجب أن يقتصر الوصول إلى مشروع على السحابة الإلكترونية هذا على فريق صغير يعمل مباشرةً على تطوير الإضافة.
لإنشاء هذه البيئات البديلة للإضافة، عليك أولاً استضافة بيئات بديلة لتطبيق الويب الذي يحتوي على الإضافة على نطاق تملكه. بعد ذلك، يمكنك إنشاء بيئات بديلة لإضافة Meet من خلال إضافة عمليات نشر إضافية إلى مشروع مرحلة الإعداد على Google Cloud. يجب أن تتضمّن عمليات النشر الجديدة هذه ملفات بيان تشير إلى البيئات البديلة لتطبيق الويب. بعد ذلك، ننصحك بتثبيت كل بيئة إضافة على النحو التالي:
- مرحلة الإعداد: انشر إصدار مرحلة الإعداد بشكلٍ خاص ليتمكّن أي مستخدم في مؤسستك من المساعدة في الاختبار.
- التطوير: انقر على تثبيت ضمن عمود الإجراءات لتثبيت إصدار تطوير إضافة Meet على حسابك فقط.
كتابة الاختبارات
قبل نشر إضافة Meet في بيئة تطوير، ننصحك بكتابة اختبارات الوحدة. يجب أن تتضمّن اختبارات الوحدة ما يلي:
- محاكاة حزمة تطوير إضافات Meet، ثم التأكّد من أنّ إضافة Meet تستدعي وظائف حزمة تطوير البرامج (SDK) على النحو المتوقّع.
- إجراء اختبارات الوحدة لكل الوظائف غير المرتبطة بحزمة تطوير البرامج (SDK) في الإضافة باستخدام إطار اختبار الويب المفضّل لديك.
أفضل ممارسات تجربة المستخدم
تساعد أفضل الممارسات التالية في جعل إضافة Meet أكثر سهولة في الاستخدام ودقة.
إدارة جميع حالات البدء في اللوحة الجانبية
ننصحك بشدة بإعداد الإضافة استنادًا إلى
إجراءات المستخدمين في اللوحة الجانبية.
يتم ذلك من خلال ضبط حالة بدء النشاط
في
JavaScript. يجب أن يتم ضبط جميع البيانات التي يتم إدخالها في
ActivityStartingState
من قِبل من بدأ الإضافة (عادةً
مضيف الاجتماع) ضمن اللوحة الجانبية. يمكنك اعتبار العرض الأول للوحة الجانبية نموذجًا يتحكّم في إعداد الإضافة.
إغلاق اللوحة الجانبية عند عدم استخدامها
بعد بدء النشاط من خلال استدعاء الطريقة
startActivity()
، يجب أن تظل اللوحة
الجانبية مفتوحة فقط إذا كانت جزءًا أساسيًا
من تجربة المستخدم لإضافة Google Meet. يمكنك إغلاق
اللوحة الجانبية بعد فتح المرحلة الرئيسية
من خلال استدعاء
unloadSidePanel()
الطريقة.
الترويج لإضافة Meet من خلال مشاركة الشاشة
تقدّم إضافات Meet تجربة أفضل من مشاركة الشاشة. ومع ذلك، اعتاد العديد من المستخدمين استخدام ميزة مشاركة الشاشة في Meet. إذا شارك أحد المستخدمين علامة تبويب تعرض الموقع الإلكتروني الذي يستضيف إضافة Meet، يمكن ضبط Meet لعرض بانر لجميع المشاركين في المكالمة يطلب منهم تثبيت إضافة Meet المقابلة أو استخدامها. لمزيد من المعلومات، اطّلِع على مقالة الترويج للإضافة من خلال مشاركة الشاشة.
إرشادات تصميم الشعارات
اتّبِع هذه الإرشادات عند تصميم شعارك الخاص بـ Meet لضمان ظهوره بأفضل شكل الآن وفي المستقبل:
استخدِم تنسيق ملف PNG، واضبط حجمه على 256 × 256 بكسل.
استخدِم الشفافية.
تأكَّد من أنّ شعار الوضع الداكن يبدو جيدًا في الوضع الداكن باستخدام أدوات المطوّرين لإضافات Meet.
تأكَّد من أنّ شعارك (وأصول الرسومات الأخرى) تبدو جيدة في وضع التباين العالي باستخدام أداة للتحقّق من التباين، مثل Contrast Checker من Web Accessibility In Mind (WebAIM).
التزِم بمتطلبات الرسومات لعمليات دمج تطبيقات معيّنة.
لا تضمِّن مساحة متروكة في الصورة. بدلاً من ذلك، وسِّع الصورة لتصل إلى حدود ملفك.