Pemecahan masalah
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Penerima Web terbuka di Android TV
Jika Penerima Web terbuka di Android TV, bukan di aplikasi native,
secara tidak terduga, jawab beberapa pertanyaan untuk memecahkan masalah:
Apakah aplikasi diinstal dari Play Store?
Jika tidak, periksa nomor seri software perangkat Android TV Anda (BUKAN
nomor seri hardware pada perangkat) untuk melihat apakah nomor tersebut tercantum dengan benar
di Cast Developer Console
yang sama dengan yang tercantum pada penerimaID Anda. Lihat halaman pendaftaran untuk mengetahui petunjuk cara mendaftarkan perangkat Anda jika tidak tercantum.
Nomor seri ini dapat berubah. Ini adalah nomor seri software,
dan bukan yang tertera di perangkat.
Apakah Anda melihat error APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER
atau INSTALLER_NOT_WHITELISTED
dalam log?
Error ini menunjukkan bahwa aplikasi diinstal dari sumber tidak tepercaya
(bukan Play Store) dan nomor seri software serta ID penerima
tidak terdaftar dengan benar di
Konsol Developer Cast yang sama.
Apakah nomor seri dan ID penerima software perangkat Anda
tercantum dalam Konsol Developer Cast yang sama?
Nomor seri perangkat dan ID penerima harus tercantum
di
Konsol Developer Cast yang sama.
Lihat
halaman pendaftaran
untuk mendapatkan petunjuk cara menemukan nomor seri software perangkat Anda.
Apakah nomor seri software perangkat Anda sudah benar?
Nomor seri software perangkat Android TV Anda yang digunakan untuk Cast
berbeda dengan nomor seri hardware yang tercantum di perangkat dan dapat
berubah.
Lihat
halaman pendaftaran
untuk mendapatkan petunjuk cara menemukan nomor seri software perangkat Anda.
Apakah aplikasi pengirim Anda Cast Connect diaktifkan?
Pastikan aplikasi pengirim yang diinstal mengaktifkan dukungan Cast Connect seperti
yang dijelaskan di bagian
penyiapan aplikasi pengirim.
Apakah nama paket aplikasi Android TV Anda sudah tercantum dengan benar di Konsol Developer Cast?
Pastikan nama paket di
Konsol Developer Cast, seperti yang ditampilkan di
bagian
penyiapan Konsol Developer Cast, cocok dengan aplikasi yang diinstal di Android TV Anda.
Punya LaunchRequestChecker
untuk
aplikasi Android TV Anda?
Jika demikian, coba hapus LaunchRequestChecker
untuk melihat apakah
aplikasi meluncurkan penerima Android TV native dengan benar. Jika hal ini memperbaiki
masalah, Anda mungkin perlu memperbaiki logika pemeriksa peluncuran atau login ke
aplikasi pengirim.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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."]]