Menangani hardware TV

Hardware TV jauh berbeda dengan perangkat Android lainnya. TV tidak menyertakan beberapa fitur hardware yang ada pada perangkat Android lain, seperti layar sentuh, kamera, dan penerima GPS. TV juga sepenuhnya bergantung pada perangkat hardware sekunder: agar pengguna dapat berinteraksi dengan aplikasi TV, mereka harus menggunakan remote control atau game pad. (Untuk mempelajari berbagai metode input, lihat Mengelola pengontrol TV.)

Saat membuat aplikasi untuk TV, pertimbangkan dengan cermat batasan hardware dan persyaratan pengoperasian hardware TV. Periksa apakah aplikasi Anda berjalan di TV dan tangani fitur hardware yang tidak didukung.

Memeriksa perangkat TV

Jika sedang membangun aplikasi yang beroperasi di perangkat TV dan perangkat lain, Anda mungkin perlu memeriksa jenis perangkat yang sesuai dengan aplikasi dan menyesuaikan operasinya untuk aplikasi Anda. Misalnya, jika memiliki aplikasi yang dapat dimulai melalui Intent, periksa properti perangkat untuk menentukan apakah akan memulai aktivitas berorientasi TV atau aktivitas ponsel.

Cara yang direkomendasikan untuk menentukan apakah aplikasi Anda berjalan di perangkat TV adalah dengan menggunakan metode PackageManager.hasSystemFeature() untuk memeriksa apakah perangkat berjalan dalam mode televisi. Kode contoh berikut menunjukkan cara memeriksa apakah aplikasi Anda berjalan di perangkat TV:

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

Menangani fitur hardware yang tidak didukung

Bergantung pada desain dan fungsionalitas aplikasi, Anda mungkin bisa menangani fitur hardware tertentu yang tidak tersedia. Bagian ini membahas tentang fitur hardware yang biasanya tidak tersedia untuk TV, cara mendeteksi fitur hardware yang tidak ditemukan, dan alternatif yang disarankan untuk fitur-fitur ini.

Fitur hardware TV yang tidak didukung

TV memiliki kegunaan yang berbeda dengan perangkat lainnya, sehingga fitur hardware yang umumnya dimiliki perangkat lain berbasis Android terkadang tidak tersedia di TV. Oleh karena itu, sistem Android tidak mendukung fitur berikut untuk perangkat TV:

Catatan: Beberapa pengontrol TV memiliki mikrofon, tetapi tidak sama dengan fitur hardware mikrofon yang dijelaskan di sini. Mikrofon pengontrol didukung sepenuhnya.

Lihat Referensi fitur untuk melihat daftar lengkap tentang fitur, subfitur, dan deskriptornya.

Mendeklarasikan persyaratan hardware untuk TV

Aplikasi Android dapat mendeklarasikan persyaratan fitur hardware dalam manifes aplikasi untuk membantu memastikan bahwa aplikasi tidak diinstal di perangkat yang tidak menyediakan fitur tersebut. Jika Anda mengembangkan aplikasi yang ada agar bisa digunakan di TV, tinjau manifes aplikasi dengan cermat untuk mengetahui deklarasi persyaratan hardware yang mungkin mencegahnya diinstal di perangkat TV.

Jika aplikasi Anda menggunakan fitur hardware seperti layar sentuh atau kamera yang tidak tersedia di TV, tetapi dapat beroperasi tanpa menggunakan fitur tersebut, ubah manifes aplikasi untuk menunjukkan bahwa fitur ini tidak diperlukan. Cuplikan kode manifes berikut ini menunjukkan cara mendeklarasikan bahwa aplikasi Anda tidak memerlukan fitur hardware yang tidak tersedia di perangkat TV, tetapi menggunakan fitur tersebut di perangkat non-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"/>

Catatan: Beberapa fitur memiliki subfitur, seperti android.hardware.camera.front, seperti yang dijelaskan dalam Referensi fitur. Pastikan untuk menandai subfitur yang juga digunakan dalam aplikasi Anda sebagai required="false".

Semua aplikasi yang ditujukan untuk digunakan di perangkat TV harus mendeklarasikan bahwa fitur layar sentuh tidak diperlukan, sebagaimana dijelaskan dalam Mulai menggunakan aplikasi TV. Jika aplikasi Anda biasanya menggunakan satu atau beberapa fitur yang tidak didukung oleh perangkat TV, ubah setelan atribut android:required menjadi false untuk fitur tersebut dalam manifes Anda.

Perhatian: Mendeklarasikan fitur hardware yang diperlukan dengan menetapkan nilainya ke true akan mencegah aplikasi Anda diinstal di perangkat TV atau muncul dalam peluncur layar utama Android TV.

Perhatikan izin yang menyiratkan fitur hardware

Sebagian deklarasi manifes uses-permission mengimplikasikan fitur hardware. Perilaku ini berarti bahwa meminta sebagian izin dalam manifes aplikasi bisa mengecualikan aplikasi sehingga tidak diinstal dan digunakan di perangkat TV. Izin yang sering diminta berikut ini membuat persyaratan fitur hardware yang implisit:

Untuk daftar lengkap permintaan izin yang mengimplikasikan persyaratan fitur hardware, lihat panduan uses-feature. Jika aplikasi Anda meminta salah satu fitur yang tercantum sebelumnya, sertakan deklarasi uses-feature dalam manifes Anda untuk fitur hardware yang diimplikasikan yang menunjukkan bahwa fitur itu tidak diperlukan. android:required="false".

Catatan: Jika aplikasi Anda menargetkan Android 5.0 (API level 21) atau yang lebih baru, dan menggunakan izin ACCESS_COARSE_LOCATION atau ACCESS_FINE_LOCATION, pengguna masih bisa menginstal aplikasi Anda di perangkat TV meskipun perangkat tersebut tidak memiliki kartu jaringan atau penerima GPS.

Setelah membuat fitur hardware bersifat opsional bagi aplikasi Anda, periksa ketersediaan fitur-fitur tersebut saat waktu proses dan sesuaikan perilaku aplikasi. Bagian berikutnya membahas cara memeriksa fitur hardware dan menyarankan beberapa pendekatan untuk mengubah perilaku aplikasi Anda.

Untuk mengetahui informasi selengkapnya tentang memfilter dan mendeklarasikan fitur dalam manifes, lihat panduan uses-feature.

Memeriksa fitur hardware

Framework Android dapat memberi tahu Anda jika fitur hardware tidak tersedia di perangkat tempat aplikasi Anda berjalan. Gunakan metode hasSystemFeature(String) untuk memeriksa fitur tertentu pada waktu proses. Metode ini mengambil argumen string tunggal yang menentukan fitur yang ingin Anda periksa.

Contoh kode berikut menunjukkan cara mendeteksi ketersediaan fitur hardware pada waktu proses:

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

Layar sentuh

Sebagian besar perangkat TV tidak memiliki kemampuan input layar sentuh atau pointer dan sepenuhnya mengandalkan remote control tombol arah (D-pad) untuk navigasi. Aplikasi TV harus selalu mendukung remote control D-pad.

Untuk informasi selengkapnya tentang mendukung navigasi dengan benar menggunakan kontrol yang sesuai untuk TV, lihat Navigasi TV.

Mendeklarasikan dukungan sentuh

Beberapa perangkat TV mendukung remote pointer dan layar sentuh. Aplikasi Anda dapat mendukung interaksi klik, arahkan kursor, dan scroll, seperti di perangkat seluler, untuk memberikan pengalaman yang lebih baik di perangkat yang mendukungnya.

Jika aplikasi Anda memungkinkan mode sentuh, Anda dapat mendeklarasikan dukungan sentuh dengan menambahkan android.software.leanback.supports_touch yang ditetapkan ke true di AndroidManifest.xml:

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

Catatan: Di perangkat yang mendukung remote penunjuk (seperti mouse udara atau trackpad), mengaktifkan setelan ini akan mengaktifkan mode sentuh dan kursor, bukan mengandalkan emulasi kompatibilitas platform. Jika metadata ini tidak ada, nilai defaultnya adalah false.

Kamera

Meskipun TV biasanya tidak memiliki kamera, Anda masih bisa menyediakan aplikasi terkait fotografi di TV. Misalnya, jika Anda memiliki aplikasi yang mengambil, melihat, dan mengedit foto, Anda dapat menonaktifkan fungsionalitas pengambilan gambarnya untuk TV dan tetap mengizinkan pengguna melihat dan bahkan mengedit foto. Jika memutuskan untuk mengaktifkan aplikasi terkait kamera agar berfungsi di TV, tambahkan deklarasi fitur berikut ini pada manifes aplikasi:

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

Jika Anda mengaktifkan aplikasi agar berfungsi tanpa kamera, tambahkan kode ke aplikasi yang akan mendeteksi apakah fitur kamera tersedia dan membuat penyesuaian pada pengoperasian aplikasi Anda. Contoh kode berikut memperagakan cara mendeteksi keberadaan kamera:

// 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 adalah perangkat dalam ruangan yang tidak portabel dan tidak memiliki penerima sistem pemosisi global (GPS) built-in. Jika aplikasi Anda menggunakan informasi lokasi, Anda masih dapat mengizinkan pengguna mencari lokasi atau menggunakan penyedia lokasi statis seperti kode pos yang dikonfigurasi selama penyiapan perangkat 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);
}

Menjeda pemutaran dalam mode daya rendah

Beberapa perangkat TV mendukung mode daya rendah ketika pengguna mematikan perangkat. Saat dimatikan, perangkat hanya akan menonaktifkan layar dan membiarkan Android TV berjalan di latar belakang. Output audio masih diaktifkan dalam mode ini, jadi hentikan semua konten yang sedang diputar saat perangkat dalam mode daya rendah.

Untuk menghindari pemutaran dalam mode daya rendah, batalkan onStop() dan hentikan semua konten yang sedang diputar:

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();
}

Saat pengguna mengaktifkan kembali perangkat, onStart() akan dipanggil jika aplikasi Anda adalah aplikasi latar depan yang aktif. Untuk mengetahui informasi selengkapnya tentang memulai dan menghentikan aktivitas, lihat Siklus proses aktivitas.