识别Fire TV(不在中国发售)设备
大多数亚马逊Fire TV开发者同时为Google Play和亚马逊应用商店构建应用,对这两个应用市场和设备使用基于Android的相同代码。由于亚马逊设备不使用Google服务(使用亚马逊服务和API),因此可能需要以不同的方式确定目标代码。此外,Fire OS也有多个版本:
- Fire OS 5: 基于Android 5.1(Lollipop,API级别22)
- Fire OS 6: 基于Android 7.1(Nougat,API级别25)
- Fire OS 7: 基于Android 9(Pie,API级别28)
- Fire OS 8: 基于Android 10(API级别29)和Android 11(API级别30)。
本文档提供有关根据功能、型号和API级别识别Amazon设备的详细信息。在Fire TV设备规格中,可找到有关Fire TV设备相应的Fire OS版本的详细信息。
检查亚马逊Fire TV设备的原因
由于各种原因,可能需要在代码中检查亚马逊Fire TV设备:
- 具有仅在Fire OS 8设备上受支持的Android 10(API级别29)或Android 11(API 级别 30)功能。
- 具有仅在Fire OS 7设备上受支持的与Pie相关的(API级别27及更高级别)功能。
- 具有仅在Fire OS 6设备上支持的与Nougat相关的(API级别25及更高级别)功能。
- 若需确定应用是否需要在其
onPause()
方法中拆除DRM和HW解码管道(由于对多个DRM上下文的处理能力有限,Fire TV第1代需要该做法)。
按功能和型号识别亚马逊设备
可通过查找amazon.hardware.fire_tv
功能,识别亚马逊Fire TV设备。也可使用android.os.Build.MODEL
中的模式。有关每个设备构建型号的信息,请参阅Fire TV设备规格。下图显示了每个设备的构建型号。(将APK上传到开发者控制台时,可看到该对话框。)
所有Fire TV设备均可通过功能amazon.hardware.fire_tv
进行识别。可通过对Context
对象调用getPackageManager()
方法和检查hasSystemFeature()
是否返回com.hardware.amazon.fire_tv
,获得该功能。下列代码显示一个示例:
final String AMAZON_FEATURE_FIRE_TV = "amazon.hardware.fire_tv";
if (getPackageManager().hasSystemFeature(AMAZON_FEATURE_FIRE_TV)) {
Log.v(TAG, "是,这是Fire TV设备。");
} else {
Log.v(TAG, "否,这不是Fire TV设备。");
}
还可通过将android.os.Build.MODEL
与Build.MANUFACTURER
(返回Amazon
)相结合,识别Fire TV设备。
但随着非亚马逊制造商将越来越多由亚马逊提供技术支持的设备推出市场,将android.os.Build.MODEL
与Build.MANUFACTURER
相结合可能并不总是起作用。因此,应为基于com.hardware.amazon.fire_tv
功能的未来亚马逊Fire TV设备提供合理的回退方法。以下是一个代码示例,查找型号,但回退到该功能:
final String AMAZON_FEATURE_FIRE_TV = "amazon.hardware.fire_tv";
String AMAZON_MODEL = Build.MODEL;
if (AMAZON_MODEL.matches("AFTN")) {
Log.v(TAG, "是,这是Fire TV第3代设备");
} else if (getPackageManager().hasSystemFeature(AMAZON_FEATURE_FIRE_TV)) {
Log.v(TAG, "是,这是Fire TV设备。");
} else {
Log.v(TAG, "否,这不是Fire TV设备");
}
检查API级别
如需实现基于Android API级别的条件行为,可使用SDK_INT检查设备的API级别。例如,以下代码检查版本是否大于等于API级别25:
if (Build.VERSION.SDK_INT >= 25) {
Log.v(TAG, "是,这台设备具备API级别25或更高版本");
} else {
Log.v(TAG, "不是,这台设备不具备API级别25或更高版本");
}
在本例中,代码将针对Fire OS 6或更高版本(API级别25或更高级别),并排除任何Fire OS 5设备(API级别22)。若只想针对于Fire OS 5设备,可使用类似的逻辑:
if (Build.VERSION.SDK_INT <= 22) {
Log.v(TAG, "是,这台设备具备API级别22或更低版本");
} else {
Log.v(TAG, "否,这台设备具备API级别22或更低版本");
}
检查是否支持4K
如需检查是否支持4K,请使用Android 6.0中引入的标准Android Display.Mode API。通过Display.mode
,应用可查询物理显示屏尺寸并切换到不同的HDMI显示模式。
对于Fire OS 5设备(基于Android 5.1,在Display.Mode
发布之前推出),Display.Mode
也可用(由于这些API向后移植到Fire OS),但必须使用反射。亚马逊提供一个4K扩展库,通过反射机制封装Android API,并提供简单的接口。有关更多详细信息,请参阅《用于HDMI模式切换的API)。
使用adb命令检查属性或功能
若需使用adb查看设备所具有的属性或功能,可执行以下操作:
- 连接到ADB。
- 如需查看设备的属性,请运行
adb shell getprop
。 - 如需查看设备的功能,请运行
adb shell pm list features
。
Last updated: 2024年2月9日