开发者控制台
登录
登录
开发者控制台

开发者工具菜单 (Fire TV)

开发者工具菜单 (Fire TV)

开发者工具菜单提供许多选项，用于提供有关应用的实时指标和其他信息。此信息可以帮助您进行故障排除、开发和测试。

调用开发者工具菜单

您可以通过多种方式调用开发者工具菜单：

  • 遥控器： 在方向键上，按住中心按钮一秒钟；然后（仍按住“中心”按钮），按向下按钮。按住两个按钮约3-4秒钟。然后松开两个按钮并按遥控器的菜单按钮。（如果这不起作用，请尝试同时而非连续按下“中心”按钮和“向下”按钮。）
  • 亚马逊游戏控制器： 同时按住A和Y按钮5秒钟；然后松开按钮并按控制器的菜单按钮。

  • Android调试桥： 如果在Fire TV上启用了ADB并已连接计算机，可以运行以下命令来调用该对话框：adb shell am start com.amazon.ssm/com.amazon.ssm.ControlPanel

    要使用ADB命令，需要在Fire TV设置中启用ADB调试、安装Android Studio并知道Fire TV的IP地址（转到Settings（设置）> My Fire TV（我的Fire TV）（或Device & Software（设备与软件））> About（关于）> Network（网络））。在计算机上打开一个终端窗口，并使用以下命令通过ADB进行连接：adb connect 123.456.7.89:5555，从而将123.456.7.89替换为您自己的IP地址。端口保留为5555。查看详细信息： 通过ADB连接到Fire TV。

以下屏幕截图显示了开发者工具菜单上的选项：

各个窗格的解释如下：

System X-Ray

System X-Ray收集即时系统指标，并在屏幕顶部显示为叠加层。如果开启此选项，叠加层在屏幕上将始终可见。

System X-Ray叠加层包含有关以下内容的详细信息：

  • 显示屏
  • CPU
  • 内存
  • 网络

有关System X-Ray的深入介绍，请参阅System X-Ray。

高级选项

高级选项允许在使用Android MediaCodec API时显示多媒体信息。当您打开此选项，然后播放媒体时，右侧会显示一个附加显示屏（对于多媒体（音频和视频），标题为“MUL”；对于音频焦点，标题为“AUD”）。

多媒体面板中显示的信息分为三部分： 音频、视频和音频焦点。

音频

属性 描述
编解码器 音频编解码器格式
硬件加速 音频播放是否经过硬件加速
输入比特率 音频输入比特率
安全 是否安全

视频

属性 描述
编解码器 视频编解码器格式
硬件加速 视频播放是否经过硬件加速
输入比特率 视频输入比特率
安全 视频是否安全
丢帧 丢帧计数
分辨率 播放分辨率
帧速率 播放帧速率
颜色标准

音频焦点

属性 描述
程序包 音频播放的程序包名称
增益 音频焦点增益影响
损失 音频焦点损失影响
F/U/C 标记/用法/内容
  • 标记(F)： 音频焦点请求的标记值。有关更多信息，请参阅AudioManager.java#2445。
  • 用法(U)： 用法值
  • 内容(C)： 内容值。用法和内容的枚举值可以在这里找到： AudioAttributes.java#72.

音频焦点值按如下方式缩短：

  • AUDIOFOCUS_NONE：none
  • AUDIOFOCUS_GAIN：gain
  • AUDIOFOCUS_GAIN_TRANSIENT：g_tr
  • AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK：gtmd
  • AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE：gtre
  • AUDIOFOCUS_LOSS：loss
  • AUDIOFOCUS_LOSS_TRANSIENT：l_tr
  • LOSS_TRANSIENT_CAN_DUCK：ltcd
  • UNKNOWN：unkn

快照

快照为用户提供了一种通过adb命令即时收集所有指标信息的方法。每当您输入以下命令时，指标信息都将显示在命令行中。

adb shell dumpsys activity service com.amazon.ssm/.OverlayService

System X-Ray必须正在运行，该命令才能正常发挥作用。

以下是一个示例输出：

SERVICE com.amazon.ssm/.OverlayService 3dde6680 pid=10820
  Client:
    [com.amazon.ssm.timestamp]: [2017-02-07 15:11:53]
    [com.amazon.ssm.display.resolution]: [1080]
    [com.amazon.ssm.display.refreshrate]: [60]
    [com.amazon.ssm.display.hdcpversion]: [1.0]
    [com.amazon.ssm.cpu.core0]: [30]
    [com.amazon.ssm.cpu.core1]: [29]
    [com.amazon.ssm.cpu.core2]: [0]
    [com.amazon.ssm.cpu.core3]: [0]
    [com.amazon.ssm.memory.appname]: [tv.twitch.android.viewer]
    [com.amazon.ssm.memory.appmemory]: [56.8 MB]
    [com.amazon.ssm.memory.activememory]: [1.3GB]
    [com.amazon.ssm.memory.availablememory]: [231.3 MB]
    [com.amazon.ssm.network.rssi]: [-56]
    [com.amazon.ssm.network.systemdownloadspeed]: [2.2 Mbps]
    [com.amazon.ssm.network.appdownloadspeed]: [2.1 Mbps]

记录并共享

“记录并共享”将有关CPU、内存、网络和多媒体的瞬时指标作为历史数据存储到数据库中。虽然相同的信息将通过System X-Ray叠加层以图形方式实时显示，但“记录并共享”会获取此信息并将其存储到可转储到命令行的历史记录中。

要使用“记录并共享”，请首先将开发者工具菜单中的“记录并共享”设置切换为开。然后系统会提示您选择“Record Settings（记录设置）”：

这些属性控制以下内容：

  • 间隔： 两次记录之间的时间： 2秒、4秒、8秒、16秒或32秒。
  • 持续时间： 数据在数据库中的存储时间： 1小时、2小时、4小时、8小时或16小时。

默认值（间隔2秒，持续时间1小时）意味着每2秒钟就会有统计数据被记录并存储在数据库中。记录将在数据库中总共存储1小时。

播放媒体以收集一些记录的信息后，您可以使用以下方式将所有历史指标转储到命令行：

adb shell dumpsys activity service com.amazon.ssm/.OverlayService -all

响应包括以下信息：

CPU：

  • Timestamp
  • cpu0
  • cpu1
  • cpu2
  • cpu3

内存：

  • Timestamp
  • Total_Memory
  • Available_Memory
  • Active_Memory
  • Foreground_App_Memory
  • Foreground_App_PackageName

网络：

  • Timestamp
  • RSSI
  • Download_Speed
  • Foreground_App_Download_Speed
  • Foreground_App_PackageName

多媒体：

  • Timestamp
  • AudioCodec
  • AudioInputBitrate
  • AudioAccelerated
  • AudioSecure
  • VideoCodec
  • VideoInputBitrate
  • VideoAccelerated
  • VideoSecure
  • VideoResolution
  • VideoFramerate
  • VideoFramedropped

以下是命令行上的显示示例：

 CPU
 Timestamp           cpu0 cpu1 cpu2 cpu3
 2016-10-31 11:40:22 19   16   13   18

 MEMORY
 Timestamp           Total_Memory Available_Memory Active_Memory Foreground_App_Memory Foreground_App_PackageName
 2016-10-31 11:40:23 919.3 MB     156.3 MB         731.8 MB      31.3 MB               com.amazon.ssm

 NETWORK
 Timestamp           RSSI Download_Speed Foreground_App_Download_Speed Foreground_App_PackageName
 2016-10-31 11:40:21 -41  14.4 kbps      0 bps                         com.amazon.ssm
 2016-10-31 11:40:23 -41  14.0 kbps      0 bps                         com.amazon.ssm

如果您只对部分指标感兴趣，则可以在命令中添加不同的选项。例如，要将内存和网络历史指标转储到命令行：

adb shell dumpsys activity service com.amazon.ssm/.OverlayService -memory -network

下表显示了所有可用选项：

选项 描述
空白
（没有传递选项）		 转储快照信息
-snapshot 转储快照信息
-all 转储数据库中的所有信息
-memory 转储数据库中的内存信息
-cpu 转储数据库中的CPU信息
-network 转储数据库中的网络信息
-multimedia 转储数据库中的多媒体信息

要查看可用的选项，请传递-help参数：

adb shell dumpsys activity service com.amazon.ssm/.OverlayService -help

您可以清除存储在数据库中的记录指标（在持续时间结束并自动清除数据之前）。从开发者选项工具菜单中，选择记录并共享，然后单击遥控器上的菜单按钮。

安全区

有些电视机对显示屏使用过扫描。过扫描意味着电视机会在可见屏幕边缘外显示一些信息（以适应显示屏的差异）。不应在过扫描区域中显示重要信息。

要使过扫描区域可见，您可以将安全区开关切换到开。这将使过扫描区域变得显而易见，以便您避免在这些区域中显示任何信息。

请注意，Fire TV Stick（第2代）不包括屏幕尺寸校准。如果屏幕显示不能与电视屏幕正确契合，则过扫描区域可能无法准确显示。

开发者选项

目前，某些第三方应用（例如Netflix和HBO Go）在亚马逊Fire TV主屏幕上的特定行中显示推荐信息。有关推荐的更多信息，请参阅推荐概览。

开发者选项允许您打开名为Recommended By Your Apps（由我的应用推荐）的行（显示在Netlix和HBO Go行下方）。Recommended By Your Apps行将显示从第三方应用发送的推荐。

启用此行将显示来自用户已安装的所有第三方应用的推荐（不包括Netflix和HBO Go等某些应用，这些应用在自己的行上显示推荐）。

网络代理

如果您的应用与远程服务或网站通信，则检查其生成的HTTP或HTTPS流量通常很有用。这包括您的应用发起的请求及其收到的响应，以及包含Cookie、缓存信息和其他信息的HTTP标头。有关更多详细信息，请参阅网络代理。

清除凭证存储

这将清除为Fire TV上的应用设置的所有凭证。

启动Network Advisor

启动用于检查网络连接强度、通道和其他详细信息的网络分析窗口。如果存在问题，Network Advisor会提供建议来解决问题。

另请参阅

更多详细信息，请参阅以下内容：

Last updated: 2020年10月29日