تسجيل

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

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

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

التطبيقات

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

تسجيل طلبك

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

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

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

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

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

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

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

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

   • جهاز استقبال الوسائط المخصّص

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

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

     لمعرفة التفاصيل، يُرجى الاطّلاع على مستلِم الوسائط المخصّص.

4. أدخِل تفاصيل تطبيق Web Receiver:

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

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

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

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

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

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

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

      • ضَع علامة في مربّع الاختيار تتوفّر ميزة بث المحتوى عبر البثّ المباشر أو أزِلها.

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

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

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

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

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

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

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

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

لتعديل معلومات التطبيق، اتّبِع الخطوات التالية:

1. في وحدة تحكّم مطوّري Google Cast SDK، انقر على رقم تعريف التطبيق أو انقر على تعديل للتطبيق الذي تريد تعديله، وذلك من صفحة نظرة عامة أو صفحة التطبيقات.
2. في حقل الاسم، عدِّل الاسم الذي قدّمته عند تسجيل التطبيق.
3. بالنسبة إلى تطبيقات "المستلِم المخصّص"، عدِّل في حقل عنوان URL الموقع الجغرافي لتطبيق "مُستلِم الويب" الذي سجّلته.
4. بالنسبة إلى تطبيقات "مُستلِم الرسائل المُعدَّلة"، عدِّل موقع جدول الأنماط الخاص بتطبيقك في حقل عنوان 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. ضمن إضافة ترجماتك الخاصة، إذا كنت تريد تقديم ترجمات للحقلين العنوان والوصف، اختَر اللغة من القائمة المنسدلة، وانقر على إضافة، وأدخِل النص المترجَم في مربّع الحوار الذي يظهر. يمكنك أيضًا تحميل صورة للرمز المخصّص لهذه translation.

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

نشر طلبك

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

لنشر طلبك:

1. في Google Play Console لـ Google Cast SDK، انقر على نشر في التطبيق الذي تريد نشره، سواء من صفحة نظرة عامة أو صفحة التطبيقات.

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

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

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

الإحصاءات

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

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

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

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

الأجهزة

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

لتسجيل جهاز Google Cast:

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

   اطّلِع على تعليمات إعداد جهاز البث للحصول على مزيد من المعلومات.

2. على جهاز الكمبيوتر، افتح متصفّح ويب متوافقًا مع أجهزة البث.

3. سجِّل الدخول إلى Play Console لـ Google Cast SDK.

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

5. من صفحة "نظرة عامة" أو صفحة "الأجهزة"، انقر على إضافة جهاز جديد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مشاكل الحساب

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

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

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

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

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

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

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

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

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

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

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

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