نظرة عامة

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

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

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

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

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

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

يتوافق Google Cast مع تطوير تطبيق "المُرسِل" لأنظمة التشغيل Android وiOS والأنظمة الأساسية للويب المتوافقة مع Cast، مثل Google Chrome.

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

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

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

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

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

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

حزمة Google Cast SDK

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

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

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

الجدول 1: أدلة SDK لـ Cast

النظام الأساسي	المرسل	مستلم
Android	تطبيقات المُرسِل على Android	نظرة عامة حول جهاز استقبال Android TV
محتوى مخصص للويب	تطبيقات مُرسِل الويب	نظرة عامة على مستقبِل الويب
iOS	تطبيقات المُرسِل التي تعمل بنظام التشغيل iOS	لا تنطبق

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

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

• محتوى مخصص للويب
• Android
• iOS

على الرغم من أن اختيار المرسلين سيكون على الأرجح مدفوعًا إلى حد كبير بالأنظمة الأساسية للمرسلين الذين تنوي دعمهم، فمن المهم معرفة إمكانات كل نوع من أنواع المرسل وحدوده (انظر الجدول 3).

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

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

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

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

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

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

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

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

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

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

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

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

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

إذا كان من الممكن دمج تطبيقك مع الإرسال، فاستخدم رسائل المطالبة التالية لتحديد نوع مستقبِل الويب الذي يجب إنشاؤه:

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

أنشئ مستقبِل وسائط مصمَّمًا في الحالات التالية:

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

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

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