تسجيل

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

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

عليك أيضًا تسجيل جهاز Google Cast ليتمكّن من الوصول إلى تطبيق Web Receiver قبل نشره. بعد نشر تطبيق الاستقبال، سيصبح متاحًا لجميع أجهزة Google Cast.

التطبيقات

يتيح لك تسجيل تطبيقك اختباره على جهاز Cast المسجّل قبل نشر التطبيق. يؤدي نشر التطبيق إلى إتاحته لجميع أجهزة البث.

تسجيل تطبيقك

يجب تسجيل جهاز استقبال وسائط ذي نمط أو جهاز استقبال مخصّص لتلقّي معرّف تطبيق يُستخدم مع طلبات البيانات من واجهة برمجة التطبيقات من تطبيق المُرسِل.

لتسجيل تطبيق Cast:

1. سجِّل الدخول إلى Google Cast SDK Developer Console.
2. من صفحة نظرة عامة أو صفحة التطبيقات، انقر على إضافة تطبيق جديد.

3. اختَر نوع تطبيق Web Receiver الذي ستستخدمه:

   • تطبيق الاستقبال المخصّص

     يُرجى اختيار هذا الخيار إذا كان تطبيقك يتطلّب مكوّنات واجهة مستخدم أو أنماط تفاعل لا يوفّرها "مستقبل الوسائط المصمَّم". قد يكون اختيار "جهاز استقبال مخصّص" ضروريًا أيضًا إذا لم يكن نوع المحتوى مدرجًا كأحد أنواع الوسائط المتوافقة مع "جهاز استقبال وسائط ذي نمط".

     يُرجى العِلم أنّ هذا الخيار يتطلّب إنشاء تطبيق ويب كامل لتطبيق Web Receiver.

     لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة تطبيق الاستقبال المخصّص.

   • Styled Media Receiver

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

     تتيح لك الأنماط المخصّصة التي يمكنك تقديمها تحديد مظهر العناصر المختلفة لواجهة مستخدم المشغّل (مثل شاشة البداية وشريط التقدم) ببساطة عن طريق تقديم ملف CSS، ولست بحاجة إلى إنشاء تطبيق استقبال.

     لمعرفة التفاصيل، يُرجى الاطّلاع على Styled Media Receiver.

4. املأ تفاصيل تطبيق Web Receiver:

   1. في حقل الاسم، أدخِل اسم تطبيقك.

      هذا هو اسم التطبيق كما يظهر عند تحميل تطبيق Web Receiver أو في حالة عدم النشاط إذا كنت تستخدم تطبيق Styled Media Receiver. إذا كنت تستخدم جهاز استقبال مخصّصًا، تكون قيمة هذا الحقل هي القيمة التلقائية لحالة التطبيق، إذا لم يتم ضبطها باستخدام طريقة setApplicationState.

   2. حدِّد مظهر تطبيق Web Receiver:

      • بالنسبة إلى تطبيق استقبال مخصّص، حدِّد عنوان URL للتطبيق في حقل عنوان URL.

        أدخِل عنوان URL الذي يجب أن يطلبه جهاز Google Cast عند تحميل تطبيق Web Receiver. أثناء عملية التطوير، يمكن أن يستخدم عنوان URL بروتوكول HTTP، ولكن عند نشر التطبيق، يجب أن يستخدم بروتوكول HTTPS. قد يكون عنوان URL لصفحة HTML أو نوع ملف آخر يمكن الوصول إليه من متصفّح ويب. لا بأس أن يكون جهاز استقبال الويب على عنوان IP داخلي (مسجَّل في NAT)، ولكن ليس على المضيف المحلي، لأنّه نادرًا ما يكون نطاق مستوى أعلى. على الرغم من أنّه يجب عرض تطبيق Web Receiver عبر بروتوكول SSL (HTTPS) عند نشره، قد يتم عرض المحتوى الذي تم تحميله على تطبيق Web Receiver عبر بروتوكول HTTP.

      • بالنسبة إلى Styled Media Receiver، في حقل عنوان URL للمظهر، حدِّد عنوان URL لورقة الأنماط.

        يجب تقديم عنوان URL يستخدم HTTPS ويشير إلى ملف CSS على موقعك الإلكتروني. لاستخدام الأنماط التلقائية، اترك الحقل فارغًا. يمكنك دائمًا تعديل هذا لاحقًا إذا كنت تريد تقديم أو تحديث الأنماط المخصصة الخاصة بك.

      • ضَع علامة في المربّع يتيح البث عبر جهاز وسيط أو اتركه فارغًا.

        تتيح ميزة "البث عبر جهاز وسيط" لجهاز الاستقبال على الويب إمكانية البث من أجهزة الإرسال غير المتصلة بشبكة Wi-Fi نفسها التي يتصل بها جهاز الاستقبال. لإيقاف ميزة "البث عبر جهاز وسيط" على جهاز الاستقبال، أزِل العلامة من هذا المربّع.

      • ضَع علامة في مربّع الاختيار يتيح البث إلى الأجهزة الصوتية فقط أو اتركه بدون علامة.

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

5. انقر على حفظ.

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

6. انقر على تم للعودة إلى صفحة "التطبيقات".

تعديل معلومات التطبيق

قبل أن تتمكّن من نشر تطبيقك، عليك تقديم بعض المعلومات الإضافية. يمكنك أيضًا تعديل المعلومات التي قدّمتها عن تطبيقك أثناء التسجيل.

لتعديل معلومات التطبيق:

1. في وحدة تحكّم مطوّري حزمة تطوير البرامج (SDK) في Google Cast، انقر على رقم تعريف التطبيق من صفحة نظرة عامة أو صفحة التطبيقات، أو انقر على تعديل للتطبيق الذي تريد تعديله.
2. في حقل الاسم، عدِّل الاسم الذي قدّمته عند تسجيل التطبيق.
3. بالنسبة إلى تطبيقات Custom Receiver، عدِّل موقع تطبيق Web Receiver الذي سجّلته في حقل عنوان URL.
4. بالنسبة إلى تطبيقات Styled Receiver، عدِّل موقع ورقة أنماط تطبيقك في حقل عنوان URL للمظهر.

5. ضَع علامة في المربّع يتيح البث عبر جهاز وسيط أو اتركه فارغًا.

   تتيح ميزة "البث عبر جهاز وسيط" لجهاز الاستقبال على الويب إمكانية البث من أجهزة الإرسال غير المتصلة بشبكة Wi-Fi نفسها التي يتصل بها جهاز الاستقبال. لإيقاف ميزة "البث عبر جهاز وسيط" على جهاز الاستقبال، أزِل العلامة من هذا المربّع.

6. ضَع علامة في المربّع يتيح البث على الأجهزة الصوتية فقط أو اتركه بدون علامة.

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

7. في قسم تفاصيل المُرسِل، أدخِل المعلومات التالية لكل نظام أساسي يتوافق معه تطبيقك:

   • أجهزة Android:

     • الاسم المؤهَّل بالكامل لحزمة تطبيقك

   • iOS:

     • معرّف iTunes ومعرّف الحزمة المطلوبَين من Apple.
     • معرّف الموارد المنتظم (URI) لتشغيل التطبيق، باستخدام معرّف الموارد المنتظم (URI) الذي يستخدمه تطبيق Google Home لتشغيل تطبيقك. لمزيد من المعلومات حول تنسيق معرّف الموارد المنتظم (URI) المطلوب، يُرجى الاطّلاع على استخدام مخطّطات عناوين URL للتواصل مع التطبيقات.

   • الويب:

     • عنوان URL للموقع الإلكتروني الخاص بتطبيقك

8. في قسم تفاصيل بطاقة بيانات المتجر، اختَر ما إذا كنت تريد إدراج تطبيقك على خدمات Google، مثل chromecast.com/apps.

9. من القائمة المنسدلة الفئة، اختَر الفئة التي تصف تطبيقك على أفضل نحو.

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

10. لوصف البلدان التي يتوفّر فيها تطبيقك، اختَر زر الاختيار جميع البلدان أو في البلدان المحدّدة فقط، وفي حال تحديد البلدان، ضَع علامة في المربّعات بجانب تلك البلدان في القائمة التي تظهر.

11. في حقل العنوان، أدخِل عنوانًا وصفيًا لتطبيقك.

    يجب استخدام 50 حرفًا أو أقل. على سبيل المثال، "YouTube".

12. في حقل الوصف، أدخِل وصفًا لتطبيقك.

    يجب استخدام 80 حرفًا أو أقل. على سبيل المثال، "شاهِد قنواتك المفضّلة على YouTube على أفضل شاشة في المنزل".

13. في قسم الرسومات، انقر على علامة الجمع لتحميل صورة الرمز لتطبيقك.

    يجب أن تكون الصورة بحجم 512 × 512 بكسل، ويمكن أن تكون لها خلفية شفافة.

14. ضمن إضافة ترجماتك الخاصة، إذا أردت تقديم ترجمات لحقلَي العنوان والوصف، اختَر اللغة من القائمة المنسدلة، وانقر على إضافة، وأدخِل النص المترجَم في مربّع الحوار الذي يظهر. يمكنك أيضًا تحميل صورة للرمز الخاص بتلك الترجمة.

15. عند الانتهاء من تعديل معلومات التطبيق، انقر على حفظ.

نشر تطبيقك

يؤدي نشر تطبيقك إلى إتاحته لجميع أجهزة Cast في جميع أنحاء العالم. وتنشئ أيضًا بطاقة بيانات لتطبيقك على خدمات Google، مثل الموقع الإلكتروني chromecast.com/apps الذي يتضمّن بطاقات بيانات التطبيقات، حيث يمكن للمستخدمين العثور على تطبيقك وتنزيله. إذا اخترت إدراج تطبيقك في بطاقة بيانات عند تعديل معلومات التطبيق في الخطوة 6 أعلاه، سيظهر في chromecast.com/apps بعد نشره.

لنشر تطبيقك، اتّبِع الخطوات التالية:

1. في وحدة تحكّم مطوّري حزمة تطوير البرامج (SDK) لتطبيق Google Cast، انقر على نشر للتطبيق الذي تريد نشره، وذلك من صفحة نظرة عامة أو صفحة التطبيقات.

   إذا كانت معلومات التطبيق مكتملة، ستظهر شاشة معاينة تتضمّن معلومات التطبيق التي أدخلتها في تعديل معلومات التطبيق. إذا لم يكن الأمر كذلك، فستظهر رسالة توضح المعلومات التي تحتاج إلى تقديمها.

2. يمكنك النقر على تعديل للرجوع وتعديل أي معلومات.

3. إذا كنت مستعدًا لنشر تطبيقك، انقر على نشر.

الإحصاءات

تتتبّع وحدة تحكّم مطوّري حزمة تطوير البرامج (SDK) في Google Cast أداء تطبيقك. بالنسبة إلى كل تطبيق منشور في صفحة "التطبيقات" أو "نظرة عامة"، يمكنك الاطّلاع على بيانات الأداء من خلال النقر على عرض في عمود الإحصاءات.

يتم عرض المعلومات التالية:

• عدد أجهزة استقبال البث التي شغّلت التطبيق
• عدد الجلسات التي تم إطلاقها
• متوسط وقت تشغيل الوسائط (بالدقائق) لكل جلسة

إذا ظهرت منصة أخرى في الإحصاءات، يعني ذلك أنّ المُرسِل لم يحدّد منصته، على سبيل المثال، إذا لم يتم تحديث إصدار قديم من نظام التشغيل iOS لدى المُرسِل.

الأجهزة

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

لتسجيل جهاز Google Cast، اتّبِع الخطوات التالية:

1. اضبط إعدادات جهاز Google Cast واربطه بشبكة Wi-Fi نفسها التي يتصل بها الكمبيوتر.

   يُرجى الاطّلاع على تعليمات إعداد جهاز البث لمزيد من المعلومات.

2. على الكمبيوتر، افتح متصفّح ويب متوافقًا مع Cast.

3. سجِّل الدخول إلى وحدة تحكّم مطوّري برامج Google Cast SDK.

4. ابحث عن الرقم التسلسلي للجهاز الذي تريد تسجيله.

5. من صفحة "نظرة عامة" (Overview) أو صفحة "الأجهزة" (Devices)، انقر على إضافة جهاز جديد (Add New Device).

6. أدخِل الرقم التسلسلي لجهازك.

7. أدخِل وصفًا، ثم انقر على حسنًا.

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

8. انتظِر لمدة خمس عشرة دقيقة قبل المتابعة.

   بعد اكتمال التسجيل، ستظهر حالة الجهاز "جاهز للاختبار".

9. أعِد تشغيل جهاز Cast: افصِل كابل الطاقة أو كابل USB عن الجهاز، ثم أعِد توصيله.

العثور على الرقم التسلسلي للجهاز

للعثور على الرقم التسلسلي لأي جهاز، يمكنك بث صفحة Cast Developer Console إلى الجهاز:

1. انقر على زر "البث" (كما لو كنت تبث هذه الصفحة).

   يعرض الطلب علامة تبويب البث ويسرد الأجهزة المتاحة.

2. من القائمة المنسدلة، اختَر الجهاز الذي تريد الحصول على رقمه التسلسلي.

   • بالنسبة إلى أجهزة العرض، يظهر الرقم التسلسلي على شاشة التلفزيون ويتم قراءته بصوت عالٍ من خلال مكبرات الصوت في التلفزيون (للمساعدة في توضيح الفرق بين الرقم 0 والحرف O).
   • بالنسبة إلى الأجهزة الصوتية، تتم قراءة الرقم التسلسلي بصوت عالٍ على مكبّر الصوت الذي يتم البث إليه.

الرقم التسلسلي لبرنامج Android TV

تحتوي أجهزة Android TV على أرقام تسلسلية متعددة مرتبطة بها. يمكن الحصول على الرقم التسلسلي للبرنامج (Cast) إما من خلال بث صفحة Cast Developer Console إلى جهاز Android TV كما هو موضّح أعلاه، أو من خلال وضع جهاز Android TV في وضع مطوّر البرامج والبحث في إعدادات Cast عن الرقم التسلسلي للبرنامج.

لتفعيل وضع مطوّر البرامج على جهاز Android TV، انتقِل إلى الإعدادات > النظام > لمحة > إصدار نظام التشغيل Android TV، وانقر على الإصدار عدّة مرات إلى أن يظهر لك إشعار على الجهاز بأنّك في وضع مطوّر البرامج. للعثور على الرقم التسلسلي مرة واحدة في وضع مطوّر البرامج، انتقِل إلى الإعدادات > الإعدادات المفضّلة للجهاز > Google Cast أو الإعدادات > النظام > البث، حسب طراز Android TV، وسيظهر لك الرقم التسلسلي للبرنامج.

يُرجى العِلم أنّه عند إعادة ضبط جهاز Android TV على الإعدادات الأصلية، سيتغيّر الرقم التسلسلي للبرنامج. بعد إعادة الضبط على الإعدادات الأصلية، اتّبِع الخطوات أعلاه للعثور على الرقم التسلسلي للبرنامج وإعادة تسجيل الرقم التسلسلي الجديد لبرنامج الجهاز في Cast Developer Console.

مشاكل الحساب

أريد إلغاء تسجيلي في Google Cast Developer Console

إنّ رسوم تسجيل حساب المطوّر التي تبلغ 5 دولار أمريكي غير قابلة للاسترداد.

لم يعُد بإمكاني الوصول إلى Google Cast Developer Console

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

تمت إزالة تطبيقي من Google Cast

تُعدّ التطبيقات التي تتم إزالتها إنذارات تؤثّر سلبًا في الوضع الجيد لحسابك كمطوّر. وقد تؤدي الانتهاكات المتعددة أو الجسيمة للسياسات إلى إغلاق حسابك كمطوّر.

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

يُرجى عدم إعادة نشر تطبيق تمت إزالته إلا بعد معالجة انتهاك السياسة.

أريد تغيير عنوان البريد الإلكتروني المرتبط بحسابي

لا يمكنك تغيير عنوان البريد الإلكتروني المرتبط بحساب المطوّر على Google Cast. إذا كنت تعمل لدى مؤسسة، ننصحك باستخدام عنوان بريد إلكتروني للفريق لتجنُّب مشاكل الوصول في المستقبل.

أواجه مشكلة أخرى

يُرجى الاطّلاع على صفحة دعم حزمة تطوير البرامج (SDK) لتطبيق Google Cast.