يوضّح هذا الدليل بالتفصيل متطلبات الدمج مع ميزة "المشاركة المباشرة" في Google Meet. قبل أن يتمكّن مقدّم الخدمة التابع لجهة خارجية من استخدام هذه الميزة، عليك تقديم عدة معلومات لفريق Meet للسماح بالميزة بشكل صحيح لأنّها قيد المعاينة حاليًا وغير متاحة للجمهور العام.
نموذج الوصول
الخطوة الأولى هي ملء نموذج الوصول إلى حزمة SDK هذا، بما في ذلك التفاصيل التالية:
- معرّف التطبيق: كلمة رئيسية صغيرة (مثل "youtube") تُعرِّف مقدِّم الخدمة المحدَّد بشكل فريد. يُستخدم هذا المعرّف لتسهيل تحديد موفِّر الخدمة أثناء بدء استخدام حزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet، والسماح بالمزامنة بين جميع البرامج. ما لم يوافق عليها الفريق الذي لديه خطة الطرح المحددة، فيجب عدم تغيير المعرّف. إذا لم تتطابق هذه الكلمة الرئيسية مع ما يتوقعه تطبيق Meet، لن تعمل المشاركة المباشرة مع مقدّم الخدمة هذا. ويتم ترميز هذه الكلمات الرئيسية بشكل ثابت في ثنائي Meet، ما يعني أنّ التغيير في هذه الكلمة الرئيسية يستغرق بعض الوقت لنشره لجميع المستخدمين.
- قائمة حسابات نطاقات Google (مثل 222larabrown@gmail.com) المستخدمة لاختبار الدمج من جانب مقدم الخدمة: تُستخدَم قائمة الحسابات لتحديد ما إذا كان يجب تفعيل الميزة لهذا الحساب في Meet أم لا. إذا لم يكن هناك حساب ضِمن هذه القائمة، لن يتمكّن مقدّم الخدمة من الاتصال بحزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet ولن تكون ميزة المشاركة المباشرة متاحة.
- اسم حزمة Android المطلوب بدء تشغيلها من Meet: كجزء من ميزة المشاركة المباشرة، يحتاج تطبيق Meet إلى تشغيل Android Intent لبدء تطبيق مقدّم الخدمة التابع لجهة خارجية. ولذلك، يجب تقديم اسم محدّد لحزمة التطبيق (مثل "com.google.android.youtube"). تم ترميز اسم الحزمة هذا بشكل ثابت في البرنامج الثنائي لتطبيق Meet ويجب عدم تغييره ما لم يوافق عليه الفريق الذي لديه خطة الطرح المحددة. إنّ التغييرات التي يتم إجراؤها على هذه الحزمة بدون التأكّد من تعديل فريق Meet لهذا الغرض وفقًا لذلك ستؤدي إلى إيقاف وظيفة المشاركة المباشرة بشكل فعّال.
- حساب نطاق Google: سيشارك فريق Meet مجلد Google Drive يتضمّن جميع المُخرَجات النهائية المطلوبة لعملية الدمج.
- رمز الشريك: رمز يتم عرضه بجانب اسم تطبيق المشاركة المباشرة. تُستخدم على شاشة Meet حيث يمكن للمستخدمين اختيار تطبيق المشاركة المباشرة المطلوب تشغيله.
خطوات الانضمام
ضبط إعدادات الجهاز
- يمكنك تنزيل حزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet من مستودع Maven في Google.
- نزِّل تطبيق Google Meet وثبِّته من "متجر Google Play".
- تنزيل نموذج التطبيق وإنشاؤها وتثبيته.
- أضِف حساب نطاق Google المحدّد مسبقًا إلى جهاز الاختبار.
- شغِّل تطبيق Meet واختَر حساب نطاق Google الذي أضفته إلى الجهاز في الخطوة السابقة.
- كرِّر خطوات التثبيت وتسجيل الدخول أعلاه على أي جهاز تريد إجراء الاختبار عليه.
الاختبار باستخدام نموذج تطبيق المشاركة المباشرة المقدَّم
- ابدأ تشغيل تطبيق Meet على جهازين على الأقل.
- أنشئ اجتماعًا وتأكَّد من انضمام جميع الأجهزة إلى الاجتماع نفسه.
- انقر على زر "الصفحة الرئيسية" على كلا الجهازَين لتفعيل وضع نافذة ضمن النافذة (PiP) وتستمرّ جلسة الاجتماع.
- شغِّل نموذج تطبيق المشاركة المباشرة على كلا الجهازين.
- داخل نموذج تطبيق المشاركة المباشرة، انقر على الانضمام إلى الاجتماع. افعل ذلك على كلا الجهازين. يتغير نص الزر إلى مغادرة الاجتماع مع ظهور شريط أخضر أسفل النص للإشارة إلى اكتمال ربط التطبيق بالاجتماع بنجاح.
- انقر على مشاهدة المحتوى مع الآخرين داخل نموذج تطبيق المشاركة المباشرة. افعل ذلك على كلا الجهازين. بعد تفعيل مفتاح التبديل، يتم إنشاء الاتصال بين تطبيقَي المشاركة المباشرة.
- يمكنك الآن البدء في تجربة عناصر واجهة المستخدم المختلفة في النموذج لمحاكاة وظيفة تشغيل الوسائط. أي إجراء تتخذه على أحد عينات التطبيق ينعكس على الآخر.
دمج مقدِّم الخدمة واختباره
يجب تنفيذ الخطوات التالية إذا أردت اختبار وظيفة المشاركة المباشرة مع تطبيقك كمزوّد محتوى. يتطلّب ذلك أن يتم دمج تطبيقك مع حزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet. من الضروري أن تكون المعلومات التي قدمتها أثناء عملية الإعداد مثل "معرِّف التطبيق" و"اسم حزمة Android" صحيحة لأنهما يتم استخدامها لمصادقة تطبيقك أثناء التواصل مع تطبيق Meet.
- ادمج "حزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet" في تطبيقك. راجِع صفحة البدء على نظام التشغيل Android للحصول على إرشادات حول الاستخدام أو قسم مرجع واجهة برمجة التطبيقات في Android للاطّلاع على تفاصيل عن واجهة برمجة التطبيقات.
- احرِص على استخدام الإصدار 4.0.0 أو الإصدارات الأحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" أثناء إنشاء تطبيقك. وهذا مطلوب لإتاحة دعم إزالة واجهة برمجة التطبيقات لـ Java 8+. لمزيد من المعلومات، راجع هذا الدليل.
- ابدأ تشغيل تطبيق Meet على جهازين على الأقل.
- أنشئ اجتماعًا وتأكَّد من انضمام جميع الأجهزة إلى الاجتماع نفسه.
- يمكنك بدء مشاركة مباشرة من تطبيقك. بعد بدء المشاركة المباشرة على أحد الأجهزة، سيتلقّى الجهاز الآخر الذي يتم تشغيل تطبيق Meet عليه دعوة داخل شاشة المكالمات.
يمكنك أيضًا تشغيل تطبيقك الخاص عن طريق تحديده من مربع حوار الأنشطة الذي يمكن الوصول إليه باتباع الخطوات التالية:
- داخل شاشة المكالمات في تطبيق Meet، انقر على القائمة.
- انقر على زر الأنشطة.
- اختَر تطبيقك من قائمة الأنشطة.
- ينتقل تطبيق Meet الآن إلى وضع "نافذة داخل النافذة" (PIP) ويتم تشغيل التطبيق.
التبعيات الخارجية
ملاحظة: تحدّد حزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet
التبعيات
في ملف *.POM الخاص بها. إذا كنت لا تستخدم Maven واخترت تضمين ملف *.AAR الخاص بحزمة تطوير البرامج (SDK) للمشاركة المباشرة في Meet مباشرةً، تقع على عاتقك مسؤولية فحص ملف *.POM والتأكّد من توفير الملحقات المطلوبة (مثل androidx.concurrent:concurrent-futures:1.1.0).