book_path: /distribute/other-docs/_book.yaml project_path: /distribute/other-docs/_project.yaml
Hướng dẫn này trình bày cách bắt đầu tích hợp Engage SDK cho TV. Sau khi hoàn tất các bước chuẩn bị trên trang này, bạn có thể tích hợp một hoặc nhiều tính năng TV:
Chuẩn bị trước
Trước khi bắt đầu, hãy hoàn tất các bước sau:
Bày tỏ sự quan tâm đến việc phát triển Video Discovery API để đăng ký tham gia chương trình (nếu đủ điều kiện).
Xác minh rằng ứng dụng của bạn nhắm đến Android 4.4 (API cấp 19) trở lên cho hoạt động tích hợp này.
Thêm thư viện
com.google.android.engagevào ứng dụng của bạn:Có các SDK riêng biệt để sử dụng trong quá trình tích hợp: một cho ứng dụng di động và một cho ứng dụng truyền hình.
Thiết bị di động
dependencies { implementation 'com.google.android.engage:engage-core:1.5.11' }TV
dependencies { implementation 'com.google.android.engage:engage-tv:1.0.5' }Thêm quyền cho
WRITE_EPG_DATAđối với APK TV<uses-permission android:name="com.android.providers.tv.permission.WRITE_EPG_DATA" />Xác minh việc xuất bản nội dung đáng tin cậy bằng cách sử dụng một dịch vụ nền, chẳng hạn như
androidx.workđể lập lịch.Kiểm thử quá trình triển khai bằng ứng dụng xác minh như mô tả trong phần Kiểm thử.
Trong ứng dụng phát hành chính thức, hãy đặt môi trường dịch vụ Engage thành môi trường phát hành chính thức trong tệp
AndroidManifest.xml.<meta-data android:name="com.google.android.engage.service.ENV" android:value="PRODUCTION" />
Các bước tích hợp phổ biến
Khởi động ứng dụng
Sử dụng AppEngagePublishClient để tương tác với dịch vụ. Luôn kiểm tra xem dịch vụ có hoạt động hay không trước khi xuất bản.
val client = AppEngagePublishClient(context)
client.isServiceAvailable().addOnCompleteListener { task ->
if (task.isSuccessful && task.result) {
// Service is available, proceed with publishing
} else {
// Service is not available or call failed
}
}
Tạo hồ sơ tài khoản
AccountProfile xác định người dùng. Bạn có thể chỉ định mã tài khoản và tuỳ ý chỉ định mã hồ sơ và ngôn ngữ.
val accountProfile = AccountProfile.Builder()
.setAccountId("your_users_account_id")
.setProfileId("your_users_profile_id") // Optional
.setLocale(Locale.US.toLanguageTag()) // Optional, e.g., "en-US"
.build()
Thử nghiệm
Để kiểm thử quá trình tích hợp, hãy tải ứng dụng xác minh xuống:
Ứng dụng xác minh là một ứng dụng Android có các chức năng giúp bạn kiểm thử quy trình tích hợp. Ứng dụng này cho phép bạn kiểm tra độ chính xác của dữ liệu và chức năng phù hợp bằng cách xác minh dữ liệu đã xuất bản và ý định truyền tin trước khi ra mắt.
- Cài đặt và mở ứng dụng Engage Verification.
- Nếu giá trị của
isServiceAvailablelàfalsetrong ứng dụng xác minh, hãy nhấp vào nút Bật/tắt trong ứng dụng xác minh để đặt giá trị này thànhtrue. - Nhập tên gói của ứng dụng. Hệ thống sẽ tự động cho thấy dữ liệu đã xuất bản.
- Chạy ứng dụng và thực hiện các hành động xuất bản, chẳng hạn như đăng nhập hoặc xem video.
- Xác minh rằng dữ liệu xuất hiện trong ứng dụng xác minh.
Tải xuống
Trước khi tải xuống, bạn phải đồng ý với các điều khoản và điều kiện sau.