عیب یابی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گیرنده وب در Android TV باز می شود
اگر گیرنده وب به‌جای برنامه بومی‌تان به‌طور غیرمنتظره در Android TV باز شد، برای عیب‌یابی به چند سؤال پاسخ دهید:
آیا برنامه از Play Store نصب شده است؟
اگر نه، شماره سریال نرم‌افزار دستگاه Android TV خود (نه شماره سریال سخت‌افزاری دستگاه) را بررسی کنید تا ببینید آیا به درستی در همان Cast Developer Console فهرست‌شده است یا خیر . برای اطلاع از نحوه ثبت دستگاه خود در صورتی که در لیست نیست، صفحه ثبت نام را مشاهده کنید.
این شماره سریال می تواند تغییر کند. این یک شماره سریال نرم افزار است و آن چیزی نیست که روی دستگاه نوشته شده است.
آیا یک خطای APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER یا INSTALLER_NOT_WHITELISTED در گزارش‌ها می‌بینید؟
این خطاها نشان می‌دهد که برنامه از یک منبع نامعتبر (نه از فروشگاه Play) نصب شده است و شماره سریال نرم‌افزار و شناسه گیرنده به‌درستی در همان Cast Developer Console ثبت نشده‌اند.
آیا شماره سریال نرم افزار دستگاه و شناسه گیرنده شما در همان Cast Developer Console فهرست شده است؟
هم شماره سریال دستگاه و هم شناسه گیرنده شما باید در همان Cast Developer Console فهرست شوند.
برای دستورالعمل نحوه یافتن شماره سریال نرم افزار دستگاه خود به صفحه ثبت نام مراجعه کنید.
آیا شماره سریال نرم افزار دستگاه شما صحیح است؟
شماره سریال نرم‌افزار دستگاه Android TV شما که برای Cast استفاده می‌شود با شماره سریال سخت‌افزاری که در دستگاه ذکر شده است متفاوت است و می‌تواند تغییر کند.
برای دستورالعمل نحوه یافتن شماره سریال نرم افزار دستگاه خود به صفحه ثبت نام مراجعه کنید.
آیا برنامه فرستنده شما Cast Connect فعال است؟
اطمینان حاصل کنید که برنامه فرستنده نصب شده پشتیبانی Cast Connect را همانطور که در بخش تنظیم برنامه فرستنده توضیح داده شده است، فعال کرده باشد.
آیا نام بسته برنامه Android TV شما به درستی در Cast Developer Console فهرست شده است؟
اطمینان حاصل کنید که نام بسته موجود در Cast Developer Console ، همانطور که در بخش تنظیم کنسول توسعه دهنده Cast نشان داده شده است، با برنامه نصب شده در Android TV شما مطابقت داشته باشد.
آیا LaunchRequestChecker برای برنامه Android TV خود دارید؟
اگر چنین است، سعی کنید LaunchRequestChecker خود را حذف کنید تا ببینید آیا برنامه شما به درستی گیرنده Android TV اصلی را راه اندازی می کند یا خیر. اگر با این کار مشکل شما برطرف شد، ممکن است لازم باشد منطق جستجوگر راه‌اندازی خود را اصلاح کنید یا به برنامه فرستنده وارد شوید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
