تسجيل

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

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

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

التطبيقات

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

تسجيل تطبيقك

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

لتسجيل تطبيق البث:

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

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

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

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

     تجدر الإشارة إلى أنّ هذا الخيار يتطلب منك إنشاء تطبيق ويب كامل لتطبيق WebRecipient.

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

   • جهاز استقبال وسائط بنمط معيّن

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

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

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

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

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

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

   2. حدِّد مظهر تطبيق "جهاز استقبال الويب":

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

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

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

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

      • ضَع علامة في مربّع الاختيار إتاحة البث من خلال جهاز آخر أو أزِل العلامة من المربّع.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

نشر التطبيق

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

لنشر تطبيقك:

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

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

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

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

الإحصاءات

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

يتم تقديم المعلومات التالية:

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

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

الأجهزة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مشاكل الحساب

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

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

لم يعُد بإمكاني الدخول إلى وحدة تحكّم المطوّرين في Google Cast.

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

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

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

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

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

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

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

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

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