تحديد المشاكل وحلّها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
فتح جهاز استقبال الويب على Android TV
إذا فتح جهاز استقبال الويب على Android TV بدلاً من تطبيقك الأصلي بشكل غير متوقع، أجب عن بعض الأسئلة لتحديد المشكلة وحلّها:
هل تم تثبيت التطبيق من "متجر Play"؟
إذا لم يكن الأمر كذلك، تحقَّق من الرقم التسلسلي للبرنامج على جهاز Android TV (وليس
الرقم التسلسلي للجهاز) لمعرفة ما إذا كان الجهاز مدرجًا بشكل صحيح
في وحدة تحكم مطوّري برامج Google Cast
نفسها التي تم إدراج معرّف الجهاز المتلقّي الخاص بها. راجِع صفحة التسجيل للحصول على تعليمات حول كيفية تسجيل جهازك إذا لم يكن مدرَجًا.
قد يتغير هذا الرقم التسلسلي. وهو رقم تسلسلي للبرنامج وليس الرقم المكتوب على الجهاز.
هل تظهر لك أخطاء APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER أو INSTALLER_NOT_WHITELISTED في السجلّات؟
تشير هذه الأخطاء إلى أنّه تم تثبيت التطبيق من مصدر غير موثوق به (وليس من "متجر Play") وأنّ الرقم التسلسلي للبرنامج ومعرِّف المستلِم غير مسجَّلَين بشكل صحيح في وحدة تحكم مطوّري برامج Google Cast نفسها.
هل الرقم التسلسلي لبرنامج الجهاز ومعرّف الاستلام مدرَجان في وحدة تحكّم مطوّري تطبيقات Google Cast نفسها؟
يجب إدراج كل من الرقم التسلسلي للجهاز ورقم تعريف المستلِم
في
وحدة تحكّم مطوّري برامج Google Cast نفسها.
راجِع
صفحة التسجيل
للحصول على تعليمات حول كيفية العثور على الرقم التسلسلي لبرنامج جهازك.
هل الرقم التسلسلي لبرنامج الجهاز صحيح؟
يختلف الرقم التسلسلي للبرامج لجهاز Android TV المُستخدَم في البث عن الرقم التسلسلي للجهاز المُدرَج على الجهاز، ويمكن أن يتغيّر.
راجِع
صفحة التسجيل
للحصول على تعليمات حول كيفية العثور على الرقم التسلسلي لبرنامج جهازك.
هل تم تفعيل تطبيق Cast Connect للمُرسِل؟
تأكَّد من تفعيل دعم Cast Connect في تطبيق المُرسِل المثبّت، كما هو موضَّح بالتفصيل في قسم إعداد تطبيق المرسِل.
هل لديك LaunchRequestChecker لتطبيق Android TV؟
إذا كان الأمر كذلك، جرِّب إزالة LaunchRequestChecker لمعرفة ما إذا كان تطبيقك يشغِّل بشكل صحيح جهاز استقبال Android TV الأصلي أم لا. إذا أدى ذلك إلى حلّ المشكلة، قد تحتاج إلى إصلاح منطق أداة التحقّق من الإطلاق أو تسجيل الدخول إلى تطبيق المرسِل.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eIf the Web Receiver opens instead of your native app, ensure your Android TV's software serial number is registered in the same Cast Developer Console as your receiver ID.\u003c/p\u003e\n"],["\u003cp\u003eApps installed from untrusted sources may cause issues; ensure installation is from the Play Store and the device is registered in the Cast Developer Console.\u003c/p\u003e\n"],["\u003cp\u003eVerify your sender app is Cast Connect enabled and that the package name listed in the Cast Developer Console matches the installed app.\u003c/p\u003e\n"],["\u003cp\u003eConsider removing your \u003ccode\u003eLaunchRequestChecker\u003c/code\u003e temporarily to test if it's hindering the native app launch, and adjust its logic or sender app login if necessary.\u003c/p\u003e\n"]]],["When the Web Receiver launches on Android TV instead of the native app, troubleshoot by verifying several points. First, if the app wasn't from the Play Store, ensure the device's software serial number and receiver ID are in the same Cast Developer Console. Check for `APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER` or `INSTALLER_NOT_WHITELISTED` errors. Confirm the software serial number is correct, and differs from the hardware one. Ensure Cast Connect is enabled in the sender app. Verify the package name in the Cast Developer Console matches the app. Lastly, try removing the `LaunchRequestChecker`.\n"],null,["# Troubleshooting\n\nWeb Receiver opens on the Android TV\n------------------------------------\n\nIf the Web Receiver opens on the Android TV instead of your native app\nunexpectedly, answer a few questions to troubleshoot the issue: \n\n#### Was the app installed from the Play Store?\n\nIf not, check the software serial number of your Android TV device (NOT\nthe hardware serial number on the device) to see if it is properly listed\nin the **same\n[Cast Developer Console](https://cast.google.com/publish)\nthat your receiverID is listed** . See the\n[registration page](/cast/docs/registration#devices) for\ninstructions on how to register your device if it is not listed.\n\n**This serial number can change. It is a software serial number\nand is not the one written on the device.** \n\n#### Do you see an\n`APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER` or\n`INSTALLER_NOT_WHITELISTED` errors in the logs?\n\nThese errors indicate that the app was installed from an untrusted source\n(not the Play Store) and that the software serial number and receiverID\nare not properly registered in the same\n[Cast Developer Console](https://cast.google.com/publish). \n\n#### Is your device software serial number and receiverID\nlisted in the same Cast Developer Console?\n\nBoth the device serial number and your receiver's ID need to be listed\nin the same\n[Cast Developer Console](https://cast.google.com/publish).\n\nSee the [registration page](/cast/docs/registration#find_device_serial_number)\nfor instructions on how to find your device's software serial number. \n\n#### Is your device software serial number correct?\n\nThe software serial number of your Android TV device used for Cast is\ndifferent from its hardware serial number listed on the device and can\nchange.\n\nSee the [registration page](/cast/docs/registration#find_device_serial_number)\nfor instructions on how to find your device's software serial number. \n\n#### Is your sender app Cast Connect enabled?\n\nEnsure that the installed sender app has Cast Connect support enabled as\ndetailed in the\n[sender app setup](/cast/docs/android_tv_receiver/core_features#sender_app_setup)\nsection. \n\n#### Is your Android TV app's package name properly\nlisted in the Cast Developer Console?\n\nEnsure that the package name in the\n[Cast Developer Console](https://cast.google.com/publish), as\nshown in the\n[Cast Developer Console setup](/cast/docs/android_tv_receiver/core_features#cast_developer_console_setup)\nsection, matches the app installed on your Android TV. \n\n#### Do you have a `LaunchRequestChecker` for\nyour Android TV app?\n\nIf so, try removing your `LaunchRequestChecker` to see if your\napp properly launches the native Android TV receiver. If this fixes your\nissue, you may need to fix your launch checker logic or log in to the\nsender app."]]
