يجب تسجيل تطبيقك إذا كنت تستخدم جهاز استقبال الوسائط ذات النمط أو تنشئ جهاز استقبال مخصص. بعد تسجيل التطبيق، ستتلقى معرّف التطبيق الذي يستخدمه تطبيق المرسل لإجراء اتصالات واجهة برمجة التطبيقات مثل تشغيل تطبيق استقبال الويب.
إذا كنت تستخدم جهاز استقبال الوسائط الافتراضي، فلن تحتاج إلى تسجيل تطبيقك. لا يسمح لك "جهاز استقبال الوسائط الافتراضي" بتوفير أي نمط لواجهة مستخدم مشغّل الوسائط، ويستخدم رقمًا ثابتًا محددًا كرقم تعريف التطبيق.
كذلك، يجب عليك تسجيل جهاز Google Cast حتى يتمكن من الوصول إلى تطبيق Web (استقبال الويب) قبل نشره. بعد نشر تطبيق المُستلِم، سيكون متاحًا لجميع أجهزة Google Cast.
التطبيقات
يتيح لك تسجيل التطبيق اختباره مقارنةً بجهاز البث المسجّل قبل نشر التطبيق. يؤدي نشر التطبيق إلى جعله متاحًا على جميع أجهزة البثّ.
تسجيل طلبك
يجب تسجيل جهاز استقبال وسائط نمط أو مستلم مخصص لتلقي معرّف التطبيق الذي يتم استخدامه مع طلبات بيانات من واجهة برمجة التطبيقات من تطبيق المرسِل.
لتسجيل تطبيق البثّ:
- سجِّل الدخول إلى Google Cast SDK Developer Console.
- من صفحة Overview (نظرة عامة) أو صفحة Applications (التطبيقات)، انقر على Add New Application (إضافة تطبيق جديد).
اختَر نوع تطبيق "جهاز استقبال الويب" الذي ستستخدمه:
جهاز استقبال مخصّص
حدد هذا الخيار إذا كان تطبيقك يتطلب مكونات واجهة المستخدم أو أنماط تفاعل لا يوفرها جهاز استقبال الوسائط ذات الأنماط الخاصة. قد يكون من الضروري أيضًا اختيار "مستلم مخصص" إذا لم يكن نوع المحتوى مدرجًا كأحد أنواع الوسائط المتوافقة من أجهزة استقبال الوسائط ذات النمط التقليدي.
اعلم أن هذا الخيار يتطلب منك إنشاء تطبيق ويب كامل لتطبيق مستقبِل الويب.
لمعرفة التفاصيل، يُرجى الاطّلاع على تطبيق جهاز الاستقبال المخصّص.
جهاز استقبال الوسائط بنمط معيّن
حدِّد هذا الخيار إذا كان تطبيقك يبث محتوى فيديو أو محتوى صوتي باستخدام أحد أنواع الوسائط المتوافقة وكنت تريد توفير واجهة مستخدم على التلفزيون تستخدم واجهة مستخدم مشغّل الوسائط التلقائي أو مجموعة من الأنماط المخصّصة أعلى واجهة مستخدم مشغّل الوسائط التلقائي.
تتيح لك الأنماط المخصّصة التي قد توفّرها تحديد مظهر العناصر المختلفة في واجهة مستخدِم المشغّل (مثل شاشة البداية وشريط التقدّم)، وذلك من خلال توفير ملف CSS، وليس عليك إنشاء تطبيق مستقبِل.
لمعرفة التفاصيل، يُرجى الاطّلاع على جهاز استقبال الوسائط بنمط معيّن.
املأ تفاصيل تطبيق "جهاز استقبال الويب":
في حقل الاسم، أدخِل اسم تطبيقك.
هذا هو اسم التطبيق كما يظهر عند تحميل "جهاز استقبال الويب" أو في حالة الخمول إذا كنت تستخدم جهاز استقبال الوسائط ذات الأنماط المختلفة. إذا كنت تستخدم جهاز استقبال مخصّص، تكون قيمة هذا الحقل هي القيمة التلقائية لحالة التطبيق، إذا لم يتم ضبطها باستخدام الطريقة
setApplicationState.حدِّد مظهر تطبيق مستقبِل الويب:
بالنسبة إلى المستلِم المخصّص، حدِّد عنوان URL للتطبيق في حقل عنوان URL.
أدخِل عنوان URL الذي يجب أن يطلبه جهاز Google Cast عند تحميل تطبيق "جهاز استقبال الويب". وخلال عملية التطوير، يمكن لعنوان URL استخدام HTTP ولكن يجب أن يستخدم التطبيق HTTPS عند نشره. قد يكون عنوان URL لصفحة HTML أو أي نوع ملف آخر يمكن الوصول إليه من متصفّح ويب لا بأس أن يكون جهاز استقبال الويب على عنوان IP داخلي (مسجّل من NAT)، ولكن ليس على مضيف محلي، لأنه نادرًا ما يكون نطاق المستوى الأعلى. على الرغم من أنّه يجب عرض تطبيق جهاز استقبال الويب عبر طبقة المقابس الآمنة (HTTPS) عند نشره، قد يتم عرض المحتوى الذي يتم تحميله على تطبيق مستقبِل الويب عبر HTTP.
بالنسبة إلى جهاز استقبال الوسائط ذات الأنماط، في حقل عنوان URL للواجهة، حدِّد عنوان URL لورقة الأنماط.
قدِّم عنوان URL بتنسيق HTTPS يشير إلى ملف CSS المتوفّر على موقعك الإلكتروني. لاستخدام الأنماط التلقائية، اترك الحقل فارغًا. يمكنك دائمًا تعديل هذا لاحقًا إذا كنت ترغب في توفير أنماط مخصصة أو تحديثها.
ضَع علامة في مربّع الاختيار دعم البث من خلال الإرسال أو اتركه بدون وضع علامة فيه.
إنّ البث عبر الإرسال يسمح لجهاز استقبال الويب بتوفير إمكانية البث من مُرسِلين غير متصلين بشبكة Wi-Fi نفسها المتصل بها المُستلِم. لإيقاف البثّ على جهاز الاستقبال، أزِل العلامة من هذا المربّع.
ضَع علامة في مربّع الاختيار تتيح البث على الأجهزة الصوتية فقط أو أزِل العلامة من المربّع.
للسماح لتطبيقك باكتشاف Google Cast للأجهزة الصوتية، ضَع علامة في هذا المربّع. لإيقاف دعم الأجهزة الصوتية فقط، أزِل العلامة من هذا المربع. راجِع الأجهزة السماعية للحصول على مزيد من المعلومات.
انقر على حفظ.
يتم عرض تفاصيل التسجيل، بما في ذلك معرّف التطبيق واسمه ونوعه وحالته. دوِّن معرّف التطبيق، إذ ستقدّمه مع طلبات بيانات من واجهة برمجة التطبيقات Cast API في تطبيقك.
انقر على تم للعودة إلى صفحة "التطبيقات".
تعديل معلومات الطلب
قبل نشر تطبيقك، يجب تقديم بعض المعلومات الإضافية. يمكنك أيضًا تحديث المعلومات التي قدّمتها حول طلبك أثناء التسجيل.
لتعديل معلومات التطبيق:
- في أداة Google Cast SDK Developer Console، إما من صفحة نظرة عامة أو صفحة التطبيقات، انقر على معرّف التطبيق أو انقر على تعديل للتطبيق الذي تريد تعديله.
- في حقل الاسم، عدِّل الاسم الذي قدّمته عند تسجيل الطلب.
- بالنسبة إلى تطبيقات "الاستقبال المخصّص"، في حقل عنوان URL، عدِّل الموقع الجغرافي لتطبيق "مستلِم الويب" الذي سجّلته.
- بالنسبة إلى تطبيقات أجهزة الاستقبال المستندة إلى الأنماط، في حقل عنوان URL للواجهة، عدِّل موقع ورقة أنماط تطبيقك.
ضَع علامة في مربّع الاختيار دعم البث من خلال الإرسال أو اتركه بدون وضع علامة فيه.
إنّ البث عبر الإرسال يسمح لـ "جهاز استقبال الويب" بتوفير إمكانية البث من مرسلين غير متصلين بشبكة 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 بكسل، وقد تكون ذات خلفية شفافة.
ضمن إضافة ترجماتك الخاصة، إذا أردت تقديم ترجمات لحقلي العنوان والوصف، حدد اللغة من القائمة المنسدلة وانقر على إضافة، ثم أدخل النص المترجم في مربع الحوار الذي يظهر. ويمكنك أيضًا تحميل صورة للرمز الخاص بتلك الترجمة.
عند الانتهاء من تعديل معلومات طلبك، انقر على حفظ.
نشر التطبيق
يؤدي نشر تطبيقك إلى إتاحة تطبيقك لجميع أجهزة البث في جميع أنحاء العالم. ويتم أيضًا إنشاء بطاقة بيانات لتطبيقك على خدمات Google مثل موقع بطاقة البيانات chromecast.com/apps حيث يمكن للمستخدمين اكتشاف تطبيقك وتنزيله. إذا اخترت إدراج تطبيقك عند تعديل معلومات التطبيق في الخطوة 6 أعلاه، سيظهر التطبيق في chromecast.com/apps بعد نشرها.
لنشر تطبيقك:
في Google Cast SDK Developer Console، إما من صفحة نظرة عامة أو صفحة التطبيقات، انقر على نشر للتطبيق الذي تريد نشره.
إذا كانت معلومات طلب الاشتراك كاملة، ستظهر شاشة معاينة تحتوي على معلومات التطبيق التي أدخلتها في قسم تعديل معلومات التطبيق. إذا لم يكن كذلك، ستظهر رسالة تستشهد بالمعلومات التي تحتاج إلى تقديمها.
يمكنك النقر على تعديل للعودة وتعديل أي معلومات.
إذا كنت مستعدًا لنشر تطبيقك، انقر على نشر.
الإحصاءات
تعمل وحدة تحكم مطوّري برامج Google Cast SDK على تتبع أداء تطبيقك. بالنسبة إلى كل تطبيق منشور في صفحة "التطبيقات" أو "نظرة عامة"، يمكنك الاطّلاع على بيانات الأداء من خلال النقر على عرض في العمود الإحصاءات.
يتم تقديم المعلومات التالية:
- عدد أجهزة استقبال البثّ التي شغّلت التطبيق
- عدد الجلسات التي تم إطلاقها
- متوسط وقت تشغيل الوسائط (بالدقائق) لكل جلسة
إذا ظهر نظام أساسي آخر في الإحصاءات، يعني ذلك أنّ المرسِل لم يوضِّح النظام الأساسي له، على سبيل المثال إذا لم يتم تحديث نظام تشغيل قديم لنظام التشغيل iOS.
الأجهزة
لا يتم تلقائيًا تفعيل أجهزة Google Cast (مثل Chromecast أو Android TV) لأغراض التطوير والاختبار. لتحويل جهازك إلى جهاز تطوير والحصول على إمكانية الوصول إلى تطبيق "جهاز استقبال الويب" غير المنشور أثناء عملية التطوير، عليك تسجيل الجهاز في التطبيق. ويتيح التسجيل أيضًا إمكانية الوصول إلى المُستلِم من نافذة متصفّح بعيد لتصحيح الأخطاء (راجع تصحيح الأخطاء).
لتسجيل جهاز Google Cast، يُرجى اتّباع الخطوات التالية:
عليك إعداد جهاز Google Cast وتوصيله بشبكة Wi-Fi نفسها التي يتصل بها جهاز الكمبيوتر.
يمكنك الاطّلاع على تعليمات إعداد جهاز البث للحصول على مزيد من المعلومات.
على جهاز الكمبيوتر، افتح متصفّح ويب يعمل بتكنولوجيا Google Cast.
سجِّل الدخول إلى Google Cast SDK Developer Console.
ابحث عن الرقم التسلسلي للجهاز الذي تريد تسجيله.
من صفحة النظرة العامة أو صفحة "الأجهزة"، انقر على إضافة جهاز جديد.
أدخِل الرقم التسلسلي للجهاز.
أدخِل وصفًا وانقر على حسنًا.
هذا مجرّد اسم يسهل الوصول إليه على جهازك (لا يلزم مطابقة الاسم الذي منحته للجهاز أثناء إعداد المستخدم).
يُرْجَى الِانْتِظَارْ لِمُدَّةْ خَمَسْ عَشْرَةَ دَقِيقَة قَبْلْ الْمُوَاصَلَةْ.
بمجرد اكتمال التسجيل، ستظهر حالة الجهاز "جاهز للاختبار".
أعِد تشغيل جهاز البثّ: افصِل كابل الطاقة أو كابل USB عن الجهاز، ثم أعِد توصيله.
البحث عن الرقم التسلسلي للجهاز
للعثور على الرقم التسلسلي لأي جهاز، يمكنك بث صفحة وحدة تحكم مطوّر برامج Google Cast على الجهاز:
انقر على زر البث (كما لو كنت تبث هذه الصفحة).
تعرض رسالة المطالبة علامة تبويب البث وتعرض الأجهزة المتاحة.
من القائمة المنسدلة، حدد الجهاز الذي تريد الحصول على الرقم التسلسلي له.
- بالنسبة إلى أجهزة العرض، يتم عرض الرقم التسلسلي على شاشة التلفزيون وتتم قراءته بصوت عالٍ على مكبرات صوت التلفزيون (للمساعدة في تمييز أرقام 0 وO).
- بالنسبة إلى الأجهزة السماعية، تتم قراءة الرقم التسلسلي بصوت عالٍ على مكبر الصوت الذي يتم البث عليه.
الرقم التسلسلي لبرنامج Android TV
تحتوي أجهزة Android TV (ATV) على عدة أرقام تسلسلية مرتبطة بها. يمكن الحصول على الرقم التسلسلي للبرنامج (بثّ) إما من خلال بث صفحة وحدة تحكم مطوّري برامج البثّ على جهاز ATV كما هو موضح أعلاه، أو عن طريق وضع جهاز ATV في وضع مطوّر البرامج والبحث في إعدادات البث للرقم التسلسلي للبرنامج.
لتفعيل وضع مطوّر البرامج في جهاز Android TV، انتقِل إلى الإعدادات > النظام > لمحة > إصدار نظام التشغيل Android TV، ثم انقر على الإصدار عدة مرات إلى أن يصلك إشعار من الجهاز يفيد بأنّك في وضع مطوِّر البرامج. للعثور على الرقم التسلسلي مرة واحدة في وضع مطوّر البرامج، انتقِل إلى الإعدادات > الإعدادات المفضّلة للجهاز > Chromecast Built-in أو إلى الإعدادات > النظام > البث، حسب طراز ATV، وسيظهر لك الرقم التسلسلي للبرنامج.
تجدر الإشارة إلى أنّه عند إعادة ضبط جهاز ATV على الإعدادات الأصلية، سيتغير الرقم التسلسلي للبرنامج. بعد إعادة ضبط الجهاز على الإعدادات الأصلية، عليك اتّباع الخطوات الواردة أعلاه للعثور على الرقم التسلسلي للبرنامج وإعادة تسجيل الرقم التسلسلي الجديد للجهاز باستخدام وحدة تحكّم مطوّري برامج Google Cast.
مشاكل الحساب
أريد إلغاء تسجيلي في Google Cast Developer Console.
ولا يمكن ردّ رسوم تسجيل حساب المطوّر التي تبلغ قيمتها 5 دولار أمريكي.
لم أعد قادرًا على الدخول إلى وحدة تحكم مطوّري برامج Google Cast.
إذا سبق أن وصلتك رسالة إلكترونية منّا تفيد بأنّه تم تعليق حساب المطوّر الخاص بك بسبب انتهاكات متعدّدة لبنود الخدمة أو سياسات المحتوى، يُرجى الردّ على هذه الرسالة الإلكترونية إذا كنت بحاجة إلى المزيد من التوضيح.
تمت إزالة تطبيقي من Google Cast
وتُعتبر التطبيقات التي تمت إزالتها إنذارًا يؤثّر سلبًا في وضْع حساب المطوّر الخاص بك. قد تؤدي الانتهاكات المتعددة أو الجسيمة للسياسات إلى إغلاق حسابك كمطوّر.
تعني الإزالة أنّ المستخدمين لن يتمكّنوا من الاطّلاع على التطبيق الذي تمت إزالته أو الوصول إليه. إذا كانت بيانات اعتماد المطوّر في وضْع جيّد على Google Cast وكانت طبيعة تطبيقك تسمح بذلك، يمكنك إجراء تصحيحات ونشر نسخة جديدة متوافقة من التطبيق.
يُرجى عدم إعادة نشر تطبيق تمت إزالته حتى يتم إصلاح انتهاك السياسة.
أريد تغيير عنوان البريد الإلكتروني المرتبط بحسابي
لا يمكنك تغيير عنوان البريد الإلكتروني المرتبط بحساب مطوّر برامج Google Cast، إذا كنت تعمل لصالح مؤسسة، ننصحك باستخدام عنوان بريد إلكتروني للفريق لتجنُّب مشاكل الوصول في المستقبل.
أواجه مشكلة أخرى
يُرجى الاطّلاع على صفحة دعم Cast SDK.