Solución de problemas
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Se abre la app de Receptor web en Android TV
Si Web Receiver se abre en Android TV en lugar de tu app nativa de forma inesperada, responde algunas preguntas para solucionar el problema:
¿La app estaba instalada desde Play Store?
De lo contrario, verifica el número de serie del software de tu dispositivo Android TV (NO el número de serie del hardware del dispositivo) para ver si aparece correctamente en la misma Play Console de Cast en la que se incluye el ID de tu receptor. Consulta la página de registro y obtén instrucciones para registrar tu dispositivo si no aparece en la lista.
Este número de serie puede cambiar. Es un número de serie del software y no es el que está escrito en el dispositivo.
¿Ves errores APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER o INSTALLER_NOT_WHITELISTED en los registros?
Estos errores indican que la app se instaló desde una fuente no confiable (no desde Play Store) y que el número de serie del software y el ID del receptor no están registrados correctamente en la misma Consola para desarrolladores de Cast.
¿El número de serie del software de tu dispositivo y el ID del receptor están en la misma Consola para desarrolladores de Cast?
Tanto el número de serie del dispositivo como el ID del receptor deben aparecer en la misma Consola para desarrolladores de Cast.
Consulta la
página de registro y obtén instrucciones para encontrar el número de serie del software de tu dispositivo.
¿El número de serie del software de tu dispositivo es correcto?
El número de serie de software del dispositivo Android TV que se usa para Cast es diferente del número de serie de hardware que aparece en el dispositivo y puede cambiar.
Consulta la
página de registro y obtén instrucciones para encontrar el número de serie del software de tu dispositivo.
¿Tu app emisora está habilitada para Cast Connect?
Asegúrate de que la app emisora instalada tenga habilitada la compatibilidad con Cast Connect, como se detalla en la sección Configuración de la app emisora.
¿Tienes una LaunchRequestChecker para tu app de Android TV?
En ese caso, intenta quitar tu LaunchRequestChecker para ver si la app inicia correctamente el receptor nativo de Android TV. Si esto soluciona el problema, es posible que debas corregir la lógica del verificador de inicio o acceder a la app emisora.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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."]]
