如何监听Quick Settings Tile设置图标的点击事件

核心误区提醒：用BroadcastReceiver监听快速设置磁贴点击从实现逻辑上就不成立：Android 7.0（API 24）及以上版本的快速设置磁贴交互完全由TileService组件接管，磁贴点击、状态更新等事件不会通过系统广播派发，广播接收器永远收不到对应事件。

正确实现步骤如下：

1. 清单文件声明组件与权限 #

在AndroidManifest.xml中添加磁贴必需的权限、服务配置，缺少任意配置都会导致磁贴无法被系统识别：

<!-- 声明绑定快速设置磁贴的必需权限 -->
<uses-permission android:name="android.permission.BIND_QUICK_SETTINGS_TILE" />

<application>
    <!-- 自定义磁贴服务配置 -->
    <service
        android:name=".MyTileService"
        android:label="自定义磁贴名称"
        android:icon="@drawable/ic_your_tile_icon"
        android:permission="android.permission.BIND_QUICK_SETTINGS_TILE">
        <intent-filter>
            <action android:name="android.service.quicksettings.action.QS_TILE" />
        </intent-filter>
    </service>
</application>

2. 实现磁贴服务逻辑 #

继承TileService类，重写对应生命周期方法，点击事件的处理逻辑直接写在onClick()回调中：

class MyTileService : TileService() {
    // 磁贴被用户添加到快速设置栏时触发
    override fun onTileAdded() {
        super.onTileAdded()
        // 初始化磁贴状态：STATE_ACTIVE为激活、STATE_INACTIVE为未激活、STATE_UNAVAILABLE为不可用
        qsTile.state = Tile.STATE_INACTIVE
        qsTile.updateTile()
    }

    // 磁贴被点击时触发，即需要实现的点击监听逻辑入口
    override fun onClick() {
        super.onClick()
        val currentTile = qsTile
        // 示例逻辑：点击切换磁贴激活状态
        currentTile.state = if (currentTile.state == Tile.STATE_ACTIVE) {
            Tile.STATE_INACTIVE
        } else {
            Tile.STATE_ACTIVE
        }
        // 修改磁贴状态后必须调用该方法，否则界面不会刷新
        currentTile.updateTile()

        // 点击后需要跳转页面的，使用startActivityAndCollapse方法，点击后会自动收起通知栏
        // val jumpIntent = Intent(this, MainActivity::class.java)
        // jumpIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        // startActivityAndCollapse(jumpIntent)

        // 锁屏状态下要操作弹窗、跳转页面，需要先调用unlockAndRun执行逻辑
    }

    // 磁贴被用户从快速设置栏移除时触发
    override fun onTileRemoved() {
        super.onTileRemoved()
        // 做资源释放、状态重置操作
    }
}

注意事项 #

• 不要手动调用TileService的生命周期方法，所有生命周期调度由系统完成，手动调用会导致磁贴状态异常
• Android 12（API 31）及以上版本禁止磁贴在后台直接启动Activity，必须使用startActivityAndCollapse()方法，否则会抛出异常
• 如果要监听系统自带磁贴（如WiFi、蓝牙、移动数据等系统预置磁贴）的点击事件，没有公开API可以直接捕获点击动作，只能通过监听对应系统状态变化的广播（如蓝牙状态变化广播、WiFi状态变化广播）做间接响应。

内容的提问来源于stack exchange，提问作者Sharif Ahmed