يمكنك تحسين تجربة المستخدمين بشكل عام من خلال اتّباع هذه الأدلة الخاصة بتصميم إضافات Google Meet.
أفضل الممارسات المتعلّقة بمنح الإذن
ننصحك باتّباع أفضل الممارسات التالية لأي إضافات في Google Meet تتطلّب المصادقة أو التفويض.
استخدام ميزة "تسجيل الدخول باستخدام حساب Google"
يكون العديد من مستخدمي إضافات Google Workspace قد سجّلوا الدخول إلى Google قبل الانضمام إلى الاجتماع. لذلك، يمكن أن يوفّر توفّر Google One Tap كخيار على المستخدمين عدة نقرات عند اتّباع خطوات تسجيل الدخول. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة طرق تسجيل الدخول إلى الإضافة.
فتح صفحة تسجيل الدخول التابعة لجهة خارجية في نافذة جديدة
بالإضافة إلى ميزة "تسجيل الدخول باستخدام حساب Google"، قد يوفّر تطبيقك آليات إضافية لتسجيل الدخول. في هذه الحالة، استخدِم نافذة حوار بدلاً من فتح صفحة تسجيل الدخول في علامة تبويب جديدة. بهذه الطريقة، سيظل بإمكان المستخدم رؤية مكالمة Meet والرجوع إليها، وسيتمكّن من إجراء عدد أقل من النقرات بشكل عام.
طلب النطاقات بشكل صحيح لواجهات Google APIs
إذا كانت إضافة Meet تستدعي واجهات Google APIs، عليك تقديم قائمة كاملة بنطاقات OAuth التي تتطلبها الإضافة. يتم ذلك في صفحة "ضبط تطبيقات Google Workspace Marketplace". بعد إضافة هذه النطاقات، ستظهر للمستخدمين رسالة عند تثبيت إضافة Meet، توضّح لهم نوع البيانات التي يسمحون لتطبيقك بالوصول إليها.
قبل نشر الإضافة، عليك أيضًا إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. يتطلّب ذلك إضافة نطاقات الأذونات نفسها تمامًا من إعدادات تطبيقك على Google Workspace Marketplace. يتطلّب إعداد شاشة موافقة OAuth أيضًا ضبط معلومات العلامة التجارية وسياسة الخصوصية وبنود الخدمة التي يتم عرضها عند طلب النطاقات. لنشر هذه المعلومات بشكل علني، يجب إرسالها للتحقّق منها.
عند كتابة رمز برمجي لاستدعاء واجهات Google Workspace API، فإنّ اتّباع دليل البدء السريع في JavaScript هو أسهل طريقة للبدء. يتوافق هذا الأسلوب مع أفضل الممارسات المتعلّقة باستخدام ميزة "تسجيل الدخول باستخدام حساب Google" ونوافذ الحوار. يُرجى العِلم أنّ تهيئة برنامج الرمز المميّز في JavaScript تتطلّب طلب النطاقات التي يستخدمها التطبيق فعليًا أثناء وقت التشغيل بشكل منفصل. لضمان تقديم أفضل تجربة للمستخدم، يجب أن تتطابق النطاقات المطلوبة مع النطاقات الواردة في صفحة "إعدادات التطبيق" في Google Workspace Marketplace. توفّر هذه الزيادة احتياطًا للتعامل مع الحالات التي ألغى فيها المستخدم نطاقات.
أفضل الممارسات المتعلّقة بالصيانة
تتعلّق أفضل الممارسات التالية بكتابة تطبيقات ويب يسهل صيانتها، ولكنّها مهمة بشكل خاص عند كتابة أي إضافات إلى Meet.
استخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لإضافات Google Meet
يتم تعديل حزمة تطوير البرامج (SDK) لإضافات Meet بانتظام. تلتزم حزمة تطوير البرامج (SDK) بالإصدارات الدلالية. للعثور على أحدث إصدار، اتّبِع الخطوات التالية:
- عند استخدام gstatic: يتضمّن عنوان URL الخاص بـ gstatic أحدث إصدار من حزمة SDK، ويمكنك العثور عليه في تعليمات استخدام حزمة SDK.
- عند استخدام npm: شغِّل
npm update @googleworkspace/meet-add-onsمن داخل الدليل الذي يحتوي علىpackage.jsonللموقع الإلكتروني الذي يستضيف إضافة Meet.
إنشاء مشروع تجريبي على Google Cloud
بعد نشر إضافة Google Meet على Google Workspace Marketplace، تتوفّر أي عمليات نشر جديدة لإضافة Google Meet على الفور لمستخدمي Meet. ستظهر هذه التحديثات للمستخدمين فور إفراغ ذاكرات التخزين المؤقت أو انتهاء صلاحيتها. لذلك، ننصحك بعدم نشر التغييرات على موقعك الإلكتروني المباشر إلى أن يتم اختبارها بدقة.
لتجنُّب النشر مباشرةً في بيئة الإنتاج، ننصحك بإنشاء مشروع منفصل على Google Cloud يتم نشره بشكل خاص لمؤسستك. سيستضيف مشروع Google Cloud هذا كلاً من بيئة التشغيل التجريبي وبيئة التطوير الخاصة بإضافة Meet. يجب أن يقتصر الوصول إلى مشروع السحابة الإلكترونية هذا على فريق أصغر يعمل مباشرةً على تطوير الإضافة.
لإنشاء هذه البيئات البديلة للإضافة، عليك أولاً استضافة بيئات بديلة لتطبيق الويب الذي يتضمّن الإضافة على نطاق تملكه. بعد ذلك، يمكنك إنشاء بيئات بديلة لإضافة Meet من خلال إضافة عمليات نشر إضافية إلى مشروع Google Cloud التجريبي. يجب أن تتضمّن عمليات النشر الجديدة هذه بيانات وصفية تشير إلى البيئات البديلة لتطبيق الويب. بعد ذلك، ننصحك بتثبيت كل بيئة وظيفة إضافية على النحو التالي:
- مرحلة الاختبار: انشر نسخة مرحلة الاختبار بشكل خاص ليتمكّن أي مستخدم في مؤسستك من المساعدة في الاختبار.
- التطوير: انقر على تثبيت ضمن عمود الإجراءات لتثبيت الإصدار التجريبي من إضافة Meet على حسابك فقط.
كتابة الاختبارات
قبل نشر إضافة Meet في بيئة تطوير، ننصحك بكتابة اختبارات الوحدات. يجب أن تتضمّن اختبارات الوحدات ما يلي:
- محاكاة حزمة تطوير البرامج (SDK) لإضافات 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).
يجب الالتزام بمتطلبات الرسومات لعمليات دمج تطبيقات معيّنة.
لا تضمِّن مساحة متروكة في صورتك. يمكنك توسيع الصورة لتصل إلى حدود ملفك بدلاً من ذلك.