处理电视硬件

电视硬件与其他 Android 设备有很大不同。电视不包括其他 Android 设备上的一些硬件功能，例如触摸屏、摄像头和 GPS 接收器。电视也完全依赖辅助硬件设备：用户要与电视应用互动，必须使用遥控器或游戏手柄。（要了解各种输入方法，请参阅管理电视控制器。）

为电视构建应用时，请仔细考虑在电视硬件上运行的硬件限制和要求。检查您的应用是否正在电视上运行，并处理不支持的硬件功能。

检查电视设备

如果您正在构建一个既能在电视设备上运行又能在其他设备上运行的应用，您可能需要检查您的应用正在哪种设备上运行，并调整其操作。例如，如果您有一个可以通过 Intent 启动的应用，请检查设备属性以确定是启动面向电视的 Activity 还是面向手机的 Activity。

确定您的应用是否正在电视设备上运行的推荐方法是使用 PackageManager.hasSystemFeature() 方法来检查设备是否处于电视模式。以下示例代码演示了如何检查您的应用是否正在电视设备上运行

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

处理不支持的硬件功能

根据您的应用设计和功能，您或许可以解决某些硬件功能不可用的问题。本节讨论电视通常不支持哪些硬件功能、如何检测缺失的硬件功能以及针对这些功能建议的替代方案。

不支持的电视硬件功能

电视的用途与其他设备不同，因此它们不具备其他 Android 设备通常拥有的硬件功能。因此，Android 系统不支持电视设备的以下功能

硬件	Android 功能描述符
触摸屏	`android.hardware.touchscreen`
触摸屏模拟器	`android.hardware.faketouch`
电话功能	`android.hardware.telephony`
摄像头	`android.hardware.camera`
近场通信 (NFC)	`android.hardware.nfc`
GPS	`android.hardware.location.gps`
麦克风	`android.hardware.microphone`
传感器	`android.hardware.sensor`
竖屏显示	`android.hardware.screen.portrait`

注意：有些电视控制器带有麦克风，但这与此处描述的麦克风硬件功能不同。控制器麦克风是完全支持的。

如需查看功能、子功能及其描述符的完整列表，请参阅功能参考。

声明电视硬件要求

Android 应用可以在应用清单中声明硬件功能要求，以帮助确保它们不会安装在不提供这些功能的设备上。如果您要扩展现有应用以在电视上使用，请仔细检查应用的清单，看是否有任何硬件要求声明可能会阻止其安装在电视设备上。

如果您的应用使用触摸屏或摄像头等电视上不可用的硬件功能，但即使没有这些功能也能运行，请修改应用的清单以指明不需要这些功能。以下清单代码段演示了如何声明您的应用不需要电视设备上不可用的硬件功能，但在非电视设备上使用这些功能

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

注意：某些功能具有子功能，例如 android.hardware.camera.front，如功能参考中所述。请务必将您的应用中使用的所有子功能也标记为 required="false"。

所有旨在用于电视设备的应用都必须声明不需要触摸屏功能，如电视应用入门中所述。如果您的应用通常使用电视设备不支持的一个或多个功能，请在清单中将这些功能的 android:required 属性设置更改为 false。

注意：将硬件功能的值设置为 true 来声明为必需，将阻止您的应用安装在电视设备上或在 Android TV 主屏幕启动器中显示。

注意暗示硬件功能的权限

某些 uses-permission 清单声明暗示了硬件功能。这意味着在您的应用清单中请求某些权限可能会阻止您的应用安装和用于电视设备。以下常用的请求权限会创建隐式硬件功能要求

权限	暗示的硬件功能
`RECORD_AUDIO`	`android.hardware.microphone`
`CAMERA`	`android.hardware.camera` 和 `android.hardware.camera.autofocus`
`ACCESS_COARSE_LOCATION`	`android.hardware.location` `android.hardware.location.network`（仅限目标 API 级别 20 或更低）
`ACCESS_FINE_LOCATION`	`android.hardware.location` `android.hardware.location.gps`（仅限目标 API 级别 20 或更低）
`ACCESS_WIFI_STATE` `CHANGE_WIFI_STATE`	`android.hardware.wifi` 有些电视设备只有以太网连接。

有关暗示硬件功能要求的权限请求的完整列表，请参阅 uses-feature 指南。如果您的应用请求了前面列出的其中一项功能，请在清单中为暗示的硬件功能添加 uses-feature 声明，以指明它不是必需的。android:required="false"。

注意：如果您的应用目标为 Android 5.0（API 级别 21）或更高版本，并且使用 ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION 权限，用户仍然可以在电视设备上安装您的应用，即使电视设备没有网卡或 GPS 接收器。

将硬件功能设为可选后，您必须在运行时检查这些功能的可用性，然后调整应用的行为。下一节将讨论如何检查硬件功能，并提出一些更改应用行为的方法。

有关在清单中过滤和声明功能的更多信息，请参阅 uses-feature 指南。

检查硬件功能

Android 框架可以告诉您应用正在运行的设备上是否存在硬件功能。使用 hasSystemFeature(String) 方法在运行时检查特定功能。此方法接受一个字符串参数，该参数指定要检查的功能。

以下代码示例演示了如何在运行时检测硬件功能的可用性

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

触摸屏

由于大多数电视没有触摸屏，Android 不支持电视设备的触摸屏交互。此外，使用触摸屏与用户坐在离显示器 10 英尺远的观看环境不符。确保您的 UI 元素和文本不要求或暗示使用触摸屏。

对于电视设备，请设计您的应用以支持使用电视遥控器上的方向键 (D-pad) 进行导航。有关正确支持使用电视友好控件进行导航的更多信息，请参阅电视导航。

摄像头

尽管电视通常没有摄像头，但您仍然可以在电视上提供与摄影相关的应用。例如，如果您有一个可以拍摄、查看和编辑照片的应用，您可以为电视禁用其拍照功能，但仍然允许用户查看甚至编辑照片。如果您决定让您的相机相关应用在电视上运行，请在您的应用清单中添加以下功能声明

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

如果您允许您的应用在没有摄像头的情况下运行，请在您的应用中添加代码，以检测摄像头功能是否可用并调整应用的操作。以下代码示例演示了如何检测摄像头的存在

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

电视是固定不动的室内设备，不具备内置的全球定位系统 (GPS) 接收器。如果您的应用使用位置信息，您仍然可以让用户搜索位置，或者使用静态位置提供程序，例如在电视设备设置期间配置的邮政编码。

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

在低功耗模式下暂停播放

当用户关闭设备时，某些电视设备支持低功耗模式。此时，设备不会关机，而是禁用显示器并让 Android TV 在后台运行。在此模式下仍会启用音频输出，因此当设备处于低功耗模式时，请停止当前正在播放的任何内容。

为避免在低功耗模式下播放，请覆盖 onStop() 并停止当前正在播放的任何内容

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

当用户重新打开电源时，如果您的应用是活动的在前台应用，则会调用 onStart()。有关启动和停止 Activity 的更多信息，请参阅Activity 生命周期。

创建和运行电视应用

管理电视控制器

处理电视硬件 使用收藏集进行整理 根据您的偏好保存内容并分类。

检查电视设备

Kotlin

Java

处理不支持的硬件功能

不支持的电视硬件功能

声明电视硬件要求

注意暗示硬件功能的权限

检查硬件功能

Kotlin

Java

触摸屏

摄像头

Kotlin

Java

GPS

Kotlin

Java

在低功耗模式下暂停播放

Kotlin

Java

处理电视硬件