نظرة عامة

تتيح حزمة تطوير البرامج (SDK) البث للمستخدم إمكانية اختيار بث المحتوى الصوتي المرئي من خلال مُرسِل، وتشغيله على جهاز آخر (أو البث عليه) باسم جهاز الاستقبال، مع التحكّم في التشغيل باستخدام "المُرسِل".

يشير مصطلح المرسل إلى تطبيق يؤدي دور وحدة التحكم في جلسة البث. يبدأ المرسِل جلسة البث ويدير تفاعل المستخدم مع المحتوى.

هناك أنواع عديدة من المُرسِلين، بما في ذلك التطبيقات المتوافقة مع الأجهزة الجوّالة وتطبيقات الويب على Google Chrome، بالإضافة إلى مساحات التحكّم الافتراضية على أجهزة Google Home التي تعمل باللمس. إنّ عناصر التحكّم في الوسائط في متصفّح الويب Chrome تؤدي وظيفة المُرسِل، تمامًا مثل "مساعد Google" نفسه.

يشير مصطلح جهاز الاستقبال إلى تطبيق يعمل على جهاز يعمل بتكنولوجيا Google Cast ويكون مسؤولًا عن الاستجابة لأوامر المُرسِلين ونقل محتوى البث من خدمة بث على الإنترنت إلى الجهاز الذي يعمل بتكنولوجيا Google Cast. وتشمل الأمثلة على أجهزة الاستقبال التي تعمل بتكنولوجيا Google Cast أجهزة Chromecast وأجهزة التلفزيون الذكي والشاشات الذكية ومكبّرات الصوت الذكية.

تتوافق حزمة تطوير البرامج (SDK) أيضًا مع عدة مُرسِلين متصلين بجلسة بث. على سبيل المثال، يمكن لمرسِل واحد بدء جلسة على جهاز استقبال، وبإمكان مرسل آخر الانضمام إلى الجلسة نفسها للتحكم في التشغيل، أو تحميل محتوى جديد، أو إضافة المزيد من المحتوى إلى قائمة المحتوى التالي لمشاهدته لاحقًا.

مكونات التطبيق وبنيته

توفّر تكنولوجيا Google Cast تطوير تطبيق Sender لأجهزة Android وiOS والأنظمة الأساسية على الويب التي تعمل بتكنولوجيا Google Cast، مثل Google Chrome.

يتم تشغيل تطبيق جهاز الاستقبال على جهاز يعمل بتكنولوجيا Google Cast، وتشمل أمثلة ذلك ما يلي:

• جهاز Chromecast متصل بتلفزيون أو نظام صوت عالي الدقة
• تلفزيون يعمل بتكنولوجيا Google Cast
• شاشة ذكية تعمل بتكنولوجيا Google Cast
• جهاز Android يعمل بتكنولوجيا Google Cast مثل Android TV

ملاحظة: إنّ بروتوكول البث مستقل عن النظام الأساسي، لذا قد يتم تشغيل أجهزة إرسال البث الخاصة بموقع إلكتروني أو خدمة معيّنة على أي أنظمة أساسية متوافقة (الويب وiOS وAndroid) والتفاعل مع جهاز استقبال البث المقابل الذي يعمل على الويب أو Android. يتم تسجيل أجهزة الاستقبال (باستثناء جهاز الاستقبال التلقائي) باستخدام معرّف تطبيق مميّز يُستخدم من أجل "مفتاح" تطبيقات المُرسِل المقابلة إلى جهاز الاستقبال هذا. وتمنع هذه الآلية المُرسِل من الاتصال بأجهزة الاستقبال والتحكم فيها بخلاف تلك التي تتشارك رقم تعريف التطبيق نفسه.

يتحكّم المُرسِل في تشغيل الوسائط على جهاز استقبال باستخدام رسائل تشغيل الوسائط المحدّدة في حزمة تطوير البرامج (SDK). إذا كانت حالة استخدام التطبيق تتطلب إرسال بيانات غير محدّدة رسميًا في "رسائل تشغيل الوسائط العادية"، يمكنك استخدام الحقل customData الذي توفّره أنواع متعددة من الرسائل لتمرير البيانات الإضافية.

هناك سيناريوهان أساسيان لتطوير تطبيق Cast:

1. حلّ شامل يستند إلى تكنولوجيا Google Cast في هذا السيناريو، على مطوّر البرامج إنشاء تطبيق "المرسل" وتطبيقَين على أجهزة الاستقبال: جهاز استقبال Android TV وجهاز استقبال الويب (يمكنك الاطّلاع على مزيد من المعلومات أدناه).
2. هو تطبيق مُرسِل يعمل بتكنولوجيا Google Cast ويمكنه بث المحتوى (شاشة أو بث وسائط متعددة) إلى جهاز استقبال البث التلقائي من Google، وهو ما يُسمى "جهاز استقبال الوسائط التلقائي". في هذا السيناريو، يحتاج مطور البرامج فقط إلى إنشاء تطبيق واحد، ألا وهو المُرسِل. يُعد جهاز استقبال الوسائط الافتراضي مفيدًا للتعلم وفي سيناريوهات التشغيل المحدودة للغاية. وهو ليس عمليًا للمستلمين الذين يتطلبون منطق عمل مخصص أو بيانات اعتماد أو إدارة حقوق أو تحليلات.

حزمة تطوير البرامج (SDK) لتقنية Google Cast

تتكوّن حزمة Google Cast SDK من عدة مكتبات Cast API. إلى جانب واجهات برمجة التطبيقات، هناك نوعان من الوثائق:

• أدلة واجهة برمجة التطبيقات التي توجهك حول كيفية استخدام واجهات برمجة التطبيقات من خلال نموذج رمز يوضّح ميزات البث
• البرامج التعليمية حول الترميز التي ترشدك إلى عملية تطوير أنواع معيّنة من تطبيقات Cast.

تنقسم واجهات برمجة تطبيقات Cast حسب النظام الأساسي ونوع تطبيق Cast. يحتوي الجدول 1 على روابط لأدلة واجهات برمجة تطبيقات البث المختلفة.

الجدول 1: أدلة حزمة تطوير البرامج (SDK) الخاصة بالبث

النظام الأساسي	المرسل	مستلم
Android	تطبيقات Android Sender	نظرة عامة حول أجهزة استقبال Android TV
الويب	تطبيقات Web Sender	نظرة عامة على مستلِمي الويب
iOS	تطبيقات iOS Sender	timing fixed in amara

أنواع تطبيقات المُرسِل

يمكن تشغيل تطبيقات المرسل على ثلاثة أنظمة أساسية:

• الويب
• Android
• iOS

على الرغم من أنَّ اختيار نوع المُرسِل يعتمد بشكلٍ كبير على أنظمة المُرسِلين الأساسية التي تنوي إتاحة استخدامها، إلا أنه من المهم معرفة الإمكانيات والقيود المفروضة على كل نوع من أنواع المُرسِلين (راجِع الجدول 3).

الجدول 3: مقارنة المرسِلين

الإمكانية	المُرسِل على Android	تطبيق المُرسِل على iOS	تطبيق Web Sender
الفواصل الإعلانية والإعلانات المصاحبة ضمن بث وسائط
مسارات النصوص ذات النمط
تجميع المقاطع الصوتية من الوسائط وتصميمها وتفعيلها
التشغيل التلقائي والإضافة إلى قائمة المحتوى التالي (التعديل وإعادة الترتيب والتحديث)
القنوات المخصَّصة
الإجراءات المخصّصة
واجهة مستخدم كاملة للبث، بما في ذلك وحدة تحكم ووحدة تحكّم صغيرة
ننوي الانضمام

أنواع تطبيقات أجهزة الاستقبال

تتعامل تطبيقات المُستلِم مع الاتصال بين تطبيق "المرسِل" وجهاز البث. هناك نوعان رئيسيان من أجهزة الاستقبال: جهاز استقبال الويب وجهاز استقبال Android TV. ويُتوقع منك توفير جهاز استقبال ويب على الأقل، كما يُنصح بتوفير جهاز استقبال Android TV لتعزيز تجربة المستخدم مع تطبيقك إلى أقصى حد.

هناك ثلاثة أنواع من مستلِمي الويب، ولكلٍّ منها مجموعة مميزة من الصفات والإمكانات:

• جهاز استقبال مخصص، الذي يسمح بمنطق مخصص والعلامة التجارية وتعديل عناصر التحكم.
• جهاز استقبال الوسائط بنمط معيّن، الذي يتيح تخصيص العلامة التجارية.
• المستلِم التلقائي، وهو النوع الأساسي. لا يسمح ذلك بأي عملية تخصيص، وليس مناسبًا لتطبيقات الإنتاج.

بالإضافة إلى الإمكانات التي يوفرها جهاز الاستقبال المخصّص، يوفّر جهاز استقبال Android TV ميزة البث المباشر، وهي مجموعة من الإمكانات التي توفّر تجربة أصلية للمستخدمين، حيث تجمع بسلاسة بين البث وAndroid TV.

يوضح الجدول 2 إمكانات الأنواع المختلفة من أجهزة الاستقبال.

الجدول 2: مقارنة أجهزة الاستقبال

	جهاز استقبال Android TV	جهاز استقبال مخصّص	جهاز استقبال الوسائط بنمط معيّن (SMR)	الجهاز التلقائي لاستقبال الوسائط
النظام الأساسي
مستندة إلى Android (Java/Kotlin)
الاستناد إلى الويب (HTML5)
المتطلّبات
يجب التسجيل
الإمكانات
تشغيل وسائط HLS وDASH
توفُّر عناصر التحكّم باللمس
معالجة الطلبات الصوتية من الأجهزة المزوّدة بخدمة "مساعد Google"
نمط مرئي قابل للتخصيص وعلامة تجارية
التعامل مع الرسائل المخصّصة
Chromecast Connect

يعتمد الاختيار بين خيارات "جهاز استقبال الويب" الثلاثة على أنواع الوسائط التي يحتاج التطبيق إلى دعمها، ودرجة تخصيص واجهة المستخدم المطلوبة، وأي متطلبات منطقية مخصّصة.

تحذير: لدمج واجهة برمجة التطبيقات Cast API في تطبيقك، يجب أن يستخدم تطبيقك تنسيق وسائط متوافقًا مع Cast، مثل HLS أو DASH. إذا كان تطبيقك يتطلب تنسيق وسائط غير متوافق، لن تتمكن من دمج تكنولوجيا Google Cast في تطبيقك.

تحديد نوع مستقبل الويب المطلوب إنشاؤه

بشرط أن يتكامل تطبيقك مع Cast، استخدم المطالبات التالية لتحديد نوع Web Pror الذي يجب إنشاؤه:

أنشئ مستلِمًا مخصّصًا في الحالات التالية:
يتطلب التطبيق واحدة أو أكثر من الإمكانات الخاصة التالية: لا يوفر جهاز استقبال الوسائط ذات النمط تعديلات على عناصر التحكّم باللمس الترخيص أو المصادقة إحصاءات المستلِم تسليم ترخيص DRM بشكل منفصل عن البيان قبل الإعلان أو في منتصفه أو بعده أي وظيفة أخرى مخصّصة للمستلِم أو منطق JavaScript مخصّص	أو	يتطلب التطبيق تصميمًا مخصّصًا و إمكانات تصميم جهاز استقبال الوسائط ذات النمط غير كافية

يمكنك إنشاء جهاز استقبال وسائط بنمط في الحالات التالية:

يتطلب التطبيق تصميمًا مخصّصًا و إنّ إمكانات التصميم لجهاز استقبال الوسائط ذات النمط كافية و لا يتطلب التطبيق أيًّا من الإمكانات الخاصة المذكورة أعلاه.

استخدام جهاز استقبال الوسائط التلقائي في الحالات التالية:

تنسيق الوسائط متوافق و لا يتطلب التطبيق تصميمًا مخصّصًا و لا يتطلب التطبيق أيًّا من الإمكانات الخاصة المذكورة أعلاه