عند بث المحتوى إلى "جهاز استقبال الويب"، يجب أن يكون المستخدم قادرًا في أي وقت على التحكم فيه من تطبيق المُرسِل.
ملاحظة: وفقًا لبنود الخدمة الإضافية لمطوّري البرامج لحزمة Google Cast، يجب أن يستخدم تطبيق وسائط البث واجهات برمجة تطبيقات التحكّم في Play (تشغيل الرسائل) المحددة لحزمة تطوير البرامج (SDK) للتحكّم في تشغيل الوسائط على "جهاز استقبال الويب".
يجب أن توفّر تطبيقات المُرسِل عناصر التحكّم في البث في الحالات التالية:
- بثّ مربّع الحوار أثناء البثّ
- عناصر التحكّم في مستوى صوت المُرسِل
- وحدة التحكُّم الموسّعة للمرسِل
- وحدة تحكّم مصغّرة للمُرسِل
- إشعار المُرسِل
- شاشة قفل المُرسِل
ويجب أن تكون حالة تشغيل البث الخاصة بتطبيق المرسِل وعناصر التحكّم في هذه المناطق متزامنة مع تغييرات التشغيل التي تحدث على جهاز استقبال الويب، حتى إذا لم يكن مصدرها تطبيق المُرسِل. ويسمح ذلك بالتعامل السليم مع كل من أوامر المرسِلين المتعددين وعناصر التحكم في التشغيل الواردة من أزرار التحكم عن بُعد بالجهاز وما إلى ذلك.
Android
عناصر التحكّم في مربّع حوار البث
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-cast-menu-active1.png?authuser=7&hl=ar)
وحدة تحكّم صغيرة
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-persistent-control1.png?authuser=7&hl=ar)
عناصر التحكّم في الإشعارات
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-notification1.png?authuser=7&hl=ar)
تأمين عناصر التحكم في الشاشة
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-lockscreen1.png?authuser=7&hl=ar)
iOS
عناصر التحكّم في مربّع حوار البث
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-cast-menu-active1.png?authuser=7&hl=ar)
وحدة تحكّم صغيرة
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-persistent-control1.png?authuser=7&hl=ar)
Chrome
عناصر التحكّم في مربّع حوار البث
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-cast-menu-active1.jpg?authuser=7&hl=ar)
وحدة تحكّم صغيرة
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-persistent-control1.jpg?authuser=7&hl=ar)
عناصر التحكم في مستوى صوت المُرسِل
يجب أن يسمح تطبيق المرسِل للمستخدمين بالتحكّم في مستوى صوت المحتوى الذي يتم تشغيله على التلفزيون أو مكبرات الصوت باستخدام أزرار التحكّم بمستوى الصوت في الجهاز و/أو شريط تمرير مستوى الصوت الخاص بالبرنامج على الجهاز المرسِل. وهي تتحكم في أي مما يلي:
- مستوى الصوت الذي يتم إرساله إلى التلفزيون لأجهزة Google Cast مثل Chromecast
- مستوى صوت التلفزيون/مكبّر الصوت الأصلي لأجهزة التلفزيون التي تعمل بتكنولوجيا Google Cast وأجهزة التلفزيون المزوّدة بنظام Android TV ومكبّرات الصوت الذكية
مطلوبة
ج يجب أن يسمح تطبيق المرسِل للمستخدمين بالتحكّم في مستوى صوت
المحتوى الذي يتم تشغيله على التلفزيون أو مكبرات الصوت باستخدام أزرار التحكّم بمستوى الصوت في الجهاز و/أو
شريط تمرير مستوى الصوت الخاص بالبرنامج على الجهاز المرسِل.
- Android: يلزم استخدام كل من أزرار الأجهزة وشريط تمرير مستوى صوت البرامج.
- نظام التشغيل iOS: يجب إدخال شريط تمرير مستوى صوت البرامج.
- الويب/Chrome: يلزم استخدام شريط تمرير مستوى صوت البرامج.
ب على الجهاز الجوّال، يجب أن يكون شريط تمرير مستوى صوت البرنامج متوفرًا في مربّع حوار البث، أثناء البثّ.
C يجب أن يتزامن شريط تمرير مستوى الصوت في تطبيق المُرسِل مع مستوى الصوت الحالي لأداة استقبال الويب بعد الاتصال بجهاز استقبال الويب وأن يظل في المزامنة مستمرة.
D يجب أن يعكس شريط تمرير مستوى الصوت في تطبيق المرسِل التغييرات في مستوى الصوت التي يجريها المُرسِلون الآخرون أو وحدة التحكّم عن بُعد في تطبيق Chromecast.
ه يجب ألا تضبط تطبيقات المُرسِل مستوى الصوت على مستوى محدَّد مسبقًا بل يجب أن تقتصر على ضبط تغييرات مستوى الصوت التي يبدأها المستخدم.
F على أجهزة Android فقط: عند استخدام أزرار الأجهزة لتغيير مستوى الصوت على "جهاز استقبال الويب"، يجب أن يظهر شريط تمرير مرئي لمستوى الصوت (يظهر رمز "إرسال" على يساره) عند الضغط على أزرار مستوى الصوت في الجهاز. ملاحظة: بالنسبة إلى نظام التشغيل Android Gingerbread (الإصدار 2.3)، لا يظهر رمز الإرسال.
أفضل الممارسات
- الزيادات في مستوى الصوت:
- Android: يزيد إطار العمل من مستوى الصوت تلقائيًا.
- iOS وChrome: بالنسبة إلى أزرار مستوى الصوت في الأجهزة، استخدِم أجزاء أقل من أو تساوي 5% من النطاق الكامل لمستوى الصوت في جهاز استقبال الويب لأجهزة الصوت/الفيديو، وزيادات تساوي 2% من النطاق الكامل لمستوى الصوت في جهاز استقبال الويب للأجهزة الصوتية فقط.
وحدة التحكُّم الموسّعة للمرسل
يجب أن يوفر تطبيق المرسِل وحدة تحكّم موسّعة للمحتوى الذي يتم بثّه.
مطلوبة
أ يمكنك تحديد المحتوى الذي يتم إرساله من خلال عرض عنوان المحتوى أو العمل الفني له.
ب قبل بدء التشغيل، اعرض مؤشر التحميل
وعنوان المحتوى أو العمل الفني.
C عندما يبدأ المحتوى، حدِّد حالة
"جهاز استقبال الويب".
د توفير عناصر تحكّم ذات صلة
E في الطرف الأيمن من شريط البحث، اعرض وقت التشغيل الحالي.
في الطرف الأيسر، اعرض إجمالي مدة
البث إذا كانت معروفة وما إذا لم يكن بثًا مباشرًا.
F إخفاء عناصر التحكّم غير المرتبطة بالبث.
G يجب عدم فصل البث أو إيقافه عند انتقال المستخدمين
خارج وحدة التحكّم الموسّعة.
H يمكنك توفير طريقة سهلة لاستعادة وحدة التحكم الموسّعة
عند مغادرة المستخدمين لها.
أفضل الممارسات
- توفير شريط تمرير موضع التشغيل لوسائل بث الوسائط
- عرض أعمال فنية وبيانات وصفية أخرى مفيدة ذات صلة بالمحتوى
- تحديد الوقت المنقضي ومدة المحتوى لساحات مشاركات الوسائط.
Android
جارٍ تحميل محتوى المُرسِل
![جارٍ تحميل محتوى المُرسِل](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-elements1_a.png?authuser=7&hl=ar)
جارٍ تحميل محتوى جهاز الاستقبال
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-loading1.gif?authuser=7&hl=ar)
محتوى المُرسِل قيد التشغيل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-elements2_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
iOS
جارٍ تحميل محتوى المُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-control-elements1_a.gif?authuser=7&hl=ar)
جارٍ تحميل محتوى "جهاز استقبال الويب"
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-loading1.gif?authuser=7&hl=ar)
محتوى المُرسِل قيد التشغيل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-control-elements2_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
Chrome
جارٍ تحميل محتوى المُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-control-elements1_a.gif?authuser=7&hl=ar)
جارٍ تحميل محتوى "جهاز استقبال الويب"
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-loading1.gif?authuser=7&hl=ar)
محتوى المُرسِل قيد التشغيل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-control-elements2_a.jpg?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
وحدة تحكّم مصغّرة للمُرسِل
من المفترض أن يظهر عنصر تحكّم صغير ودائم يُعرف باسم "وحدة التحكّم المصغّرة" أثناء البث عندما ينتقل المستخدم من صفحة المحتوى الحالية أو وحدة تحكّم موسّعة إلى عرض آخر ضمن تطبيق المُرسِل. تكون وحدة التحكّم المصغّرة تذكيرًا مرئيًا للبث الحالي وتوفّر إمكانية الوصول الفوري إليه.
مطلوب
أ يظهر شريط أو مربّع يعرض ما يتم بثه بالقرب
من أسفل تطبيق المُرسِل. وتظل عناصر التحكم هذه أثناء تصفُّح المستخدم للمحتوى أو
أقسام أخرى من التطبيق.
ب تعمل عناصر التحكم بشكل أفضل عندما تكون بسيطة
وتوضح ما يتم إرساله.
C متاحة على جميع شاشات التطبيق (باستثناء
صفحة وحدة التحكّم الموسّعة).
د يؤدي النقر على منطقة المحتوى إلى فتح وحدة التحكّم الموسّعة.
هـ قدِّم أي عناصر تحكّم أخرى ذات صلة باتخاذ إجراء فوري.
أفضل الممارسات
للحصول على أفضل تجربة للمستخدم، عليك توفير عناصر تحكّم في
مربّع حوار
البث بالإضافة إلى وحدة التحكّم المصغّرة.
Android
وحدة تحكّم مصغّرة للمُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-persistent-control1_a.png?authuser=7&hl=ar)
تم إيقاف محتوى جهاز استقبال الويب مؤقتًا
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
iOS
وحدة تحكّم مصغّرة للمُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-persistent-control1_a.png?authuser=7&hl=ar)
تم إيقاف محتوى جهاز استقبال الويب مؤقتًا
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
Chrome
وحدة تحكّم مصغّرة للمُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-persistent-control1_a.jpg?authuser=7&hl=ar)
تم إيقاف محتوى جهاز استقبال الويب مؤقتًا
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
إشعار المُرسِل
مطلوب (نظام التشغيل Android فقط)
أ استخدِم رمز التطبيق (وليس رمز البث)
لعرض الإشعار الذي يظهر في شريط الحالة.
ب حدِّد المحتوى الذي يتم بثّه. على سبيل المثال، يمكنك عرض عنوان المحتوى أو العمل الفني.
C حدِّد جهاز استقبال الويب الذي يبثّ المحتوى.
د توفير عناصر التحكم الأساسية في المحتوى.
E قدِّم الرمز "X" لإيقاف البث
وقطع الاتصال بـ "جهاز استقبال الويب" ضمن صف الإجراءات.
F يؤدي النقر على شعار التطبيق أو عنوان المحتوى أو العمل الفني إلى فتح وحدة التحكّم الموسّعة الخاصة بتطبيق المُرسِل.
Notes
- Android فقط: لا يمكن تنفيذ الإشعارات في iOS أو Chrome.
- في نظام التشغيل Android Gingerbread (الإصدار 2.3)، ستعرض الإشعارات رمز التطبيق ونصه فقط، بدون التشغيل/الإيقاف المؤقت أو الإيقاف.
- لمزيد من المعلومات، يمكنك الاطّلاع على إضافة عناصر التحكم في الوسائط إلى الإشعارات.
Android
رمز إشعار المُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-notification1_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
عناصر التحكّم في إشعارات المُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-notification2_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
شاشة قفل المُرسِل
مطلوبة (نظام التشغيل Android فقط)
أ حدِّد المحتوى الذي يتم بثه باستخدام عنوان المحتوى أو العمل الفني.
ب حدِّد مستقبِل الويب الذي يبثّ المحتوى. ملاحظة: هذا الإجراء ليس مطلوبًا لتطبيقات الموسيقى.
C توفير عناصر التحكم في التشغيل
D تتيح الوصول إلى عناصر التحكّم في مستوى الصوت من خلال أزرار الجهاز.
مطلوب لنظام التشغيل Android 4.4 KitKat والإصدارات الأحدث:
- رمز التطبيق
- عمل فني (على سبيل المثال، غلاف ألبوم)
- تحديد المحتوى الذي يتم بثه من خلال النص (مثلاً، "Tears of Steel")
- تحديد مستلِم الويب الذي يجري البث (على سبيل المثال، "Living Room")
مطلوب لنظام التشغيل Android 4.3 Jelly Bean:
- عمل فني (على سبيل المثال، غلاف ألبوم)
- تحديد المحتوى الذي يتم بثه من خلال النص (مثلاً، "Tears of Steel")
- تحديد مستلِم الويب الذي يجري البث (على سبيل المثال، "Living Room")
Notes
- Android فقط: لا يمكن تنفيذ الإشعارات في iOS أو Chrome.
- يجب استخدام عناصر التحكّم في شاشة القفل في الإصدار 4.1 من Android والإصدارات الأحدث.
- تتوفر عناصر تحكم مختلفة للإصدارات المختلفة من نظام التشغيل Android، ولا يمكن أن تستوعب شاشة القفل سوى الحقول النصية فقط. بشكل عام، تصف الرسومات والرموز التعبيرية المحتوى بشكل فوري أكثر من النص.
- من المفترض أن تضبط أزرار أجهزة التحكّم في مستوى الصوت مستوى الصوت في تطبيق المرسِل عندما يكون الهاتف مقفلاً.
- يجب أن يستخدم عنصر التحكّم مكوّن إطار العمل:
MediaSession
أوMediaSessionCompat
(للإصدار 4.4 و4.3) أوNotification
(للإصدار 5.0 والإصدارات الأحدث).
Android
عناصر التحكم في شاشة قفل المُرسِل
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-lockscreen1_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
يستأنف المُرسِل البث.
من المفترض أن يستعيد تطبيق المرسل المتصل حالته بعد انقطاع الاتصال الضمني (مثلاً، تعطل الشبكة أو دخول الجهاز في وضع السكون أو نفاد شحن البطارية).
مطلوب
أ إذا تم إلغاء ربط تطبيق المرسِل ضمنيًا (لم يتوقّف المستخدم عن البث أو إلغاء الربط صراحةً)، من المفترض أن يستمر تشغيل محتوى البث
على "جهاز استقبال الويب". عند إعادة تشغيل التطبيق أو الاتصال، من المفترض أن يستعيد تطبيق المُرسِل الاتصال بـ "أداة استقبال الويب" طالما أنّ جلسة "جهاز استقبال الويب" لا تزال جارية.
B من المفترض أن تتم استعادة زر البث إلى حالة الاتصال.
C إذا نقر المستخدم على زر البث قبل إعادة اتصال المُرسِل،
سيتم عرض قائمة بأجهزة استقبال الويب. عندما يختار المستخدم "جهاز استقبال الويب"
الذي يتم بثّه حاليًا، من المفترض أن تظهر وحدة تحكم مصغّرة أو موسّعة في تطبيق المُرسِل.
ملاحظات
قد يتم أيضًا إلغاء ربط تطبيق Web Replyr وإيقاف تشغيله بسبب انقطاع التيار الكهربائي أو أي انقطاع آخر خارج السياق. يتم التعامل مع هذه الحالة على أنّها نهاية جلسة عادية، كما هو موضّح في
يوقف المُرسِل البث.
Android
تحديد التطبيق
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-resume1_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
تمت استعادة اتصال البث.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-resume2_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
iOS
تحديد التطبيق
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-control-resume1_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
تمت استعادة اتصال البث.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-control-resume2_a.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
يوقف المُرسِل البث
يستمر تشغيل المحتوى الذي يتم بثه على التلفزيون إلى أن يختار المستخدم "إيقاف البث" أو يبث المرسِل شيئًا جديدًا. عند اتصال عدة مرسلين بجهاز استقبال الويب نفسه، يجب أن يحتوي كل تطبيق مرسل على زر قطع الاتصال (بدلاً من زر إيقاف الإرسال) في مربع حوار البث.
مطلوب
أ عند اتصال عدة مُرسِلين بجهاز استقبال الويب،
سيؤدي الضغط على "إيقاف البث من تطبيق مُرسِل واحد" إلى عدم تنفيذ أي إجراء على مستلِم الويب وإزالة عناصر التحكم
والإشعارات في البث من هذا الجهاز. تظل أجهزة المُرسِلين المتصلين المتبقية على اتصال
مع توفُّر عناصر تحكُّم في البث.
ب عندما ينقطع الاتصال بشكل ضمني بين تطبيق المُرسِل (على سبيل المثال،
تنخفض بطارية جهاز المُرسِل أو ينخفض اتصال شبكة جهاز المُرسِل بجهاز استقبال الويب
)، لا يحدث أي شيء لـ "جهاز استقبال الويب"، ويزيل عناصر التحكم في البث والإشعارات
من جهاز المُرسِل. يجب أن يتتبّع تطبيق المُرسِل عمليات انقطاع الاتصال الضمنية وأن يحاول
إعادة الاتصال بـ "جهاز استقبال الويب" عند فتح تطبيق المُرسِل مرة أخرى.
Android
مربّع حوار البث، زر إلغاء الربط
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/a/sender-control-end1.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
iOS
مربّع حوار البث، زر إلغاء الربط
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/i/sender-control-end1.png?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
Chrome
مربّع حوار البث، زر إلغاء الربط
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/w/sender-control-end1.jpg?authuser=7&hl=ar)
جهاز استقبال الويب قيد التشغيل للمحتوى
![](https://developers-dot-devsite-v2-prod.appspot.com/static/cast/images/r/receiver-content-playing1.png?authuser=7&hl=ar)
إنّ الصور المستخدَمة في دليل التصميم هذا مقدَّمة من Blender Foundation، وتتم مشاركتها بموجب حقوق الطبع والنشر أو رخصة المشاع الإبداعي.
- Elephant's Dream: (ج) حقوق الطبع والنشر لعام 2006، مؤسسة Blender / المعهد الهولندي للفنون / www.alephantsdream.org
- Sintel: (ج) حقوق الطبع والنشر لمؤسسة Blender | www.sintel.org
- Tears of Steel: (CC) Blender Foundation | mango.blender.org
- Big Buck Bunny: (c) حقوق الطبع والنشر لعام 2008: مؤسسة Blender / www.bigbuckbunny.org