SwiftUI/MacOS: Map Finger Position on Trackpad to View
Zusammenfassung
Kurz
Der vollständige Artikel erläutert anhand von Beispielcode, wie Trackpad-Fingerpositionen über `NSView` oder einen SwiftUI-Ereignis-Monitor dargestellt werden können. Der Autor berichtet von Abstürzen bei bestimmten Maus- und Koordinatenabfragen und weist auf Grenzen der SwiftUI-Variante sowie auf seine Beobachtung zu ruhenden Touches hin.
Mittel
Der vollständige Artikel von Itsuki zeigt zwei Wege, Fingerpositionen eines Mac-Trackpads in SwiftUI darzustellen: über eine eingebettete `NSView` oder mit einem lokalen Ereignis-Monitor. Im `NSView`-Ansatz verarbeitet eine eigene Ansicht `touchesBegan` und `touchesMoved`, liest `normalizedPosition` aus und übergibt die Punkte per Binding an SwiftUI. Eine Demo zeichnet sie als rote Kreise. Der Autor berichtet, dass Mausereignisse wie `mouseDown` beim Zugriff auf Touch-Daten zum Absturz führen können und `location(in:)` für diese Touches ebenfalls nicht funktioniert.
Die reine SwiftUI-Variante nutzt `.gesture`. Laut Autor ähnelt ihr Verhalten dem `NSView`-Ansatz, wenn die Ansicht das einzige App-Fenster ist. Er nennt aber Einschränkungen: Für indirekte Touches gebe es keine eigene Ereignismaske, mögliche Sonderfälle seien nicht ausgeschlossen, und die Abfrage mit `nil` liefere Touches unabhängig von ihrer Zielansicht. Auch `wantsRestingTouches` führt nach seiner Beobachtung dazu, dass keine Touch-Benachrichtigungen eintreffen. Der Mauszeiger muss sich innerhalb der `NSView` befinden. Eine systematische Geräte- oder Fallprüfung beschreibt der Artikel nicht.
Ausführlich lesen
Der vollständige Bericht von Itsuki beschreibt, wie sich Fingerpositionen auf einem Mac-Trackpad in einer SwiftUI-Ansicht darstellen lassen. Dafür vergleicht der Autor einen Ansatz mit `NSView` und eine weitgehend reine SwiftUI-Lösung. Er verweist auf einen früheren Beitrag zur Verarbeitung von Maus- und Trackpad-Ereignissen; dessen Inhalt ist hier jedoch nicht enthalten.
Beim `NSView`-Ansatz fängt eine eigene Unterklasse von `NSView` die Ereignisse `touchesBegan` und `touchesMoved` ab. Eine `NSViewRepresentable` bindet diese Ansicht in SwiftUI ein und überträgt die erfassten Punkte per Binding. Für jedes Ereignis fragt die Implementierung die aktuell berührenden Finger ab und ersetzt damit die gespeicherte Punktliste. In einer Demo werden die normalisierten Koordinaten als rote Kreise dargestellt. Dabei wird die horizontale Koordinate mit der Ansichtsbreite skaliert; für die vertikale Position wird der Wert invertiert, weil die Koordinaten des Trackpads und der SwiftUI-Ansicht unterschiedlich ausgerichtet sind.
Die Ansicht setzt `allowedTouchTypes` auf indirekte Berührungen und aktiviert `wantsRestingTouches`. Der Artikel erklärt, dass damit auch ruhende Finger, etwa ein auf dem Trackpad abgelegter Daumen, berücksichtigt werden können. Der Autor berichtet allerdings, dass er bei aktiviertem `wantsRestingTouches` keine Berührungsbenachrichtigungen erhält, auch nicht bei einem Force-Klick. Er kennzeichnet diese Beobachtung als seinen Kenntnisstand.
Der Bericht begründet außerdem, warum die Verarbeitung über Berührungsereignisse erfolgt: Ein Versuch, die Trackpad-Berührungen anhand von Mausereignissen wie `mouseDown` auszuwerten, führte laut Autor beim Zugriff auf die Touch-Daten zu einer Ausnahme und zum Absturz. Auch `location(in:)` sei für diesen `NSTouch`-Typ nicht verfügbar und löse ebenfalls eine Ausnahme aus. Stattdessen nutzt die Implementierung `normalizedPosition`, einen Wert zwischen null und eins, dessen Ursprung laut Artikel links unten auf dem Touch-Gerät liegt.
Als Alternative stellt der Autor einen SwiftUI-Ansatz mit `NSEvent.addLocalMonitorForEvents` vor. Er verwendet dafür die Ereignismaske `.gesture` und fragt Touches ohne konkrete Zielansicht ab. In einem einfachen Aufbau, in dem die SwiftUI-Ansicht das einzige App-Fenster bildet, beobachtet der Autor ein ähnliches Verhalten wie mit `NSView`. Er nennt jedoch Grenzen: Für indirekte Berührungen gebe es keine spezialisierte Ereignismaske; `.gesture` sei offenbar die allgemeine verfügbare Option. Mögliche Sonderfälle schließt er nicht aus. Außerdem werden bei der Abfrage mit `nil` laut Artikel alle Berührungen unabhängig davon erfasst, welcher Ansicht sie zugeordnet sind. Der Mauszeiger muss sich zudem innerhalb der `NSView` befinden, damit diese Touch-Ereignisse erhält. Der Beitrag liefert Beispielcode und eine Animation, berichtet aber keine systematische Prüfung über unterschiedliche Konfigurationen oder Geräte hinweg.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Zusammenfassungen von Luna (kurz und mittel) wurden geprüft; die mittlere ist die vollständigere und wurde als Maßstab für Treue und Lücken genutzt. Die Angabe, die Beobachtung zu wantsRestingTouches sei „nach seiner Beobachtung“, ist nur eine leichte Verschiebung, da der Autor sich auf sein Wissen stützt. Die Einordnungsabschnitte von Luna enthielten keine Fragen (je „(keine)“), daher gibt es keine Einordnungen.
Im Bericht, aber nicht in der Zusammenfassung
- Motivation des Autors: touchesBegan und touchesMoved reagieren schon auf bloßes Auflegen des Fingers, deshalb sucht er nach Mausereignissen
- Konfiguration allowedTouchTypes mit indirect und der Standardwert von wantsRestingTouches (false)
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.