Khắc phục sự cố
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bộ thu web sẽ mở trên Android TV
Nếu Bộ thu web mở trên Android TV thay vì ứng dụng gốc ngoài dự kiến, hãy trả lời một số câu hỏi để khắc phục vấn đề:
Có phải ứng dụng này được cài đặt qua Cửa hàng Play không?
Nếu không, hãy kiểm tra số sê-ri phần mềm của thiết bị Android TV (KHÔNG PHẢI số sê-ri phần cứng trên thiết bị) để xem số sê-ri đó có được liệt kê chính xác trong cùng Bảng điều khiển dành cho nhà phát triển Cast mà receiverID của bạn liệt kê hay không. Hãy xem trang đăng ký để nắm được hướng dẫn về cách đăng ký thiết bị nếu thiết bị không có trong danh sách.
Số sê-ri này có thể thay đổi. Đây là số sê-ri của phần mềm chứ không phải là số được ghi trên thiết bị.
Bạn có thấy lỗi
APP_NOT_INSTALLED_BY_WHITELISTED_INSTALLER hoặc
INSTALLER_NOT_WHITELISTED trong nhật ký không?
Những lỗi này cho biết ứng dụng được cài đặt từ một nguồn không đáng tin cậy (không phải Cửa hàng Play) và số sê-ri phần mềm cũng như receiverID chưa được đăng ký đúng cách trong cùng một Cast Developer Console.
Số sê-ri phần mềm thiết bị và receiverID của bạn có được liệt kê trong cùng một Cast Developer Console không?
Bạn cần liệt kê cả số sê-ri của thiết bị và mã thiết bị nhận trong cùng một Bảng điều khiển dành cho nhà phát triển Cast.
Hãy xem
trang đăng ký để biết hướng dẫn về cách tìm số sê-ri phần mềm của thiết bị.
Số sê-ri của phần mềm trên thiết bị của bạn có chính xác không?
Số sê-ri phần mềm của thiết bị Android TV dùng để truyền khác với số sê-ri phần cứng liệt kê trên thiết bị và có thể thay đổi.
Hãy xem
trang đăng ký để biết hướng dẫn về cách tìm số sê-ri phần mềm của thiết bị.
Ứng dụng dành cho người gửi của bạn có được bật Cast Connect chưa?
Đảm bảo rằng ứng dụng của người gửi đã cài đặt đã bật tính năng hỗ trợ Cast Connect như đã nêu chi tiết trong phần thiết lập ứng dụng của người gửi.
Bạn đã có LaunchRequestChecker cho ứng dụng trên Android TV chưa?
Nếu vậy, hãy thử xoá LaunchRequestChecker để xem ứng dụng của bạn có chạy đúng cách bộ thu Android TV gốc hay không. Nếu cách này khắc phục được vấn đề thì có thể bạn cần sửa logic của trình kiểm tra hoạt động khởi chạy hoặc đăng nhập vào ứng dụng của người gửi.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
