نظرة عامة

تتيح حزمة تطوير البرامج (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

بنية البث عالية المستوى

يتحكّم المُرسِل في تشغيل الوسائط على جهاز استقبال باستخدام رسائل تشغيل الوسائط المحدّدة في حزمة تطوير البرامج (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، استخدم المطالبات التالية لتحديد نوع Web Pror الذي يجب إنشاؤه:

أنشئ مستلِمًا مخصّصًا في الحالات التالية:
يتطلب التطبيق واحدة أو أكثر من الإمكانات الخاصة التالية:

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