Ein Eingabestift kann ein außergewöhnlich produktives und kreatives Tool sein. Wenn Nutzer jedoch mit einem Eingabestift zeichnen, schreiben oder mit einer App interagieren, berühren sie manchmal den Bildschirm mit der Handfläche. Das Touch-Event kann an deine App gemeldet werden, bevor das System das Ereignis erkennt und als versehentliche Berührung mit der Handfläche verwirft.
Best Practices
Ihre App muss irrelevante Touch-Events erkennen und ignorieren. In Jetpack Compose können Sie über ein PointerEvent auf das zugrunde liegende Android-MotionEvent zugreifen. Prüfen Sie die MotionEvent auf ACTION_CANCEL. Das gibt an, dass eine Geste beendet werden soll und möglicherweise ein Rollback erforderlich ist. Prüfe unter Android 13 (API-Level 33) und höher, ob das Flag FLAG_CANCELED für die Ereignisse ACTION_CANCEL und ACTION_POINTER_UP gesetzt ist. Das ist ein starkes Signal dafür, dass die Berührung unbeabsichtigt war, z. B. mit der Handfläche.
Zutaten
Modifier.pointerInput(): Der Compose-Modifikator, der zum Verarbeiten der Zeigereingabe verwendet wird.PointerEvent: Stellt ein Zeigerereignis in Compose dar, das eine oder mehrere Änderungen enthält.PointerEvent.motionEvent: Erweiterungsattribut, das Zugriff auf das zugrunde liegende Android-MotionEvent(nullable) bietet.MotionEvent: Stellt Berührungs- und Bewegungsereignisse dar. Enthält die Informationen, die erforderlich sind, um zu bestimmen, ob ein Ereignis ignoriert werden soll.ACTION_CANCEL:MotionEvent-Konstante, die angibt, dass eine Geste abgebrochen wurde. Die Geste sollte beendet und möglicherweise rückgängig gemacht werden.ACTION_POINTER_UP:MotionEvent-Konstante, die angibt, dass ein anderer Zeiger als der erste Zeiger nach oben bewegt wurde, d. h. den Kontakt mit dem Gerätedisplay verloren hat.FLAG_CANCELED:MotionEvent-Konstante, die angibt, dass das Loslassen des Zeigers ein unbeabsichtigtes Touch-Event verursacht hat. Wird unter Android 13 (API-Level 33) und höher zuACTION_POINTER_UP- undACTION_CANCEL-Ereignissen hinzugefügt.
Schritte
Prüfen Sie die MotionEvent-Objekte, die an Ihre App gesendet werden. Verwenden Sie die MotionEvent APIs, um die Ereignismerkmale zu bestimmen:
- Ereignisse mit einem einzelnen Zeiger: Prüfen Sie, ob
ACTION_CANCELvorhanden ist. Das bedeutet, dass die Geste beendet werden soll. Prüfe unter Android 13 und höher auch aufFLAG_CANCELED, um zu bestätigen, dass die Berührung unbeabsichtigt war. - Multi-Pointer-Ereignisse: Unter Android 13 und höher kannst du nach
ACTION_POINTER_UPundFLAG_CANCELEDsuchen, um unbeabsichtigte Berührungen zu erkennen.
Reagieren Sie auf diese Ereignisse, indem Sie die Geste beenden und alle temporären Änderungen rückgängig machen.
1. Bewegungsereignisobjekte abrufen
Verwenden Sie Modifier.pointerInput, um Zeigereingaben für eine zusammensetzbare Funktion zu verarbeiten. Verwenden Sie im Bereich der Zeigereingabe awaitPointerEventScope und awaitPointerEvent, um Ereignisse zu empfangen, und rufen Sie das zugrunde liegende Android-MotionEvent mit dem Attribut motionEvent ab:
import androidx.compose.ui.input.pointer.pointerInput Box( modifier = Modifier .fillMaxSize() .pointerInput(Unit) { awaitPointerEventScope { while (true) { val event = awaitPointerEvent() val motionEvent = event.motionEvent if (motionEvent != null) { // Process motion event. } } } } )
2. Ereignisaktion und Flags bestimmen
Prüfe MotionEvent auf ACTION_CANCEL. Das gibt ein Einzelzeigerereignis auf allen API-Ebenen an. Prüfen Sie unter Android 13 und höher ACTION_POINTER_UP auf FLAG_CANCELED:
import androidx.compose.ui.input.pointer.pointerInput Box( modifier = Modifier .fillMaxSize() .pointerInput(Unit) { awaitPointerEventScope { while (true) { val event = awaitPointerEvent() val motionEvent = event.motionEvent ?: continue when (motionEvent.actionMasked) { MotionEvent.ACTION_CANCEL -> { // Process canceled single-pointer motion event for all SDK versions. } MotionEvent.ACTION_POINTER_UP -> { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && (motionEvent.flags and MotionEvent.FLAG_CANCELED) == MotionEvent.FLAG_CANCELED ) { // Process canceled multi-pointer motion event for Android 13 and higher. } } } } } } )
3. Geste rückgängig machen
Sobald Sie eine Berührung mit der Handfläche erkannt haben, können Sie die Bildschirmeffekte der Geste rückgängig machen.
Deine App muss einen Verlauf der Nutzeraktionen speichern, damit unbeabsichtigte Eingaben wie Berührungen mit der Handfläche rückgängig gemacht werden können. Ein Beispiel finden Sie im Codelab Unterstützung für Eingabestifte in Android-Apps verbessern unter Einfache Zeichen-App implementieren.
Ergebnisse
Deine App kann jetzt Berührungen mit der Handfläche bei Multi-Pointer-Ereignissen unter Android 13 und höher sowie bei Single-Pointer-Ereignissen auf allen API-Ebenen erkennen und ablehnen.
Zusätzliche Ressourcen
Hier finden Sie weitere Informationen:
- Android 13-Funktionen und -APIs – Verbesserte Handballenerkennung
- Entwicklerleitfäden
- Erweiterte Eingabestift-Funktionen
- Abschnitt Handballenerkennung unter Eingabekompatibilität auf großen Bildschirmen
- Codelab – Unterstützung für Eingabestifte in Android-Apps verbessern