يجب تسجيل تطبيقك إذا كنت تستخدم أداة استقبال الوسائط ذات التصميم الخاص أو تنشئ أداة استقبال مخصّصة. بعد تسجيل تطبيقك، ستتلقّى رقم تعريف للتطبيق، ويستخدمه تطبيق المرسِل لتنفيذ طلبات البيانات من واجهة برمجة التطبيقات، مثل تشغيل تطبيق Web Receiver.
إذا كنت تستخدم مستقبِل الوسائط التلقائي، لن تحتاج إلى تسجيل تطبيقك. لا يتيح لك تطبيق Default Media Receiver توفير أي نمط لواجهة مستخدم مشغّل الوسائط، ويستخدم قيمة ثابتة يتم توفيرها كمعرّف للتطبيق.
عليك أيضًا تسجيل جهاز Google Cast ليتمكّن من الوصول إلى تطبيق Web Receiver قبل نشره. بعد نشر تطبيق جهاز الاستقبال، سيصبح متاحًا على جميع أجهزة Google Cast.
التطبيقات
يتيح لك تسجيل تطبيقك اختباره على جهاز Cast المسجَّل قبل نشر التطبيق. يؤدي نشر التطبيق إلى إتاحته لجميع أجهزة Cast.
تسجيل تطبيقك
يجب تسجيل جهاز استقبال وسائط منمّق أو جهاز استقبال مخصّص لتلقّي معرّف تطبيق يتم استخدامه مع طلبات البيانات من واجهة برمجة التطبيقات الواردة من تطبيق المرسِل.
لتسجيل تطبيق Cast، اتّبِع الخطوات التالية:
- سجِّل الدخول إلى Google Cast SDK Developer Console.
- من صفحة نظرة عامة أو صفحة التطبيقات، انقر على إضافة تطبيق جديد.
اختَر نوع تطبيق Web Receiver الذي ستستخدمه:
جهاز استقبال مخصّص
اختَر هذا الخيار إذا كان تطبيقك يتطلّب عناصر واجهة مستخدم أو أنماط تفاعل لا يوفّرها Styled Media Receiver. قد يكون اختيار Custom Receiver ضروريًا أيضًا إذا لم يكن نوع المحتوى الخاص بك مدرجًا ضمن أنواع الوسائط المتوافقة في Styled Media Receiver.
يُرجى العِلم أنّ هذا الخيار يتطلّب إنشاء تطبيق ويب كامل لتطبيق Web Receiver.
لمزيد من التفاصيل، يُرجى قراءة تطبيق "المستقبِل المخصّص".
Styled Media Receiver
اختَر هذا الخيار إذا كان تطبيقك يبث محتوى فيديو أو صوتيًا باستخدام أحد أنواع الوسائط المتوافقة وكنت تريد توفير واجهة مستخدم على التلفزيون تستخدم إما واجهة المستخدم التلقائية لمشغّل الوسائط أو مجموعة من الأنماط المخصّصة فوق واجهة المستخدم التلقائية لمشغّل الوسائط.
تتيح لك الأنماط المخصّصة التي يمكنك توفيرها تحديد شكل العناصر المختلفة في واجهة مستخدم المشغّل (مثل شاشة البداية وشريط التقدّم) ببساطة من خلال توفير ملف CSS، ولا تحتاج إلى إنشاء تطبيق جهاز استقبال.
لمزيد من التفاصيل، يُرجى الاطّلاع على Styled Media Receiver.
املأ تفاصيل تطبيق Web Receiver:
في حقل الاسم، أدخِل اسم تطبيقك.
هذا هو اسم التطبيق كما يظهر عند تحميل Web Receiver أو في حالة عدم النشاط إذا كنت تستخدم Styled Media Receiver. إذا كنت تستخدم جهاز استقبال مخصّصًا، تكون قيمة هذا الحقل هي القيمة التلقائية لحالة التطبيق، إذا لم يتم ضبطها باستخدام الطريقة
setApplicationState.حدِّد مظهر تطبيق Web Receiver:
بالنسبة إلى المستقبِل المخصّص، في حقل عنوان URL، حدِّد عنوان URL داخل تطبيق.
أدخِل عنوان URL يجب أن يطلبه جهاز Google Cast عند تحميل تطبيق Web Receiver. أثناء عملية التطوير، يمكن أن يستخدم عنوان URL بروتوكول HTTP، ولكن عند نشر التطبيق، يجب أن يستخدم بروتوكول HTTPS. قد يكون عنوان URL مخصّصًا لصفحة HTML أو نوع ملف آخر يمكن الوصول إليه من متصفّح الويب. لا بأس بأن يكون عنوان IP الخاص بتطبيق Web Receiver داخليًا (مسجّلاً في NAT)، ولكن ليس على المضيف المحلي، لأنّه نادرًا ما يكون نطاقًا من المستوى الأعلى. على الرغم من أنّه يجب عرض تطبيق "أداة استقبال الويب" عبر بروتوكول SSL (HTTPS) عند نشره، يمكن عرض المحتوى الذي يتم تحميله على تطبيق "أداة استقبال الويب" عبر بروتوكول HTTP.
بالنسبة إلى أداة استقبال الوسائط ذات التصميم المخصّص، حدِّد في حقل عنوان URL للواجهة عنوان URL لورقة الأنماط.
قدِّم عنوان URL بتنسيق HTTPS يشير إلى ملف CSS على موقعك الإلكتروني. لاستخدام الأنماط التلقائية، اترك الحقل فارغًا. يمكنك تعديل هذا الخيار في أي وقت لاحق إذا أردت تقديم أو تعديل أنماطك المخصّصة.
ضَع علامة في المربّع يتوافق مع ميزة "البث المتتابع" أو أزِل العلامة منه.
تتيح ميزة "البث عبر جهاز وسيط" لجهاز Web Receiver إمكانية البث من أجهزة إرسال غير متصلة بشبكة Wi-Fi نفسها التي يتصل بها جهاز الاستقبال. لإيقاف ميزة البث عبر جهاز استقبال آخر، أزِل العلامة من هذا المربّع.
ضَع علامة في مربّع الاختيار إتاحة البث إلى أجهزة صوتية فقط أو أزِلها.
ضَع علامة في هذا المربّع للسماح لتطبيقك بالعثور على أجهزة Google Cast التي تعمل بالصوت. لإيقاف إمكانية استخدام الأجهزة التي تعمل بالصوت فقط، أزِل العلامة من هذا المربّع. لمزيد من المعلومات، يمكنك الاطّلاع على أجهزة الصوت.
انقر على حفظ.
يتم عرض تفاصيل التسجيل، بما في ذلك رقم تعريف التطبيق واسمه ونوعه وحالته. دوِّن رقم تعريف التطبيق، لأنّك ستوفّره مع طلبات بيانات Cast API التي يرسلها تطبيقك.
انقر على تم للعودة إلى صفحة "التطبيقات".
تعديل معلومات التطبيق
قبل أن تتمكّن من نشر تطبيقك، عليك تقديم بعض المعلومات الإضافية. يمكنك أيضًا تعديل المعلومات التي قدّمتها حول تطبيقك أثناء التسجيل.
لتعديل معلومات التطبيق، اتّبِع الخطوات التالية:
- في Google Cast SDK Developer Console، انقر على معرّف التطبيق من صفحة نظرة عامة أو صفحة التطبيقات، أو انقر على تعديل للتطبيق الذي تريد تعديله.
- في حقل الاسم، عدِّل الاسم الذي أدخلته عند تسجيل التطبيق.
- بالنسبة إلى تطبيقات "المستقبِل المخصّص"، عدِّل في حقل عنوان URL موقع تطبيق Web Receiver الذي سجّلته.
- بالنسبة إلى تطبيقات Styled Receiver، عدِّل موقع ورقة الأنماط الخاصة بتطبيقك في حقل عنوان URL للواجهة.
ضَع علامة في المربّع يتوافق مع ميزة "البث المتتابع" أو أزِل العلامة منه.
تتيح ميزة "البث عبر الترحيل" لجهاز Web Receiver إمكانية البث من أجهزة مرسِلة غير متصلة بشبكة Wi-Fi نفسها التي يتصل بها جهاز الاستقبال. لإيقاف ميزة "البث المتتابع" على جهاز الاستقبال، أزِل العلامة من هذا المربّع.
ضَع علامة في المربّع إتاحة البث على الأجهزة الصوتية فقط أو أزِلها.
ضَع علامة في هذا المربّع للسماح لتطبيقك برصد أجهزة Google Cast الصوتية. لإيقاف إمكانية استخدام الأجهزة التي تعمل بالصوت فقط، أزِل العلامة من هذا المربّع. لمزيد من المعلومات، اطّلِع على أجهزة الصوت.
في قسم تفاصيل المرسِل، أدخِل ما يلي لكل منصة يتيحها تطبيقك:
أجهزة Android:
- الاسم المؤهَّل بالكامل لحزمة تطبيقك
iOS:
- معرّف iTunes ومعرّف الحزمة المطلوبان من Apple
- معرّف URI لتشغيل التطبيق، باستخدام معرّف URI الذي يستخدمه تطبيق Google Home لتشغيل تطبيقك. لمزيد من المعلومات حول تنسيق معرّف URI المطلوب، راجِع مقالة استخدام مخططات عناوين URL للتواصل مع التطبيقات.
الويب:
- عنوان URL للموقع الإلكتروني الخاص بتطبيقك
في قسم تفاصيل بطاقة بيانات المتجر، اختَر ما إذا كنت تريد إدراج تطبيقك ضمن خدمات Google، مثل chromecast.com/apps.
من القائمة المنسدلة الفئة، اختَر الفئة التي تصف تطبيقك على أفضل نحو.
ملاحظة: يجب أن يتوافق تطبيقك مع أنواع الوسائط الموضّحة هنا بالإضافة إلى الأنواع التي تشير إليها الإعدادات الأخرى. على سبيل المثال، إذا كان تطبيقك يتيح استخدام Google Cast للصوت، واخترت "برامج تلفزيونية وأفلام" هنا، يجب أن يتيح تطبيقك استخدام الأجهزة التي تعمل بالصوت فقط كما هو موضّح في أجهزة الصوت، بالإضافة إلى أحكام تشغيل الفيديو.
لوصف البُلدان التي يتوفّر فيها تطبيقك، اختَر زر الخيار جميع البُلدان أو في البُلدان المحدّدة فقط. وإذا كنت ستحدّد بُلدانًا، ضَع علامة في المربّعات الخاصة بهذه البُلدان في القائمة التي تظهر.
في حقل العنوان، أدخِل عنوانًا وصفيًا لتطبيقك.
استخدِم 50 حرفًا أو أقل. على سبيل المثال، "YouTube".
في حقل الوصف، أدخِل وصفًا لتطبيقك.
استخدِم 80 حرفًا أو أقل. على سبيل المثال، "شاهِد قنواتك المفضّلة على YouTube على أفضل شاشة في المنزل".
في قسم الرسومات، انقر على علامة الجمع لتحميل صورة الرمز الخاصة بتطبيقك.
يجب أن تكون الصورة بأبعاد 512 × 512 بكسل، ويمكن أن تتضمّن خلفية شفافة.
ضمن إضافة ترجماتك، إذا أردت تقديم ترجمات لحقلَي العنوان والوصف، اختَر اللغة من القائمة المنسدلة، وانقر على إضافة، وأدخِل النص المترجَم في مربّع الحوار الذي يظهر. يمكنك أيضًا تحميل صورة للرمز الخاص بهذه الترجمة.
عند الانتهاء من تعديل معلومات تطبيقك، انقر على حفظ.
نشر تطبيقك
يؤدي نشر تطبيقك إلى إتاحته على جميع أجهزة Cast في جميع أنحاء العالم. ويتم أيضًا إنشاء بطاقة بيانات لتطبيقك على خدمات Google، مثل موقع chromecast.com/apps الذي يعرض بطاقات البيانات، حيث يمكن للمستخدمين الاطّلاع على تطبيقك وتنزيله. إذا اخترت إدراج تطبيقك عند تعديل معلومات التطبيق في الخطوة 6 أعلاه، سيظهر في chromecast.com/apps بعد نشره.
لنشر تطبيقك، اتّبِع الخطوات التالية:
في Google Cast SDK Developer Console، انقر على نشر من صفحة نظرة عامة أو صفحة التطبيقات للتطبيق الذي تريد نشره.
إذا كانت معلومات طلبك كاملة، ستظهر شاشة معاينة تتضمّن معلومات الطلب التي أدخلتها في تعديل معلومات الطلب. إذا لم يكن الأمر كذلك، ستظهر رسالة تتضمّن المعلومات التي عليك تقديمها.
يمكنك النقر على تعديل للرجوع وتعديل أي معلومات.
إذا كنت مستعدًا لنشر تطبيقك، انقر على نشر.
الإحصاءات
تتتبّع Google Cast SDK Developer Console أداء تطبيقك. بالنسبة إلى كل تطبيق منشور في صفحة "التطبيقات" أو "نظرة عامة"، يمكنك الاطّلاع على بيانات الأداء من خلال النقر على عرض في عمود الإحصاءات.
يتم عرض المعلومات التالية:
- عدد أجهزة استقبال البث التي شغّلت التطبيق
- عدد الجلسات التي تم إطلاقها
- متوسط مدة تشغيل الوسائط (بالدقائق) لكل جلسة
إذا ظهرت منصة أخرى في الإحصاءات، يعني ذلك أنّ المرسِل لم يحدّد منصته، مثلاً إذا لم يتم تحديث جهاز iOS قديم للمرسِل.
الأجهزة
تلقائيًا، لا تكون أجهزة Google Cast (مثل Chromecast أو جهاز Android TV) مفعّلة لأغراض التطوير والاختبار. لتحويل جهازك إلى جهاز تطوير والوصول إلى تطبيق Web Receiver غير المنشور أثناء التطوير، عليك تسجيل الجهاز باستخدام تطبيقك. يتيح التسجيل أيضًا إمكانية الوصول إلى تطبيق الاستقبال من نافذة متصفّح عن بُعد لتصحيح الأخطاء (راجِع تصحيح الأخطاء).
لتسجيل جهاز Google Cast، اتّبِع الخطوات التالية:
إعداد جهاز Google Cast وربطه بشبكة Wi-Fi نفسها التي يتصل بها الكمبيوتر
لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات إعداد جهاز البث.
على الكمبيوتر، افتح متصفّح ويب متوافقًا مع ميزة "البث".
سجِّل الدخول إلى Google Cast SDK Developer Console.
ابحث عن الرقم التسلسلي للجهاز الذي تريد تسجيله.
من صفحة "نظرة عامة" أو صفحة "الأجهزة"، انقر على إضافة جهاز جديد.
أدخِل الرقم التسلسلي لجهازك.
أدخِل وصفًا، ثم انقر على حسنًا.
هذا الاسم هو اسم مألوف لجهازك (ليس من الضروري أن يتطابق مع الاسم الذي أطلقته على الجهاز أثناء إعداد المستخدم).
انتظِر خمس عشرة دقيقة قبل المتابعة.
بعد اكتمال عملية التسجيل، ستظهر الحالة "جاهز للاختبار" للجهاز.
أعِد تشغيل جهاز البثّ: افصِل كابل الطاقة أو كابل USB عن الجهاز، ثم أعِد توصيله.
العثور على الرقم التسلسلي للجهاز
للعثور على الرقم التسلسلي لأي جهاز، يمكنك بث صفحة Cast Developer Console إلى الجهاز باتّباع الخطوات التالية:
انقر على زر "البث" (كما لو كنت تبثّ هذه الصفحة).
يعرض الطلب بث علامة التبويب ويسرد الأجهزة المتاحة.
من القائمة المنسدلة، اختَر الجهاز الذي تريد الحصول على رقمه التسلسلي.
- بالنسبة إلى أجهزة العرض، يظهر الرقم التسلسلي على شاشة التلفزيون ويتم قراءته بصوت عالٍ من خلال مكبّرات صوت التلفزيون (للمساعدة في التمييز بين الرقم 0 والحرف O).
- بالنسبة إلى أجهزة الصوت، يتم قراءة الرقم التسلسلي بصوت عالٍ على السماعة التي يتم البث إليها.
الرقم التسلسلي لبرنامج Android TV
تتضمّن أجهزة Android TV (ATV) أرقامًا تسلسلية متعددة مرتبطة بها. يمكن الحصول على الرقم التسلسلي للبرنامج (Cast) إما من خلال بث صفحة "وحدة تحكّم المطوّرين في Cast" إلى جهاز ATV كما هو موضّح أعلاه، أو من خلال وضع جهاز ATV في وضع مطور البرامج والبحث في إعدادات Cast عن الرقم التسلسلي للبرنامج.
لوضع جهاز Android TV في وضع مطور البرامج، انتقِل إلى الإعدادات > النظام > لمحة > إصدار نظام التشغيل Android TV، وانقر على الإصدار عدة مرات إلى أن يخبرك الجهاز بأنّك في وضع مطور البرامج. للعثور على الرقم التسلسلي مرة واحدة في وضع المطوّرين، انتقِل إلى الإعدادات > إعدادات الجهاز > Google Cast أو الإعدادات > النظام > البث، حسب طراز ATV، وسيظهر لك الرقم التسلسلي للبرنامج.
يُرجى العِلم أنّه عند إعادة ضبط جهاز Android TV على الإعدادات الأصلية، سيتغير الرقم التسلسلي للبرنامج. بعد إعادة ضبط الجهاز على الإعدادات الأصلية، اتّبِع الخطوات المذكورة أعلاه للعثور على الرقم التسلسلي للبرنامج وإعادة تسجيل الرقم التسلسلي الجديد للبرنامج في Cast Developer Console.
مشاكل الحساب
أريد إلغاء تسجيل حسابي في Google Cast Developer Console
يُرجى العلم أنّه لا يمكن استرداد رسوم تسجيل حساب المطوِّر التي تبلغ 5 دولار أمريكي.
لم يعُد بإمكاني الوصول إلى "وحدة تحكّم مطوّري Google Cast"
إذا سبق أن تلقّيت رسالة إلكترونية منّا تفيد بأنّه تم تعليق حساب المطوّر الخاص بك بسبب رصد انتهاكات متعددة لبنود الخدمة أو سياسات المحتوى، يُرجى الردّ على تلك الرسالة إذا كنت بحاجة إلى مزيد من التوضيح.
تمت إزالة تطبيقي من Google Cast
تُعدّ التطبيقات التي تمت إزالتها إنذارات تؤثّر سلبًا في الوضع الجيد لحسابك كمطوّر. وقد تؤدي الانتهاكات المتعددة أو الجسيمة للسياسات إلى إغلاق حسابك كمطوّر.
تعني الإزالة أنّ المستخدمين لن يتمكّنوا من عرض التطبيق الذي تمت إزالته أو الوصول إليه. إذا كانت بيانات اعتماد المطوّر في وضْع جيّد على Google Cast وكان نوع تطبيقك يسمح بذلك، يمكنك إجراء تصحيحات ونشر نسخة جديدة متوافقة من التطبيق.
يُرجى عدم إعادة نشر تطبيق تمت إزالته إلا بعد أن يتم إصلاح انتهاك السياسة فيه.
أريد تغيير عنوان البريد الإلكتروني المرتبط بحسابي
لا يمكنك تغيير عنوان البريد الإلكتروني المرتبط بحسابك كمطوّر على Google Cast. إذا كنت تعمل في مؤسسة، ننصحك باستخدام عنوان بريد إلكتروني خاص بالفريق لتجنُّب مشاكل الوصول في المستقبل.
أواجه مشكلة أخرى
يُرجى الاطّلاع على صفحة دعم حزمة تطوير البرامج (SDK) الخاصة بـ Cast.