处理电视硬件

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

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

检查电视设备

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

确定您的应用是否在电视设备上运行的推荐方法是使用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_LOCATIONACCESS_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 键)进行导航。有关使用电视友好型控件正确支持导航的更多信息,请参阅电视导航

摄像头

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

<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()。有关启动和停止活动的更多信息,请参阅活动生命周期