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, máy ảnh 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ụ: để người dùng tương tác với các ứng dụng TV, họ phải sử dụng điều khiển từ xa hoặc tay điều khiển trò chơi. (Để tìm hiểu về nhiều phương thức nhập, hãy xem phần Quản lý bộ điều khiển TV.)

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

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 trên đó và điều chỉnh hoạt động của ứng dụng. Ví dụ: nếu bạn 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 sẽ bắt đầu hoạt động trên TV hay hoạt động trên điện thoại.

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

Kotlin

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")
}

Java

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ể giải quyết một số tính năng phần cứng hiện không hoạt động. 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ế nên dùng cho những 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, chúng 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:

Phần cứng	Bộ mô tả tính năng Android
Màn hình cảm ứng	android.hardware.touchscreen
Trình mô phỏng màn hình cảm ứng	android.hardware.faketouch
Điện thoại	android.hardware.telephony
Camera	android.hardware.camera
Giao tiếp phạm vi gần (NFC)	android.hardware.nfc
GPS	android.hardware.location.gps
Micrô	android.hardware.microphone
Cảm biến	android.hardware.sensor
Màn hình theo hướng dọc	android.hardware.screen.portrait

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

Hãy xem Tài liệu 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 cho 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 để giúp đảm bảo rằng ứng dụng không được cài đặt trên 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ó để dùng trên TV, hãy xem kỹ tệp kê khai của ứng dụng để xem có nội dung khai báo nào liên quan đến yêu cầu về phần cứng có thể khiến ứng dụng không được cài đặt trên thiết bị TV hay không.

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 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 là không bắt buộc. Đoạn mã tệp kê khai sau đây 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, theo mô tả trong 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 dùng trong ứng dụng là required="false".

Mọi ứng dụng dùng để dùng trên thiết bị TV phải khai báo rằng không bắt buộc phải có tính năng màn hình cảm ứng, như mô tả trong bài viết Làm quen với ứng dụng dành cho 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 các 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 theo yêu cầu bằng cách đặt giá trị của tính năng đó thành true sẽ ngăn việc cài đặt ứng dụng trên các thiết bị TV hoặc ngăn ứng dụng xuất hiện trong trình chạy màn hình chính của Android TV.

Nhận biết được các quyền ngụ ý tính năng phần cứng

Một số nội dung khai báo tệp kê khai uses-permission chỉ là 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ể ngăn ứng dụng đượ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:

Quyền	Tính năng phần cứng ngụ ý
RECORD_AUDIO	android.hardware.microphone
CAMERA	android.hardware.camera và android.hardware.camera.autofocus
ACCESS_COARSE_LOCATION	android.hardware.location android.hardware.location.network (chỉ API mục tiêu cấp 20 trở xuống)
ACCESS_FINE_LOCATION	android.hardware.location android.hardware.location.gps (chỉ API mục tiêu cấp 20 trở xuống)
ACCESS_WIFI_STATE CHANGE_WIFI_STATE	android.hardware.wifi Một số thiết bị TV chỉ có kết nối Ethernet.

Để xem danh sách đầy đủ các yêu cầu cấp quyền ngụ ý một yêu cầu về tính năng phần cứng, hãy xem hướng dẫn dành cho uses-feature. Nếu ứng dụng của bạn yêu cầu một trong các tính năng đã liệt kê trước đó, hãy thêm nội dung khai báo uses-feature vào tệp kê khai cho tính năng phần cứng ngầm ẩn cho biết đó là 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 (API cấp 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ộ thu GPS.

Sau khi tuỳ chọn các tính năng phần cứng cho ứng dụng, bạn phải kiểm tra phạm vi cung cấp của các tính năng đó trong thời gian chạy rồi điều chỉnh hành vi của ứng dụng. Phần tiếp theo sẽ 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ề các tính năng lọc và khai báo trong tệp kê khai, hãy xem hướng dẫn dành cho uses-feature.

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

Khung Android có thể cho bạn biết nếu các tính năng phần cứng không hoạt động trên thiết bị mà ứng dụng của bạn đang chạy. Sử 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 sẽ lấy một đối số chuỗi đơn 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 trạng sẵn có của các tính năng phần cứng trong thời gian chạy:

Kotlin

// 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.")
}

Java

// 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

Vì hầu hết TV không có màn hình cảm ứng nên Android không hỗ trợ tương tác màn hình cảm ứng trên thiết bị TV. Hơn nữa, việc sử dụng màn hình cảm ứng là không phù hợp với môi trường xem mà người dùng ngồi cách màn hình 3 mét (10 feet). Hãy đảm bảo rằng văn bản và các thành phần trên giao diện người dùng không yêu cầu hoặc ngụ ý việc sử dụng màn hình cảm ứng.

Đối với các thiết bị TV, hãy thiết kế ứng dụng của bạn để hỗ trợ thao tác bằng bàn phím di chuyển (D-pad) trên điều khiển từ xa của TV. Để biết thêm thông tin về cách hỗ trợ đúng cách tính năng chỉ đường bằng các chế độ điều khiển phù hợp với TV, hãy xem phần Điều hướng trên TV.

Camera

Mặc dù TV thường không có máy ảnh, nhưng bạn vẫn có thể cung cấp ứ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 đó cho TV, mà vẫn cho phép người dùng xem và thậm chí chỉnh sửa ảnh. Nếu bạn 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 đây cho tệp kê khai ứng dụng:

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

Nếu bạn cho phép ứng dụng chạy mà không cần máy ảnh, hãy thêm mã vào ứng dụng để phát hiện xem tính năng máy ảnh có hoạt động 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 máy ảnh:

Kotlin

// 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.")
}

Java

// 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, ở trong nhà và không có bộ thu hệ thống định vị toàn cầu (GPS) tích hợp sẵn. Nếu ứng dụng của bạn 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 nhà cung cấp vị trí tĩnh, chẳng hạn như mã bưu chính được thiết lập trong quá trình thiết lập thiết bị TV.

Kotlin

// 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
        }

Java

// 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 lại khi ở chế độ tiết kiệm pin

Một số thiết bị TV hỗ trợ chế độ tiết kiệm pin khi người dùng tắt thiết bị. Thay vì tắt, 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ế độ tiết kiệm pin.

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

Kotlin

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

Java

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

Khi người dùng bật lại nguồ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 bài viết Vòng đời hoạt động.