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

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

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

حزمة تطوير البرامج (SDK) الخاصة بـ Google Web Listenr

يصل تطبيق WebRecipients إلى واجهة برمجة التطبيقات Web Installr من خلال ما يلي: المرجع:

<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 للإنتاج شفافًا ولن تتطلّب تغيير الرمز (يجب استضافة تطبيقات استقبال الويب المنشورة. على الخوادم المتوافقة مع بروتوكول أمان طبقة النقل (TLS).

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

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

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

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

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

قد يتعطل تطبيق استقبال الويب (ينهي دورة حياته الحالية ويغلق طلبك) بموجب الشروط التالية:

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

تتعامل حزمة تطوير برامج الويب (SDK) مع جميع الحالات الشائعة وفقًا إرشادات تجربة المستخدم:

الفئات الرئيسية

يتضمّن إطار عمل حزمة تطوير البرامج (SDK) لاستقبال الويب فئتَين رئيسيتَين:

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

  • ضبط خيارات ضبط التطبيق
  • التعامل مع أحداث النظام (مثل اتصال المُرسِل أو عدم الاتصال به)
  • إنشاء قنوات مخصّصة
  • بدء اتصال طاقم العمل

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

  • معالجة عمليات التشغيل
  • معالجة الطلبات ذات الصلة بالتشغيل من المُرسِل
  • التعامل مع الأحداث ذات الصلة بتشغيل المحتوى

تسجيل تطبيق WebRecipient

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

إنشاء تطبيق "جهاز استقبال الويب" الأساسي

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

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

في ما يلي الحد الأدنى للرمز البرمجي الخاص بتطبيق "استقبال الويب" الذي يستخدم تطبيق البث. إطار العمل بدون أي تخصيص. يمكنك نسخ هذا النص البرمجي ولصقه بالضبط كما هي في تطبيقك لإنشاء تطبيق WebRecipient.

<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>

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

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

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

يوفّر إطار عمل Google Cast مشغّل وسائط مدمجًا ممثلًا عنصر HTML واحد (cast-media-player) يتيح مشغّل الوسائط هذا التشغيل لمدة بروتوكولات البث مثل MPEG-DASH وHLS وSmooth Streaming.

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

مشاركة المصادر المتعدّدة المصادر

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