疑難排解
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Web Receiver 在 Android TV 上開啟
如果 Web Receiver 在 Android TV 中開啟，而不是意外開啟原生應用程式，請回答幾個問題來排解問題：
應用程式是從 Play 商店安裝嗎？
如果沒有，請查看 Android TV 裝置的軟體序號 (而非裝置的硬體序號)，確認該裝置是否已在列出接收者 ID 的同一個 Cast 開發人員控制台中列出。如果裝置不在清單中，請參閱註冊頁面的操作說明，瞭解如何註冊裝置。
序號可能變動。此為軟體序號，而非裝置上寫入的序號。
您在記錄檔中是否看到 APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER 或 INSTALLER_NOT_WHITELISTED 錯誤？
這些錯誤表示應用程式是從不受信任的來源 (非 Play 商店) 安裝，且軟體序號和接收器 ID 未在相同的 Cast 開發人員控制台中正確註冊。
同一個 Cast 開發人員控制台是否列出您的裝置軟體序號和接收器？
裝置序號和接收器 ID 都必須列在相同的 Cast 開發人員控制台中。
如需找出裝置軟體序號的操作說明，請參閱
註冊頁面。
裝置軟體序號是否正確？
用於 Cast 的 Android TV 裝置軟體序號與裝置硬體序號不同，因此可能會變更。
如需找出裝置軟體序號的操作說明，請參閱
註冊頁面。
通訊端應用程式是否已啟用 Cast Connect？
按照「寄件者應用程式設定」一節的詳細說明，確認已安裝的傳送者應用程式已啟用 Cast Connect 支援。
你的 Android TV 應用程式是否LaunchRequestChecker適用？
如果是的話，請嘗試移除 LaunchRequestChecker，看看應用程式是否可正確啟動原生 Android TV 接收器。如果問題已經解決，您可能需要修正啟動檢查工具邏輯或登入傳送者應用程式。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 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."]]
