用戶習慣「再按一次退出」或「長按退出」。本文深度解析 onKeyDown、onKeyUp、onBackPressed、dispatchKeyEvent 四個鍵盤事件分發節點,實現 長按 Back 鍵彈出確認對話框退出,且不影響短按 Back 的正常導航行為。
dispatchKeyEvent(KeyEvent) --(分發)--> View.dispatchKeyEvent
| |
v v
onKeyDown(KeyEvent) onKeyUp(KeyEvent)
| |
v v
onBackPressed() (API 20+) <-- 默認實現: finish()
關鍵點: dispatchKeyEvent 是最早攔截點,返回 true 表示已消費,事件不再向下傳遞。
| 方案 | 實現邏輯 | 缺陷 |
|---|---|---|
| 雙擊退出 (時間間隔 < 2s) | onKeyDown 記錄時間戳,間隔 < 2s 則 finish | 誤觸率高、無視覺反饋、無法取消 |
| onKeyDown + onKeyUp 計算按下時長 | 記錄 down/up 時間差 > 2s 判定長按 | 短按時 up 事件被消費,導致正常返回失效 |
| dispatchKeyEvent + event.isLongPress() | 系統自動識別長按 (約 500ms),攔截並彈窗確認 | 無缺陷,推薦 |
public class BaseActivity extends AppCompatActivity {
private static final long LONG_PRESS_TIMEOUT = 500L; // 系統默認
@Override
public boolean dispatchKeyEvent(KeyEvent event) {
if (event.getKeyCode() == KeyEvent.KEYCODE_BACK) {
// 長按事件由系統自動合成,ACTION_DOWN 且 isLongPress()=true
if (event.getAction() == KeyEvent.ACTION_DOWN && event.isLongPress()) {
showExitConfirmDialog();
return true; // 消費事件,不再傳遞給 onKeyDown/onBackPressed
}
// 短按正常分發
}
return super.dispatchKeyEvent(event);
}
private void showExitConfirmDialog() {
new AlertDialog.Builder(this)
.setTitle("提示")
.setMessage("確定要退出應用嗎?")
.setPositiveButton("確定", (dialog, which) -> {
// 完全退出應用 (慎用,通常只需 finish 當前 Activity)
finishAffinity(); // API 16+ 關閉所有 Activity
// System.exit(0); // 極端情況最後手段
})
.setNegativeButton("取消", null)
.show();
}
}
// 在 ComponentActivity/FragmentActivity 中
OnBackPressedDispatcher dispatcher = getOnBackPressedDispatcher();
dispatcher.addCallback(this, new OnBackPressedCallback(true) {
@Override
public void handleOnBackPressed() {
// 此處處理邏輯,但無法直接區分長按/短按
// 長按仍需在 dispatchKeyEvent 攔截
}
});
注意: OnBackPressedDispatcher 處理的是邏輯返回 (含手勢導航、工具欄返回鍵),硬件長按事件仍走 dispatchKeyEvent。
dialog.setCancelable(false)。finishAffinity(),需確保無前台 Service/播放器需優雅停止。短按 Back:正常返回上一頁/關閉彈窗/退出 Activity。
長按 Back (約 0.5s):彈出「確定退出?」對話框,確定則關閉整個應用任務棧。
採用 dispatchKeyEvent + isLongPress() 方案,零成本實現精準長按攔截,完美兼容短按導航與手勢返回。