Android 物理按鍵 (音量鍵、電源鍵、返回鍵等) 長按檢測依賴 KeyEvent 的 重複計數 機制:用戶按住不放時,系統會持續分發 onKeyDown,event.getRepeatCount() 從 0 遞增。當達到系統判定的長按閾值 (約 500ms) 時,觸發 onKeyLongPress。
// Activity / View 基類 public boolean onKeyDown(int keyCode, KeyEvent event) public boolean onKeyLongPress(int keyCode, KeyEvent event) public boolean onKeyUp(int keyCode, KeyEvent event)
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN || keyCode == KeyEvent.KEYCODE_VOLUME_UP) {
// 僅在相機預覽可見時處理
if (cameraPreview.getVisibility() != View.VISIBLE) return false;
// 首次按下 (repeatCount == 0) 時請求長按追蹤
if (event.getRepeatCount() == 0) {
event.startTracking(); // 關鍵:告訴系統我關心長按
return true; // 消費事件
}
return true; // 後續重複事件也消費
}
return super.onKeyDown(keyCode, event);
}
private boolean lockLongPressKey = false; // 互斥標誌
@Override
public boolean onKeyLongPress(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN || keyCode == KeyEvent.KEYCODE_VOLUME_UP) {
Log.d(TAG, "音量鍵長按觸發");
lockLongPressKey = true; // 設置互斥鎖
onShutterButtonLongPressed(); // 執行長按業務 (如連拍、錄像)
return true;
}
return super.onKeyLongPress(keyCode, event);
}
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN || keyCode == KeyEvent.KEYCODE_VOLUME_UP) {
// 若已處理長按,直接消費抬起事件,不再執行單擊邏輯
if (lockLongPressKey) {
lockLongPressKey = false;
return true;
}
// 單擊邏輯 (repeatCount == 0 表示無重複,即點擊非長按)
if (event.getRepeatCount() == 0) {
if (canTakePhoto()) {
onShutterButtonClick(); // 拍照
}
}
return true;
}
return super.onKeyUp(keyCode, event);
}
repeatCount == 0 時調用,否則系統不會發送長按事件true 表示事件已消費,不再向上傳遞;false 交給父類/系統處理KEYCODE_VOLUME_UP/DOWN, KEYCODE_POWER, KEYCODE_BACK, KEYCODE_HOME (不可攔截), KEYCODE_MENU與物理鍵不同,View 長按通過 OnLongClickListener 實現,無需手動管理重複計數。
public class MainActivity extends Activity implements View.OnLongClickListener {
private Button btn;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
btn = findViewById(R.id.button);
btn.setOnLongClickListener(this);
}
@Override
public boolean onLongClick(View v) {
if (v.getId() == R.id.button) {
Toast.makeText(this, "按鈕被長按了", Toast.LENGTH_SHORT).show();
return true; // 消費事件,不再觸發 onClick
}
return false;
}
}
button.setOnLongClickListener {
Toast.makeText(this, "長按觸發", Toast.LENGTH_SHORT).show()
true // 消費事件
}
<Button
android:id="@+id/btn"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="長按我"
android:onLongClick="@{() -> viewModel.onLongClick()}" />
OnLongClickListener 先於 OnClickListener 觸發onLongClick 返回 true,onClick 不會 被調用false,長按後鬆開仍會觸發 onClick| 場景 | 推薦按鍵 | 處理方式 |
|---|---|---|
| 相機拍照/錄像 | 音量鍵 | 物理鍵長按 + 互斥鎖 |
| 音量調節 | 音量鍵 | 系統默認處理,勿攔截 |
| 截圖 | 電源+音量下 | 系統級組合鍵,App 無法攔截 |
| 緊急求助 | 電源鍵 5 次 | 系統級,需聲明權限 |
| 列表項操作 (刪除/置頂) | 列表項 View | OnLongClickListener + ContextMenu |
| 輸入框粘貼/選詞 | EditText | 系統內置長按菜單 |
物理按鍵長按依賴 KeyEvent 重複計數與 startTracking() 機制,需在 onKeyDown、onKeyLongPress、onKeyUp 三協同,並用互斥變量避免長按後抬起誤觸發點擊。軟件按鈕長按則直接使用 OnLongClickListener,語義清晰、API 簡單。根據業務場景選擇正確方案,能構建符合用戶直覺的交互體驗。