مستقبِل ويب مخصّص

الانتقال السريع - رمز إنشاء مستقبِل ويب مخصّص بسيط. انتقِل مباشرةً إلى تسجيل تطبيق Web Render ، ثم أنشئ تطبيقًا أساسيًا مستقبِلًا على الويب.

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

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

حزمة SDK لمستقبل الويب من Google

يصل تطبيق Web المستلمين إلى واجهة برمجة التطبيقات Web Web Connect API باستخدام المرجع التالي:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

أفضل الممارسات لبروتوكولات عناوين URL: يُرجى العلم أنّ عنوان URL أعلاه لا يحدّد بروتوكولاً "http:"أو "https:". يؤدي تجاهل هذه البروتوكولات عند تحديد مصدر cast_receiver_framework.js إلى جلب هذا المورد باستخدام البروتوكول نفسه مثل الخادم الذي يستضيف تطبيق مستقبِل الويب. وهذا يعني أنّ التبديل بين بروتوكول HTTP للتطوير وبروتوكول HTTPS لأغراض الإنتاج لن يتميز بالشفافية ولن يتطلب تغيير الرمز. (يجب استضافة تطبيقات مستقبِل الويب المنشورة على خوادم تمكّن طبقة النقل الآمنة.)

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

يتوفّر أيضًا إصدار تجريبي من حزمة SDK مستقبِل الويب للبث على الويب لاستخدامه في اختبار التطبيقات غير الإنتاجية. يمكن العثور على مزيد من المعلومات حول عنوان URL لمعاينة حزمة تطوير البرامج (SDK) في عنوان URL لمعاينة حزمة مستقبِل الويب لبرنامج Google Cast.

دورة حياة التطبيق

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

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

قد يؤدي ذلك إلى تلف تطبيق "استقبال الويب" (إنهاء دورة حياته الحالية وإغلاق التطبيق) في ظل الشروط التالية:

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

تعالج حزمة SDK مستقبِل الويب جميع الحالات الشائعة وفقًا لإرشادات تجربة المستخدم.

الصفوف الرئيسية

يتألف إطار عمل حزمة SDK لمستقبل الويب من فئتين رئيسيتين:

  • cast.framework.CastReceiverContext: تُدير هذه الميزة إطار العمل العام وتُحمِّل أي مكتبات ضرورية. باستخدام هذا الكائن، يمكنك إجراء ما يلي:

    • ضبط خيارات ضبط التطبيق
    • التعامل مع أحداث النظام (مثل اتصال المُرسِل أو قطع الاتصال به)
    • إنشاء قنوات مخصّصة
    • بدء التواصل مع فريق البث
  • cast.framework.PlayerManager: لإدارة تشغيل الوسائط. وهي تتعامل مع المشغّل الأساسي وعنصر الوسائط وفقًا للطلب من المُرسِل. باستخدام هذا الكائن، يمكنك إجراء ما يلي:

    • معالجة عمليات التشغيل
    • التعامل مع الطلبات المتعلّقة بالتشغيل من المرسِل
    • معالجة الأحداث المتعلقة بالتشغيل

تسجيل تطبيق ويب مستقبِل الويب

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

إنشاء تطبيق ويب مستقبِل على الويب

في ما يلي البنية الأساسية لتطبيق "استقبال الويب" الأساسي الذي لا ينطبق عليه أي تخصيص:

  1. عنصر HTML cast-media-player يمثّل مشغّل الوسائط.
  2. عنصر HTML للنص البرمجي لتحميل إطار عمل مستقبِل الويب.
  3. يمكنك الاتصال start() لبدء تطبيق "استقبال الويب" بدون أي خيارات.

في ما يلي الحد الأدنى للرمز لأحد تطبيقات مستقبِل الويب الذي يستخدم إطار عمل تطبيق Cast بدون أي تخصيص. يمكنك نسخ هذا النص البرمجي ولصقه كما هو تمامًا في تطبيقك لإنشاء تطبيق Web المستلمين.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

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

قارِن بين مستقبِل الويب الأساسي هذا وتطبيق مستقبِل مخصّص.

الوسائط والمشغّلات

يوفّر إطار عمل البث مشغّل وسائط مضمّنًا، يتم تمثيله بعنصر HTML cast-media-player. يتيح مشغّل الوسائط هذا تشغيل بروتوكولات البث، مثل MPEG-DASH وHLS والبث السلس.

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

مشاركة الموارد المشتركة المنشأ

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