Android锁屏通知操作按钮触发设备PIN验证的实现求助

嘿，这个问题我熟！之前帮朋友处理过类似的锁屏通知验证需求，给你一套完整的解决方案，保证能解决你的问题：

核心思路是：拦截操作按钮的点击事件，先判断设备是否处于锁屏且有安全验证（PIN/图案/密码），如果是则触发系统验证界面，验证通过后再执行API调用；解锁状态下直接执行操作，全程不需要启动可见的通知相关Activity。

1. 先搞个设备验证工具类 #

用来快速判断设备是否有锁屏安全机制，以及创建系统验证Intent：

object KeyguardAuthUtil {
    // 判断设备是否设置了锁屏密码/PIN/图案
    fun isDeviceSecured(context: Context): Boolean {
        val keyguardManager = context.getSystemService(KeyguardManager::class.java)
        return keyguardManager.isDeviceSecure
    }

    // 创建系统验证界面的Intent
    fun createAuthIntent(context: Context, title: String, description: String): Intent? {
        val keyguardManager = context.getSystemService(KeyguardManager::class.java)
        return keyguardManager.createConfirmDeviceCredentialIntent(title, description)
    }
}

2. 自定义广播接收器处理操作按钮点击 #

用广播来接收通知操作按钮的点击，避免直接启动Activity，同时在这里做锁屏判断和验证跳转：

class NotificationActionReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        val action = intent.action ?: return

        val keyguardManager = context.getSystemService(KeyguardManager::class.java)
        val isLocked = keyguardManager.isKeyguardLocked
        val isSecured = KeyguardAuthUtil.isDeviceSecured(context)

        when {
            // 锁屏且有安全验证：先跳系统验证界面
            isLocked && isSecured -> {
                val authIntent = KeyguardAuthUtil.createAuthIntent(
                    context,
                    "身份验证",
                    "请输入PIN码以执行操作"
                )?.apply {
                    addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
                    // 把要执行的操作类型传递给验证后的处理逻辑
                    putExtra("ACTION_TYPE", action)
                }
                authIntent?.let { context.startActivity(it) }
            }
            // 解锁状态或无安全验证：直接执行操作
            else -> executeAction(context, action)
        }
    }

    // 这里写你的API调用逻辑
    private fun executeAction(context: Context, action: String) {
        when (action) {
            "ACTION_CALL_API" -> {
                // 示例：用协程在IO线程调用API
                CoroutineScope(Dispatchers.IO).launch {
                    // apiService.yourApiMethod()
                }
            }
            // 可以扩展其他操作类型
        }
    }
}

3. 做个透明Activity接收验证结果 #

系统验证完成后会返回结果，我们需要一个完全透明的Activity来接收结果，执行操作后立即销毁，用户完全看不到这个界面：

3.1 在AndroidManifest中注册透明Activity #

<activity
    android:name=".AuthResultActivity"
    android:theme="@style/TransparentActivityTheme"
    android:excludeFromRecents="true"
    android:launchMode="singleInstance"/>

3.2 定义透明主题（res/values/styles.xml） #

<style name="TransparentActivityTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowAnimationStyle">@null</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowFullscreen">true</item>
</style>

3.3 实现透明Activity的逻辑 #

class AuthResultActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 检查验证是否通过
        if (intent.getBooleanExtra(Intent.EXTRA_KEYGUARD_AUTHENTICATED, false)) {
            val actionType = intent.getStringExtra("ACTION_TYPE")
            actionType?.let {
                // 验证通过，执行API调用
                NotificationActionReceiver().executeAction(this, it)
            }
        }
        // 立即销毁Activity，用户无感知
        finish()
    }
}

4. 构建通知时绑定操作按钮的PendingIntent #

创建通知时，把操作按钮的点击事件指向我们的广播接收器，而不是直接执行操作：

fun buildNotification(context: Context): Notification {
    val actionIntent = Intent(context, NotificationActionReceiver::class.java).apply {
        action = "ACTION_CALL_API" // 对应你要执行的操作类型
    }
    val pendingIntent = PendingIntent.getBroadcast(
        context,
        0,
        actionIntent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    return NotificationCompat.Builder(context, "YOUR_CHANNEL_ID")
        .setContentTitle("通知标题")
        .setContentText("通知内容")
        .setSmallIcon(R.drawable.ic_notification)
        .addAction(R.drawable.ic_action_icon, "执行操作", pendingIntent)
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) // 确保锁屏时能看到操作按钮
        .build()
}

解锁状态的处理 #

上面的代码已经自动处理了解锁状态：当设备解锁时，isLocked为false，会直接进入executeAction执行API调用，不需要任何验证步骤，完全符合你的需求。

注意事项 #

• Android 12及以上版本，PendingIntent必须设置FLAG_IMMUTABLE或FLAG_MUTABLE，这里用FLAG_IMMUTABLE即可，因为我们不需要修改Intent内容。
• 不需要额外申请权限，createConfirmDeviceCredentialIntent会自动调用系统验证界面，权限由系统处理。
• 透明Activity一定要设置excludeFromRecents="true"，避免出现在最近任务列表中。

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