开发人员控制台

识别Fire TV设备


识别Fire TV设备

大多数Amazon Fire TV开发者同时为Google Play和亚马逊应用商店构建应用,对这两个应用市场和设备使用基于Android的相同代码。由于亚马逊设备不使用谷歌服务(使用亚马逊服务和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)

本文档提供有关根据功能、型号和API级别识别Amazon设备的详细信息。在Fire TV设备规格中,可找到有关Fire TV设备相应的Fire OS版本的详细信息。

检查Amazon Fire TV设备的原因

由于各种原因,可能需要在代码中检查Amazon Fire TV设备:

  • 具有仅在Fire OS 7设备上支持的与Pie相关的(API级别27及更高级别)功能。
  • 具有仅在Fire OS 6设备上支持的与Nougat相关的(API级别25及更高级别)功能。
  • 若需确定应用是否需要在其onPause()方法中拆除DRM和HW解码管道(由于对多个DRM上下文的处理能力有限,Fire TV第1代需要该做法)。

按功能和型号识别亚马逊设备

可通过查找amazon.hardware.fire_tv功能,识别Amazon Fire TV设备。也可使用android.os.Build.MODEL中的模式。有关每个设备构建型号的信息,请参阅《Fire TV设备规格》。下图显示了每个设备的构建型号。(将APK上传到开发者控制台时,可看到该对话框。)

Fire TV设备型号名称
Fire TV设备型号名称
Fire TV设备 构建型号 Android级别 Fire OS版本
Fire TV Edition - Onida HD/FHD (2020) AFTTIFF55 API级别25 (Android 7.1) Fire OS 6
Fire TV Edition - ok 4K (2020) AFTWI001 Android级别28 (Android 9) Fire OS 7
Fire TV Stick - 第3代(2020) AFTSSS Android Level 28 (Android 9) Fire OS 7
Fire TV Stick Lite - 第1代(2020) AFTSS Android Level 28 (Android 9) Fire OS 7
Fire TV版 - Toshiba 4K UHD (2020) AFTDCT31 Android Level 28 (Android 9) Fire OS 7
Fire TV版 - Insignia 4K UHD (2020) AFTDCT31 Android Level 28 (Android 9) Fire OS 7
Fire TV Stick - 第2代(2016-2019) AFTT Android Level 22 (Android 5.1) Fire OS 5
Fire TV Edition - Toshiba HD (2018-2020) AFTBAMR311 API级别25 (Android 7.1) Fire OS 6
Fire TV Edition - Insignia HD (2018-2020) AFTEAMR311 API级别25 (Android 7.1) Fire OS 6
Fire TV Edition - Toshiba 4K (2018-2019) AFTKMST12 API级别25 (Android 7.1) Fire OS 6
Fire TV Edition - Onida HD (2019) AFTLE API级别25 (Android 7.1) Fire OS 6
Fire TV Cube - 第2代(2019) AFTR Android Level 28 (Android 9) Fire OS 7
Fire TV Edition - Grundig OLED 4K (2019) AFTEUFF014 Android Level 28 (Android 9) Fire OS 7
Fire TV Edition - Grundig Vision 7 4K (2019) AFTEU014 Android Level 28 (Android 9) Fire OS 7
Fire TV Edition - JVC 4K (2019) AFTSO001 Android Level 28 (Android 9) Fire OS 7
Fire TV Edition - Nebula条形音箱(2019) AFTMM API级别25 (Android 7.1) Fire OS 6
Fire TV Edition - Grundig Vision 6 HD (2019) AFTEU011 Android Level 28 (Android 9) Fire OS 7
Fire TV Edition - Insignia 4K (2018) AFTJMST12 API级别25 (Android 7.1) Fire OS 6
Fire TV Cube - 第1代(2018) AFTA API级别25 (Android 7.1) Fire OS 6
Fire TV Stick 4K - 第1代(2018) AFTMM API级别25 (Android 7.1) Fire OS 6
Fire TV Stick - Basic Edition (2017) AFTT Android Level 22 (Android 5.1) Fire OS 5
Fire TV Edition - Element 4K (2017) AFTRS Android Level 22 (Android 5.1) Fire OS 5
Fire TV - 第3代(2017) AFTN API级别25 (Android 7.1) Fire OS 6
Fire TV - 第2代(2015) AFTS Android Level 22 (Android 5.1) Fire OS 5
Fire TV Stick - 第1代(2014) AFTM Android Level 22 (Android 5.1) Fire OS 5
Fire TV - 第1代(2014) AFTB Android Level 22 (Android 5.1) Fire OS 5

所有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, "Yes, this is a Fire TV device.(是,这是Fire TV设备。)");
} else {
 Log.v(TAG, "No, this is not a Fire TV device.(否,这不是Fire TV设备。)");
}

还可通过将android.os.Build.MODELBuild.MANUFACTURER(返回Amazon)相结合,识别Fire TV设备。

但随着非亚马逊制造商将越来越多由亚马逊提供技术支持的设备推出市场,将android.os.Build.MODELBuild.MANUFACTURER相结合可能并不总是起作用。因此,应为基于com.hardware.amazon.fire_tv功能的未来Amazon 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, "Yes, this is a Fire TV 3rd Gen device(是,这是Fire TV第3代设备)");
} else if (getPackageManager().hasSystemFeature(AMAZON_FEATURE_FIRE_TV)) {
 Log.v(TAG, "Yes, this is a Fire TV device.(是,这是Fire TV设备。)");
} else {
 Log.v(TAG, "No, this is not a Fire TV device(否,这不是Fire TV设备)");
}

检查API级别

如需实现基于Android API级别的条件行为,可使用SDK_INT检查设备的API级别。例如,以下代码检查版本是否大于等于API级别25:

if (Build.VERSION.SDK_INT >= 25) {
 Log.v(TAG, "Yes, this is an API level 25 or higher device(是,这台设备具备API级别25或更高版本)");
} else {
 Log.v(TAG, "No, this is not an API level 25 or higher device(不是,这台设备不具备API级别25或更高版本)");
}

在本例中,代码仅针对于Fire OS 6和7设备(API级别25+),并排除Fire OS 5设备(API级别22)。若只想针对于Fire OS 5设备,可使用类似的逻辑:

if (Build.VERSION.SDK_INT <= 22) {
 Log.v(TAG, ""Yes, this is an API level 22 or lower device(是,这台设备具备API级别22或更低版本)");
} else {
 Log.v(TAG, "No, this is not an API level 22 or lower device(否,这台设备具备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查看设备所具有的属性或功能,可执行以下操作:

  1. 连接到ADB
  2. 如需查看设备的属性,请运行adb shell getprop
  3. 如需查看设备的功能,请运行adb shell pm list features