Dépannage
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Web Receiver s'ouvre sur l'Android TV
Si le récepteur Web s'ouvre de manière inattendue sur Android TV au lieu de votre application native, répondez à quelques questions pour résoudre le problème:
L'appli a-t-elle été installée depuis le Play Store ?
Si ce n'est pas le cas, vérifiez le numéro de série du logiciel de votre appareil Android TV (et non le numéro de série du matériel sur l'appareil) pour vous assurer qu'il figure bien dans la même console pour développeur Cast que votre ID de récepteur. Si votre appareil n'est pas listé, consultez la page d'inscription pour savoir comment enregistrer votre appareil.
Ce numéro de série peut changer. Il s'agit d'un numéro de série du logiciel, qui n'est pas celui qui est inscrit sur l'appareil.
Une erreur APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER ou INSTALLER_NOT_WHITELISTED apparaît-elle dans les journaux ?
Ces erreurs indiquent que l'application a été installée à partir d'une source non approuvée (autre que le Play Store), et que le numéro de série du logiciel et l'ID du récepteur ne sont pas correctement enregistrés dans la même console de développement Cast.
Le numéro de série du logiciel de l'appareil et l'ID du récepteur sont-ils indiqués dans la même console pour développeur Cast ?
Le numéro de série de l'appareil et l'ID du récepteur doivent être indiqués dans la même console de développement Cast.
Consultez la
page d'enregistrement pour savoir comment trouver le numéro de série du logiciel de votre appareil.
Le numéro de série du logiciel de votre appareil est-il correct ?
Le numéro de série du logiciel de l'appareil Android TV utilisé pour Cast est différent du numéro de série matériel indiqué sur l'appareil. Il est susceptible de changer.
Consultez la
page d'enregistrement pour savoir comment trouver le numéro de série du logiciel de votre appareil.
L'application émetteur Cast Connect est-elle activée ?
Assurez-vous que la compatibilité avec Cast Connect est activée dans l'application émettrice installée, comme indiqué dans la section Configurer l'application émettrice.
Disposez-vous d'un LaunchRequestChecker pour votre application Android TV ?
Si tel est le cas, essayez de supprimer votre LaunchRequestChecker pour voir si votre application lance correctement le récepteur Android TV natif. Si cela résout votre problème, vous devrez peut-être corriger votre logique de vérification du lancement ou vous connecter à l'application émettrice.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\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."]]
