Khi phát hành Android 5.0, Android TV hỗ trợ Google Cast. Tài liệu này mô tả những việc bạn cần làm để thiết lập và kiểm thử trên Android TV khi phát triển ứng dụng Truyền. Ứng dụng Truyền hiện có của bạn chạy trên Android TV mà không mất thêm công sức. Nếu bạn đang phát triển một ứng dụng Truyền lần đầu tiên, hãy xem lại tài liệu về Google Cast và phát triển ứng dụng Truyền của bạn để chạy trên thiết bị Chromecast trước tiên phát triển và thử nghiệm với Android TV.
Thiết lập cho hoạt động phát triển
- Thiết lập thiết bị Android TV:
- Kết nối thiết bị Android TV với mạng cục bộ.
- Đăng nhập vào Tài khoản Google của bạn.
- Trên phần Settings (Cài đặt), trong hàng Device (Thiết bị), hãy chọn About (Giới thiệu).
- Di chuyển xuống rồi nhấp vào Build (Tạo) vài lần cho đến khi một hộp thoại xuất hiện xuất hiện cùng thông báo "Bạn hiện là nhà phát triển".
- Nếu gỡ lỗi qua USB:
- Lắp đặt cáp USB nhưng không kết nối đầu chính của cáp USB đến máy tính của bạn.
- Trong hàng Lựa chọn ưu tiên, hãy chọn Tuỳ chọn cho nhà phát triển rồi chọn Gỡ lỗi qua USB rồi chọn Bật.
- Quay lại màn hình chính. Bạn phải thực hiện thao tác này để áp dụng các chế độ cài đặt mà bạn vừa chọn. Các tùy chọn cài đặt này sẽ vẫn tồn tại trừ khi bạn đặt lại về trạng thái ban đầu.
- Đăng ký thiết bị Android TV trên Google Cast SDK Developer Console, như như mô tả trong phần Đăng ký thiết bị.
Gỡ lỗi
Để kiểm tra và gỡ lỗi ứng dụng Trình nhận web trên thiết bị Android TV, hãy thực hiện sau:
- Đăng ký thiết bị Android TV và ứng dụng của bạn trên Bảng điều khiển dành cho nhà phát triển SDK Google Cast. Vui lòng xem phần Đăng ký để biết thêm thông tin về đăng ký thiết bị và ứng dụng.
- Khởi động ứng dụng dành cho người gửi rồi truyền tới thiết bị Android TV.
- Kết nối với thiết bị Android TV qua ADB, như mô tả trong Sử dụng Cầu gỡ lỗi Android.
- Trên máy phát triển của bạn, hãy mở cửa sổ trình duyệt Chrome và điều hướng đến chrome://inspect.
- Nhấp vào đường liên kết Inspect (kiểm tra) để chuyển Web receiver vào trình gỡ lỗi.
Trong bảng điều khiển Trình gỡ lỗi Chrome Remote, hãy bật tính năng ghi nhật ký gỡ lỗi bằng cách nhập sau:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Hãy xem phần Gỡ lỗi để biết thêm thông tin.
Nguyên tắc về khả năng tương thích với Android TV
Việc làm cho ứng dụng Truyền của bạn tương thích với Android TV yêu cầu rất ít công việc bổ sung. Dưới đây là một số đề xuất và sai lầm phổ biến nên tránh trong để đảm bảo ứng dụng của bạn tương thích với Android TV:
- Hãy lưu ý rằng chuỗi tác nhân người dùng chứa cả "Android" và "CrKey"; một số trang web có thể chuyển hướng tới một trang web chỉ dành cho thiết bị di động vì chúng phát hiện "Android" . Đừng giả định rằng "Android" luôn trong chuỗi tác nhân người dùng cho biết người dùng thiết bị di động.
- Ngăn xếp nội dung nghe nhìn của Android có thể sử dụng GZIP rõ ràng để tìm nạp dữ liệu. Đảm bảo
dữ liệu nội dung đa phương tiện của bạn có thể phản hồi
Accept-Encoding: gzip. - Sự kiện nội dung đa phương tiện HTML5 cho Android TV có thể được kích hoạt theo các thời gian khác với Chromecast, điều này có thể cho thấy các sự cố đã được ẩn trên Chromecast.
- Khi cập nhật nội dung nghe nhìn, hãy sử dụng các sự kiện liên quan đến nội dung nghe nhìn được
<audio>/<video>kích hoạt nhưtimeupdate,pausevàwaiting. Tránh sử dụng các sự kiện liên quan đến kết nối mạng nhưprogress,suspendvàstalled, vì những chỉ số này có xu hướng phụ thuộc vào nền tảng. - Khi định cấu hình chứng chỉ HTTPS của trang web Trình nhận web, hãy đảm bảo bao gồm chứng chỉ CA trung gian. Xem Trang kiểm tra SSL của Qualsys để xác minh: liệu đường dẫn chứng nhận đáng tin cậy cho trang web của bạn có bao gồm CA hay không chứng chỉ có nhãn "tải xuống bổ sung", thì chứng chỉ đó có thể không tải trên nền tảng Android nền tảng.
- Trong khi Chromecast hiển thị trang Web receiver trên mặt phẳng đồ hoạ 720p, các nền tảng Truyền khác, bao gồm cả Android TV, có thể hiển thị trang ở độ phân giải tối đa là 1080p. Đảm bảo trang Trình thu phát web của bạn có thể điều chỉnh tỷ lệ linh hoạt ở nhiều độ phân giải.
Sử dụng Cầu gỡ lỗi Android
Nền tảng Android TV nổi bật trên nhiều loại hàng điện tử tiêu dùng thiết bị: TV, hộp giải mã tín hiệu số, máy chơi trò chơi, v.v. Mỗi cấp độ có thể được định cấu hình theo cách khác nhau. Nếu bạn gặp khó khăn khi truy cập vào tài nguyên hệ thống của Android TV thông qua giao diện người dùng của thiết bị, bạn có thể hãy sử dụng Cầu gỡ lỗi Android (ADB) để lấy số sê-ri của thiết bị cho đăng ký của bạn cũng như để gỡ lỗi ứng dụng của bạn. Xem Android Cầu gỡ lỗi để tìm hiểu thêm của bạn.
Sử dụng ADB qua Wi-Fi
Cách kết nối với thiết bị qua ADB bằng kết nối Wi-Fi:
- Trên thiết bị Android TV, hãy bật các tuỳ chọn cho nhà phát triển như mô tả trong Thiết lập cho hoạt động phát triển.
- Đảm bảo máy tính và thiết bị Android của bạn kết nối với cùng một mạng Thiết bị TV.
Mở cửa sổ dòng lệnh rồi nhập thông tin sau:
adb connect Android TV device IP address:4321
Trên máy tính, hãy mở một thiết bị đầu cuối rồi nhập các lệnh ADB. Bạn có thể xác minh kết nối đã được thiết lập và thiết bị Android TV đang kết nối trên mạng bằng lệnh sau:
adb logcat
Sử dụng ADB với cáp USB
Cách kết nối với thiết bị qua ADB bằng kết nối cáp USB:
- Thiết lập thiết bị Android TV cho hoạt động phát triển, như mô tả trong Thiết lập cho hoạt động phát triển.
- Cắm đầu chính của cáp USB vào máy tính.
- Trong hộp thoại Allow USB debugging? (Cho phép gỡ lỗi qua USB?), hãy chọn Always (Luôn cho phép) từ máy tính này rồi chọn OK.
Trên máy tính, hãy mở một thiết bị đầu cuối rồi nhập các lệnh ADB. Bạn có thể xác minh kết nối đã được thiết lập và thiết bị Android TV đang kết nối trên mạng bằng lệnh sau:
adb logcat
Sử dụng ADB qua TCP/IP
ADB hoạt động mà không cần cáp USB qua TCP/IP, nhưng trước tiên bạn phải tải phiên bản Android Địa chỉ IP của thiết bị TV. Thiết bị do nhà phát triển xử lý để theo dõi kết nối cổng ADB tự động và có thể kết nối mà không cần khởi động cổng. Chiến lược chuẩn thiết bị Android TV bán lẻ không tự động lắng nghe kết nối ADB; với các thiết bị này, trước tiên bạn phải kết nối với ADB bằng cáp USB và khởi chạy cổng.
- Thiết lập thiết bị Android TV cho hoạt động phát triển, như mô tả trong Thiết lập cho hoạt động phát triển.
- Trên Android TV, trong hàng Device (Thiết bị), hãy chọn Network (Mạng) > Wi-Fi và chọn mạng được kết nối.
- Chọn Thông tin trạng thái và ghi lại địa chỉ IP.
Nếu thiết bị của bạn là thiết bị Android TV tiêu chuẩn và bán lẻ, hãy làm như sau:
- Làm theo các bước trong Sử dụng ADB với cáp USB.
- Đảm bảo máy tính của bạn được kết nối với cùng một mạng như thiết bị Android Thiết bị TV.
Trên máy tính, trong một thiết bị đầu cuối, hãy khởi động cổng cho TCP/IP bằng cách nhập thông tin sau:
adb tcpip 5555
Tháo cáp USB rồi nhập thông tin sau vào thiết bị đầu cuối:
adb connect Android TV device IP address:5555
Nếu thiết bị của bạn là Android TV do nhà phát triển gặp vấn đề, hãy làm như sau:
- Đảm bảo máy tính và thiết bị Android của bạn kết nối với cùng một mạng Thiết bị TV.
Mở cửa sổ dòng lệnh rồi nhập thông tin sau:
adb connect Android TV device IP address:4321
Trên Android TV, trong hộp thoại Allow USB debugging? (Cho phép gỡ lỗi qua USB?), hãy chọn Always (Luôn luôn) cho phép trên máy tính này rồi chọn OK. Bạn có thể xác minh kết nối được thiết lập và thiết bị Android TV đang giao tiếp qua mạng bằng lệnh sau:
adb logcat