如何检测Fire TV应用被用户按下home键触发的最小化事件

Fire TV基于AOSP（安卓开放源代码项目）定制，系统没有公开直接监听HOME按键按下的API，不过可以通过以下两种稳定方案实现应用被主动最小化的事件监听：

方案1：生命周期回调判断（最通用，无需权限） #

该方案通过应用生命周期回调结合场景判断实现，不需要申请任何权限，适配所有Fire TV机型：

• 核心原理：用户按下HOME键让应用退到后台时，会依次触发onPause()→onStop()生命周期回调，排除其他退后台场景后即可判定为HOME键触发的最小化操作
• 实现逻辑：
  • 在应用的Activity基类中定义全局标记位isExplicitQuit，默认值为false
  • 用户按返回键触发onBackPressed()时，将isExplicitQuit设为true，区分主动退出和最小化场景
  • 在onStop()回调中判断：如果isExplicitQuit为false且应用不在前台运行，即可判定为用户按HOME键最小化应用
  • 应用回到前台触发onStart()时，重置isExplicitQuit为false
• 示例代码：

public class BaseFireTVActivity extends AppCompatActivity {
    private boolean isExplicitQuit = false;

    @Override
    public void onBackPressed() {
        isExplicitQuit = true;
        super.onBackPressed();
    }

    @Override
    protected void onStart() {
        super.onStart();
        isExplicitQuit = false;
    }

    @Override
    protected void onStop() {
        super.onStop();
        if (!isExplicitQuit && !isAppOnForeground()) {
            // 触发用户按HOME键最小化的自定义逻辑
            onAppMinimizedByHome();
        }
    }

    // 判断应用是否在前台运行
    private boolean isAppOnForeground() {
        ActivityManager activityManager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
        List<ActivityManager.RunningAppProcessInfo> appProcesses = activityManager.getRunningAppProcesses();
        if (appProcesses == null) return false;
        final String packageName = getPackageName();
        for (ActivityManager.RunningAppProcessInfo appProcess : appProcesses) {
            if (appProcess.processName.equals(packageName) && appProcess.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND) {
                return true;
            }
        }
        return false;
    }

    protected void onAppMinimizedByHome() {
        // 子类重写该方法实现自定义业务逻辑
    }
}

方案2：辅助功能服务监听（精准度更高，需用户授权） #

如果需要100%准确识别HOME按键动作，可以通过安卓辅助功能服务实现，不受其他后台切换场景干扰：

• 实现步骤：
  • 新建服务类继承AccessibilityService，重写onAccessibilityEvent方法
  • 在服务配置中声明捕获按键事件的权限
  • 引导用户在Fire TV的「设置-无障碍」选项中开启应用的辅助功能权限
  • 当收到TYPE_KEY_EVENT类型事件、且按键编码为KEYCODE_HOME时，即可判定为用户按下HOME键
• 缺点：需要用户主动授权，部分用户可能会拒绝权限申请

注意事项 #

不要尝试通过重写onKeyDown或者dispatchKeyEvent方法监听HOME键：Fire TV和原生Android一致，HOME键事件会被系统框架直接拦截，不会分发到普通应用的上层回调，这两种方式无法生效。两种方案都符合亚马逊应用商店的审核规范，不存在权限违规问题。

内容的提问来源于stack exchange，提问作者Joseph Martínez