Xử lý phần cứng TV

Phần cứng TV khác biệt đáng kể so với các thiết bị Android khác. TV không có một số tính năng phần cứng có trên các thiết bị Android khác, chẳng hạn như màn hình cảm ứng, camera và bộ thu GPS. TV cũng hoàn toàn phụ thuộc vào các thiết bị phần cứng phụ: để tương tác với các ứng dụng TV, người dùng phải sử dụng điều khiển từ xa hoặc tay cầm chơi game. (Để tìm hiểu về nhiều phương thức nhập, hãy xem bài viết Quản lý bộ điều khiển TV.)

Khi tạo ứng dụng cho TV, hãy cân nhắc kỹ các yêu cầu và giới hạn về phần cứng khi hoạt động trên phần cứng TV. Kiểm tra xem ứng dụng của bạn có đang chạy trên TV hay không và xử lý các tính năng phần cứng không được hỗ trợ.

Kiểm tra thiết bị TV

Nếu đang tạo một ứng dụng hoạt động trên cả thiết bị TV và các thiết bị khác, bạn có thể cần kiểm tra loại thiết bị mà ứng dụng đang chạy và điều chỉnh hoạt động của ứng dụng. Ví dụ: nếu có một ứng dụng có thể khởi động thông qua Intent, hãy kiểm tra các thuộc tính của thiết bị để xác định xem có nên khởi động một hoạt động hướng đến TV hay một hoạt động trên điện thoại.

Cách nên dùng để xác định xem ứng dụng của bạn có đang chạy trên thiết bị TV hay không là sử dụng phương thức PackageManager.hasSystemFeature() để kiểm tra xem thiết bị có đang chạy ở chế độ truyền hình hay không. Đoạn mã ví dụ sau đây cho biết cách kiểm tra xem ứng dụng của bạn có đang chạy trên thiết bị TV hay không:

const val TAG = "DeviceTypeRuntimeCheck"

val isTelevision = packageManager.hasSystemFeature(PackageManager.FEATURE_LEANBACK)
if (isTelevision) {
    Log.d(TAG, "Running on a TV Device")
} else {
    Log.d(TAG, "Running on a non-TV Device")
}

public static final String TAG = "DeviceTypeRuntimeCheck";

boolean isTelevision = getPackageManager().hasSystemFeature(PackageManager.FEATURE_LEANBACK);
if (isTelevision) {
    Log.d(TAG, "Running on a TV Device");
} else {
    Log.d(TAG, "Running on a non-TV Device");
}

Xử lý các tính năng phần cứng không được hỗ trợ

Tuỳ thuộc vào thiết kế và chức năng của ứng dụng, bạn có thể khắc phục tình trạng một số tính năng phần cứng không dùng được. Phần này thảo luận về những tính năng phần cứng thường không có trên TV, cách phát hiện các tính năng phần cứng bị thiếu và những lựa chọn thay thế được đề xuất cho các tính năng này.

Các tính năng phần cứng TV không được hỗ trợ

TV có mục đích khác với các thiết bị khác, vì vậy, TV không có các tính năng phần cứng mà các thiết bị chạy Android khác thường có. Vì lý do này, hệ thống Android không hỗ trợ các tính năng sau cho thiết bị TV:

Lưu ý: Một số bộ điều khiển TV có micrô. Đây không phải là tính năng phần cứng micrô được mô tả ở đây. Micrô của bộ điều khiển được hỗ trợ đầy đủ.

Hãy xem Thông tin tham khảo về tính năng để biết danh sách đầy đủ các tính năng, tính năng phụ và nội dung mô tả của chúng.

Khai báo các yêu cầu về phần cứng đối với TV

Các ứng dụng Android có thể khai báo các yêu cầu về tính năng phần cứng trong tệp kê khai ứng dụng để đảm bảo rằng ứng dụng không được cài đặt trên những thiết bị không cung cấp các tính năng đó. Nếu bạn đang mở rộng một ứng dụng hiện có để sử dụng trên TV, hãy xem xét kỹ tệp kê khai của ứng dụng để biết mọi khai báo yêu cầu về phần cứng có thể ngăn ứng dụng được cài đặt trên thiết bị TV.

Nếu ứng dụng của bạn dùng các tính năng phần cứng như màn hình cảm ứng hoặc camera không có trên TV, nhưng ứng dụng có thể hoạt động mà không cần dùng các tính năng đó, hãy sửa đổi tệp kê khai của ứng dụng để cho biết rằng các tính năng này không bắt buộc. Đoạn mã sau đây trong tệp kê khai minh hoạ cách khai báo rằng ứng dụng của bạn không yêu cầu các tính năng phần cứng không có trên thiết bị TV nhưng sử dụng các tính năng đó trên thiết bị không phải TV:

<uses-feature android:name="android.hardware.touchscreen"
        android:required="false"/>
<uses-feature android:name="android.hardware.faketouch"
        android:required="false"/>
<uses-feature android:name="android.hardware.telephony"
        android:required="false"/>
<uses-feature android:name="android.hardware.camera"
        android:required="false"/>
<uses-feature android:name="android.hardware.nfc"
        android:required="false"/>
<uses-feature android:name="android.hardware.location.gps"
        android:required="false"/>
<uses-feature android:name="android.hardware.microphone"
        android:required="false"/>
<uses-feature android:name="android.hardware.sensor"
        android:required="false"/>
<!-- Some TV devices have an ethernet connection only -->
<uses-feature android:name="android.hardware.wifi"
        android:required="false"/>

Lưu ý: Một số tính năng có các tính năng phụ, chẳng hạn như android.hardware.camera.front, như mô tả trong phần Tài liệu tham khảo về tính năng. Hãy nhớ đánh dấu mọi tính năng phụ cũng được dùng trong ứng dụng của bạn là required="false".

Tất cả ứng dụng dự kiến dùng trên thiết bị TV đều phải khai báo rằng tính năng màn hình cảm ứng không bắt buộc, như mô tả trong phần Bắt đầu với ứng dụng TV. Nếu ứng dụng của bạn thường dùng một hoặc nhiều tính năng không được thiết bị TV hỗ trợ, hãy thay đổi chế độ cài đặt thuộc tính android:required thành false cho những tính năng đó trong tệp kê khai.

Thận trọng: Việc khai báo một tính năng phần cứng là bắt buộc bằng cách đặt giá trị của tính năng đó thành true sẽ ngăn ứng dụng của bạn được cài đặt trên các thiết bị TV hoặc xuất hiện trong trình chạy màn hình chính của Android TV.

Lưu ý về những quyền ngụ ý tính năng phần cứng

Một số khai báo tệp kê khai uses-permission ngụ ý các tính năng phần cứng. Hành vi này có nghĩa là việc yêu cầu một số quyền trong tệp kê khai ứng dụng có thể loại trừ ứng dụng của bạn khỏi việc cài đặt và sử dụng trên các thiết bị TV. Các quyền thường được yêu cầu sau đây tạo ra một yêu cầu ngầm ẩn về tính năng phần cứng:

Để xem danh sách đầy đủ các yêu cầu cấp quyền ngụ ý yêu cầu về tính năng phần cứng, hãy xem hướng dẫn uses-feature. Nếu ứng dụng của bạn yêu cầu một trong các tính năng được liệt kê trước đó, hãy thêm một khai báo uses-feature vào tệp kê khai cho tính năng phần cứng ngầm định để cho biết rằng tính năng đó không bắt buộc. android:required="false".

Lưu ý: Nếu ứng dụng của bạn nhắm đến Android 5.0 (cấp độ API 21) trở lên và sử dụng quyền ACCESS_COARSE_LOCATION hoặc ACCESS_FINE_LOCATION, thì người dùng vẫn có thể cài đặt ứng dụng của bạn trên thiết bị TV, ngay cả khi thiết bị TV đó không có thẻ mạng hoặc bộ nhận tín hiệu GPS.

Sau khi đặt các tính năng phần cứng là không bắt buộc đối với ứng dụng, bạn phải kiểm tra xem những tính năng đó có hoạt động được trong thời gian chạy hay không, rồi điều chỉnh hành vi của ứng dụng. Phần tiếp theo thảo luận về cách kiểm tra các tính năng phần cứng và đề xuất một số phương pháp để thay đổi hành vi của ứng dụng.

Để biết thêm thông tin về việc lọc và khai báo các tính năng trong tệp kê khai, hãy xem hướng dẫn uses-feature.

Kiểm tra các tính năng phần cứng

Khung Android có thể cho bạn biết liệu các tính năng phần cứng có dùng được trên thiết bị mà ứng dụng của bạn đang chạy hay không. Dùng phương thức hasSystemFeature(String) để kiểm tra các tính năng cụ thể trong thời gian chạy. Phương thức này lấy một đối số chuỗi duy nhất chỉ định tính năng mà bạn muốn kiểm tra.

Ví dụ về mã sau đây minh hoạ cách phát hiện tính khả dụng của các tính năng phần cứng trong thời gian chạy:

// Check whether the telephony hardware feature is available.
if (packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY)) {
    Log.d("HardwareFeatureTest", "Device can make phone calls")
}

// Check whether android.hardware.touchscreen feature is available.
if (packageManager.hasSystemFeature(PackageManager.FEATURE_TOUCHSCREEN)) {
    Log.d("HardwareFeatureTest", "Device has a touchscreen.")
}

// Check whether the telephony hardware feature is available.
if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_TELEPHONY)) {
    Log.d("HardwareFeatureTest", "Device can make phone calls");
}

// Check whether android.hardware.touchscreen feature is available.
if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_TOUCHSCREEN)) {
    Log.d("HardwareFeatureTest", "Device has a touchscreen.");
}

Màn hình cảm ứng

Hầu hết các thiết bị TV đều không có màn hình cảm ứng hoặc khả năng nhập bằng con trỏ và hoàn toàn dựa vào điều khiển từ xa có bàn phím định hướng (D-pad) để điều hướng. Các ứng dụng truyền hình phải luôn hỗ trợ điều khiển từ xa bằng d-pad.

Để biết thêm thông tin về cách hỗ trợ điều hướng đúng cách bằng các chế độ kiểm soát thân thiện với TV, hãy xem phần Điều hướng trên TV.

Khai báo khả năng hỗ trợ cảm ứng

Một số thiết bị TV hỗ trợ điều khiển từ xa có con trỏ và màn hình cảm ứng. Ứng dụng của bạn có thể hỗ trợ các hoạt động tương tác nhấp, di chuột và cuộn, chẳng hạn như trên thiết bị di động, để mang lại trải nghiệm tốt hơn trên các thiết bị hỗ trợ những hoạt động này.

Nếu ứng dụng của bạn cho phép chế độ cảm ứng, bạn có thể khai báo chế độ hỗ trợ cảm ứng bằng cách thêm android.software.leanback.supports_touch được đặt thành true trong AndroidManifest.xml:

<meta-data android:name="android.software.leanback.supports_touch" android:value="true|false"/>

Lưu ý: Trên các thiết bị hỗ trợ điều khiển từ xa trỏ (chẳng hạn như chuột trên không hoặc bàn di chuột), việc bật chế độ này sẽ bật chế độ con trỏ và chế độ cảm ứng thay vì dựa vào tính năng mô phỏng khả năng tương thích của nền tảng. Nếu bạn bỏ qua siêu dữ liệu này, giá trị mặc định sẽ là false.

Máy ảnh

Mặc dù TV thường không có camera, nhưng bạn vẫn có thể cung cấp một ứng dụng liên quan đến nhiếp ảnh trên TV. Ví dụ: nếu có một ứng dụng chụp, xem và chỉnh sửa ảnh, bạn có thể tắt chức năng chụp ảnh của ứng dụng này cho TV và vẫn cho phép người dùng xem và thậm chí chỉnh sửa ảnh. Nếu quyết định cho phép ứng dụng liên quan đến máy ảnh hoạt động trên TV, hãy thêm nội dung khai báo tính năng sau vào tệp kê khai ứng dụng:

<uses-feature android:name="android.hardware.camera" android:required="false" />

Nếu cho phép ứng dụng chạy mà không cần camera, hãy thêm mã vào ứng dụng để phát hiện xem tính năng camera có dùng được hay không và điều chỉnh hoạt động của ứng dụng. Ví dụ về mã sau đây minh hoạ cách phát hiện sự hiện diện của camera:

// Check whether the camera hardware feature is available.
if (packageManager.hasSystemFeature(PackageManager.FEATURE_CAMERA)) {
    Log.d("Camera test", "Camera available!")
} else {
    Log.d("Camera test", "No camera available. View and edit features only.")
}

// Check whether the camera hardware feature is available.
if (getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA)) {
    Log.d("Camera test", "Camera available!");
} else {
    Log.d("Camera test", "No camera available. View and edit features only.");
}

GPS

TV là thiết bị cố định, đặt trong nhà và không có bộ thu hệ thống định vị toàn cầu (GPS) tích hợp. Nếu ứng dụng của bạn sử dụng thông tin vị trí, bạn vẫn có thể cho phép người dùng tìm kiếm một vị trí hoặc sử dụng một trình cung cấp vị trí tĩnh, chẳng hạn như mã bưu chính được định cấu hình trong quá trình thiết lập thiết bị TV.

// Request a static location from the location manager.
val locationManager = this.getSystemService(Context.LOCATION_SERVICE) as LocationManager
val location: Location = locationManager.getLastKnownLocation("static")

// Attempt to get postal code from the static location object.
val geocoder = Geocoder(this)
val address: Address? =
        try {
            geocoder.getFromLocation(location.latitude, location.longitude, 1)[0]
                    .apply {
                        Log.d(TAG, postalCode)
                    }
        } catch (e: IOException) {
            Log.e(TAG, "Geocoder error", e)
            null
        }

// Request a static location from the location manager.
LocationManager locationManager = (LocationManager) this.getSystemService(
        Context.LOCATION_SERVICE);
Location location = locationManager.getLastKnownLocation("static");

// Attempt to get postal code from the static location object.
Geocoder geocoder = new Geocoder(this);
Address address = null;
try {
  address = geocoder.getFromLocation(location.getLatitude(),
          location.getLongitude(), 1).get(0);
  Log.d("Postal code", address.getPostalCode());

} catch (IOException e) {
  Log.e(TAG, "Geocoder error", e);
}

Tạm dừng phát trong chế độ tiết kiệm pin

Một số thiết bị TV hỗ trợ chế độ tiêu thụ ít điện năng khi người dùng tắt thiết bị. Thay vì tắt nguồn, thiết bị sẽ tắt màn hình và tiếp tục chạy Android TV ở chế độ nền. Đầu ra âm thanh vẫn được bật ở chế độ này, vì vậy hãy dừng mọi nội dung đang phát khi thiết bị ở chế độ nguồn điện thấp.

Để tránh phát trong chế độ nguồn điện thấp, hãy ghi đè onStop() và dừng mọi nội dung đang phát:

override fun onStop() {
    // App-specific method to stop playback.
    stopPlayback()
    super.onStop()
}

@Override
public void onStop() {
  // App-specific method to stop playback.
  stopPlayback();
  super.onStop();
}

Khi người dùng bật lại nguồn điện, onStart() sẽ được gọi nếu ứng dụng của bạn là ứng dụng đang hoạt động trên nền trước. Để biết thêm thông tin về cách bắt đầu và dừng một hoạt động, hãy xem phần Vòng đời của activity.