Touchgeräte

Android unterstützt eine Vielzahl von Touchscreens und Touchpads, einschließlich Stift-basierter Eingabetablets.

Touchscreens sind Touchgeräte, die mit einem Display verknüpft sind, sodass hat der Nutzer den Eindruck, Elemente auf dem Bildschirm direkt zu manipulieren.

Touchpads sind Touchscreens, die keinem Display zugeordnet sind, z. B. Digitizer-Tablet. Touchpads werden in der Regel verwendet, absolute indirekte Positionierung oder gestenbasierte Steuerung einer Benutzeroberfläche.

Touchgeräte können Tasten haben, die ähnlich wie Maustasten funktionieren.

Je nach Touchsensortechnologie können Touchgeräte manchmal mit einer Vielzahl verschiedener Tools wie Fingern oder einem Eingabestift manipuliert werden.

Touchbildschirme werden manchmal zur Implementierung virtueller Tasten verwendet. Bei einigen Android-Geräten reicht der Touchscreen-Sensorbereich beispielsweise über den Rand des Displays hinaus und dient als Touchbedienung für eine Tastatur.

Aufgrund der großen Vielfalt an Touchgeräten verwendet Android eine große Anzahl von Konfigurationseigenschaften, um die Eigenschaften und das gewünschte Verhalten jedes Geräts zu beschreiben.

Klassifizierung von Touch-Geräten

Ein Eingabegerät wird als Multitouch-Gerät klassifiziert, wenn beide der folgenden Bedingungen erfüllt sind:

  • Das Eingabegerät meldet die Anwesenheit der absoluten Achsen ABS_MT_POSITION_X und ABS_MT_POSITION_Y.
  • Das Eingabegerät hat keine Gamepad-Tasten. Diese Bedingung löst eine Ambiguität mit bestimmten Gamepads, die Achsen mit Codes melden die sich mit denen der MT-Achsen überschneidet.

Ein Eingabegerät wird als Ein-Finger-Gerät klassifiziert, wenn beide der folgenden Bedingungen erfüllt sind:

  • Das Eingabegerät ist nicht als Multi-Touch-Gerät klassifiziert. Ein Eingabegerät wird entweder als Gerät mit Ein- oder als Gerät mit Mehrfachberührung klassifiziert, niemals als beides.
  • Das Eingabegerät meldet die Anwesenheit der absoluten Achsen ABS_X und ABS_Y sowie des Schlüsselcodes BTN_TOUCH.

Wenn ein Eingabegerät als Touch-Gerät klassifiziert wird, der virtuellen Schlüssel wird ermittelt, indem versucht wird, die Datei mit der virtuellen Schlüsselzuordnung zu laden. für das Gerät. Wenn eine virtuelle Tastenbelegung verfügbar ist, für das Gerät geladen ist. Weitere Informationen finden Sie unter [Virtual Key Map-Dateien](#virtual-key-map-files) finden Sie Informationen zum Speicherort und Format dieser Dateien.

Als Nächstes lädt das System die Konfigurationsdatei des Eingabegeräts für das Touchgerät.

Alle Geräte mit Touchscreen sollten Konfigurationsdateien für Eingabegeräte haben. Wenn keine Konfigurationsdatei für das Eingabegerät vorhanden ist, wählt das System eine Standardkonfiguration aus, die für Touch-Peripheriegeräte wie externe USB- oder Bluetooth-HID-Touchscreens oder Touchpads geeignet ist. Diese Standardeinstellungen sind nicht für integrierte Touchscreens und zu Fehlverhalten führen kann.

Nachdem die Konfiguration des Eingabegeräts geladen wurde, klassifiziert das System das Eingabegerät als Touchscreen, Touchpad oder Maus.

  • Mit einem Touchscreen lassen sich Objekte direkt auf dem Bildschirm. Der Nutzer berührt den Bildschirm direkt, sodass das System erfordern zusätzliche Angebote, um die Objekte anzuzeigen, manipuliert werden.
  • Ein Touchpad wird verwendet, um Informationen zur absoluten Position bereitzustellen an eine App über Berührungen eines bestimmten Sensorbereichs. Sie kann für Tablet-Zeichner nützlich sein.
  • Ein Zeiger wird zur indirekten Manipulation von Objekten auf dem Bildschirm mithilfe eines Cursors verwendet. Finger werden als Multi-Touch-Gesten interpretiert. Andere Tools wie Eingabestifte werden anhand von absoluten Positionen interpretiert. Weitere Informationen finden Sie unter Indirekter Multi-Touch-Cursor .

Anhand der folgenden Regeln wird das Eingabegerät als Touchscreen, Touchpad oder Zeigegerät klassifiziert.

  • Wenn die Property touch.deviceType festgelegt ist, wird der Gerätetyp wie angegeben festgelegt.
  • Wenn das Eingabegerät das Vorhandensein von INPUT_PROP_DIRECT meldet (über die ioctl-Datei EVIOCGPROP) übergeben wird, lautet der Gerätetyp auf Touchscreen eingestellt ist. Bei dieser Bedingung wird davon ausgegangen, dass Geräte mit direkter Eingabe per Touchscreen an ein Display angeschlossen sind, das ebenfalls verbunden ist.
  • Wenn das Eingabegerät die INPUT_PROP_POINTER-Eingabeeigenschaft (über die EVIOCGPROP-ioctl) meldet, wird der Gerätetyp auf pointer gesetzt.
  • Wenn das Eingabegerät die relativen Achsen REL_X oder REL_Y meldet, wird der Gerätetyp auf Touchpad festgelegt. Mit dieser Bedingung wird eine Unklarheit bei Eingabegeräten behoben, die sowohl aus einer Maus als auch aus einem Touchpad bestehen. In diesem Fall wird das Touchpad nicht zur Steuerung da sie bereits mit der Maus gesteuert wird.
  • Andernfalls wird der Gerätetyp auf Zeiger eingestellt. Mit dieser Standardeinstellung wird sichergestellt, Touchpads, die keinem anderen Zweck dienen, den Zeiger steuern.

Tasten

Schaltflächen sind optionale Steuerelemente, mit denen Apps zusätzliche Funktionen ausführen können. Schaltflächen auf Touchbildschirmen funktionieren ähnlich wie Mausschaltflächen und werden hauptsächlich mit Touchbildschirmen vom Zeigertyp oder mit einem Eingabestift verwendet.

Die folgenden Schaltflächen werden unterstützt:

  • BTN_LEFT: Zugeordnet zu MotionEvent.BUTTON_PRIMARY.
  • BTN_RIGHT: Zugeordnet zu MotionEvent.BUTTON_SECONDARY.
  • BTN_MIDDLE: Zugewiesen zu MotionEvent.BUTTON_MIDDLE.
  • BTN_BACK und BTN_SIDE: Zugewiesen zu MotionEvent.BUTTON_BACK. Durch Drücken dieser Taste wird auch eine Tastenaktivierung mit dem Tastencode KeyEvent.KEYCODE_BACK simuliert.
  • BTN_FORWARD und BTN_EXTRA: zugeordnet zu MotionEvent.BUTTON_FORWARD Durch Drücken dieser Taste wird auch ein Tastendruck erzeugt. mit dem Schlüsselcode KeyEvent.KEYCODE_FORWARD.
  • BTN_STYLUS: Zugeordnet zu MotionEvent.BUTTON_SECONDARY.
  • BTN_STYLUS2: Zugewiesen zu MotionEvent.BUTTON_TERTIARY.

Tools und Tooltypen

Ein Tool ist ein Finger, ein Eingabestift oder ein anderes Gerät, das zur Interaktion mit das Touch-Gerät. Einige Touch-Geräte können zwischen verschiedenen Tooltypen unterscheiden.

In anderen Android-Bereichen, wie in der MotionEvent API, wird ein Tool oft als Zeiger bezeichnet.

Die folgenden Tooltypen werden unterstützt:

  • BTN_TOOL_FINGER und MT_TOOL_FINGER: Zugewiesen zu MotionEvent.TOOL_TYPE_FINGER.
  • BTN_TOOL_PEN und MT_TOOL_PEN: zugeordnet zu MotionEvent.TOOL_TYPE_STYLUS
  • BTN_TOOL_RUBBER: Zugeordnet zu MotionEvent.TOOL_TYPE_ERASER.
  • BTN_TOOL_BRUSH: Zugeordnet zu MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_PENCIL: Zugewiesen zu MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_AIRBRUSH: Zugewiesen zu MotionEvent.TOOL_TYPE_STYLUS.
  • BTN_TOOL_MOUSE: Zugeordnet zu MotionEvent.TOOL_TYPE_MOUSE.
  • BTN_TOOL_LENS: Zugewiesen zu MotionEvent.TOOL_TYPE_MOUSE.
  • BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP und BTN_TOOL_QUADTAP: Zugeordnet zu MotionEvent.TOOL_TYPE_FINGER.

Tools für Mausbewegungen und Berührungen

Tools können entweder in Kontakt mit dem Touchgerät sein oder sich in Reichweite befinden und den Mauszeiger darauf bewegen darüber. Nicht alle Touchbildschirme können erkennen, wenn ein Tool über dem Touchbildschirm schwebt. Geräte, die das tun, z. B. RF-basierte Eingabestift-Digitizer, können oft erkennen, wenn sich das Tool in einem begrenzten Bereich des Digitizers befindet.

Die InputReader-Komponente unterscheidet Touch-Tools von Hover-Tools. Ebenso werden Touch-Tools und Hover-Tools Apps auf unterschiedliche Weise gemeldet.

Berührungstools werden Apps als Berührungsereignisse mit MotionEvent.ACTION_DOWN, MotionEvent.ACTION_MOVE, MotionEvent.ACTION_DOWN, MotionEvent.ACTION_POINTER_DOWN und MotionEvent.ACTION_POINTER_UP gemeldet.

Hovering-Tools werden Apps als generische Bewegungsereignisse mit MotionEvent.ACTION_HOVER_ENTER, MotionEvent.ACTION_HOVER_MOVE und MotionEvent.ACTION_HOVER_EXIT gemeldet.

Treiberanforderungen für Touch-Geräte

  • Touch-Gerätetreiber sollten nur die Achsen und Tastencodes für die unterstützten Achsen und Tasten registrieren. Die Registrierung nicht unterstützter Achsen oder Tastencodes kann den Algorithmus zur Geräteklassifizierung verwirren oder dazu führen, dass das System die Funktionen des Geräts falsch erkennt. Wenn das Gerät beispielsweise den Tastencode BTN_TOUCH meldet, geht das System davon aus, dass BTN_TOUCH immer verwendet wird, um anzugeben, ob das Tool den Bildschirm berührt. Daher sollte BTN_TOUCH nicht verwendet werden, um anzugeben, dass sich das Tool nur im Bereich befindet und schwebt.
  • Auf Geräten mit einer einzelnen Berührung werden die folgenden Linux-Eingabeereignisse verwendet:
    • ABS_X: (ERFORDERLICH) gibt die X-Koordinate des Tools an.
    • ABS_Y: (ERFORDERLICH) Die Y-Koordinate des Tools.
    • ABS_PRESSURE: Optional: Gibt den physischen Druck an, der auf die Spitze des Tools ausgeübt wird, oder die Signalstärke des Touchkontakts.
    • ABS_TOOL_WIDTH: (optional) Gibt die Querschnittsfläche oder Breite von des Berührungskontakts oder des Werkzeugs selbst.
    • ABS_DISTANCE: Optional. Gibt den Abstand des Tools von der Oberfläche des Touch-Geräts an.
    • ABS_TILT_X: Optional: Gibt die Neigung des Tools von der Oberfläche des Touch-Geräts entlang der X-Achse an.
    • ABS_TILT_Y: (optional) Gibt die Neigung des Tools von der Oberfläche von das Touchgerät entlang der Y-Achse an.
    • BTN_TOUCH: (ERFORDERLICH) gibt an, ob das Tool den .
    • BTN_LEFT, BTN_RIGHT, BTN_MIDDLE, BTN_BACK, BTN_SIDE, BTN_FORWARD, BTN_EXTRA, BTN_STYLUS, BTN_STYLUS2: (optional) Status der Schaltfläche „Berichte“.
    • BTN_TOOL_FINGER, BTN_TOOL_PEN, BTN_TOOL_RUBBER BTN_TOOL_BRUSH, BTN_TOOL_PENCIL, BTN_TOOL_AIRBRUSH BTN_TOOL_MOUSE, BTN_TOOL_LENS BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP: (optional) Gibt den Tooltyp an.
  • Multi-Touch-Geräte verwenden die folgenden Linux-Eingabeereignisse:
    • ABS_MT_POSITION_X: (ERFORDERLICH) gibt die X-Koordinate des Tools an.
    • ABS_MT_POSITION_Y: (ERFORDERLICH) Die Y-Koordinate des Tools.
    • ABS_MT_PRESSURE: Optional: Gibt den physischen Druck an, der auf die Spitze des Tools ausgeübt wird, oder die Signalstärke des Touchkontakts.
    • ABS_MT_TOUCH_MAJOR: Optional Gibt den Querschnitt des Touchkontakts oder die Länge der längeren Dimension des Touchkontakts an.
    • ABS_MT_TOUCH_MINOR: (optional) Gibt die Länge der kürzeren Dimension an des Touch-Kontakts. Diese Achse sollte nicht verwendet werden, wenn ABS_MT_TOUCH_MAJOR eine Flächenmessung enthält.
    • ABS_MT_WIDTH_MAJOR: Optional. Gibt den Querschnitt des Werkzeugs selbst oder die Länge der längeren Dimension des Werkzeugs an. Diese Achse nicht verwenden wenn Sie die Abmessungen des Tools selbst kennen.
    • ABS_MT_WIDTH_MINOR: Optional: Gibt die Länge der kürzeren Dimension des Tools an. Diese Achse sollte nicht verwendet werden, wenn ABS_MT_WIDTH_MAJOR Berichte erstellt eine Flächenmessung oder die Abmessungen des Tools selbst sind unbekannt.
    • ABS_MT_ORIENTATION: (optional) Gibt die Ausrichtung des Tools an.
    • ABS_MT_DISTANCE: Optional. Gibt den Abstand des Tools zur Oberfläche des Touch-Geräts an.
    • ABS_MT_TOOL_TYPE: (optional) Meldet die Tooltyp als MT_TOOL_FINGER oder MT_TOOL_PEN.
    • ABS_MT_TRACKING_ID: Optional: Die Tracking-ID des Tools. Die Tracking-ID ist eine beliebige nicht negative Ganzzahl, die zur Identifizierung und verfolgen jedes Tool einzeln, wenn mehrere Tools aktiv sind. Wenn beispielsweise mehrere Finger das Gerät berühren, sollte jedem Finger eine eindeutige Tracking-ID zugewiesen werden, die verwendet wird, solange der Finger in Kontakt bleibt. Tracking-IDs können wiederverwendet werden, wenn sich die zugehörigen Tools außerhalb der Reichweite befinden.
    • ABS_MT_SLOT: Optional: Gibt die Steckplatz-ID des Tools an, wenn das Linux-Multitouch-Protokoll „B“ verwendet wird. Weitere Informationen finden Sie in der Dokumentation zum Linux Multi-Touch-Protokoll. .
    • BTN_TOUCH: (ERFORDERLICH) gibt an, ob das Tool den .
    • BTN_LEFT, BTN_RIGHT, BTN_MIDDLE, BTN_BACK, BTN_SIDE, BTN_FORWARD, BTN_EXTRA, BTN_STYLUS, BTN_STYLUS2: (optional) Status der Schaltfläche „Berichte“.
    • BTN_TOOL_FINGER, BTN_TOOL_PEN, BTN_TOOL_RUBBER, BTN_TOOL_BRUSH, BTN_TOOL_PENCIL, BTN_TOOL_AIRBRUSH, BTN_TOOL_MOUSE, BTN_TOOL_LENS, BTN_TOOL_DOUBLETAP, BTN_TOOL_TRIPLETAP, BTN_TOOL_QUADTAP: (optional) Gibt den Tool-Typ an.
  • Wenn Achsen für das Single-Touch- und das Multi-Touch-Protokoll definiert sind, gilt: werden nur die Multi-Touch-Achsen verwendet und die Single-Touch-Achsen werden ignoriert.

  • Die Minimal- und Maximalwerte von ABS_X, ABS_Y, ABS_MT_POSITION_X, Die Achsen ABS_MT_POSITION_Y definieren die Grenzen des aktiven Bereichs des Geräts. in gerätespezifischen Oberflächeneinheiten. Bei einem Touchscreen bezeichnet der aktive Bereich den Teil des Touchgeräts, der tatsächlich das Display bedeckt.

    Bei einem Touchscreen interpoliert das System die gemeldete Berührung automatisch. Positionen in Oberflächeneinheiten, um Berührungspositionen in Displaypixeln entsprechend zur Berechnung hinzu:

        displayX = (x - minX) * displayWidth / (maxX - minX + 1)
    displayY = (y - minY) * displayHeight / (maxY - minY + 1)

    Ein Touchscreen meldet möglicherweise Berührungen außerhalb des gemeldeten aktiven Bereichs.

    Berührungen, die außerhalb des aktiven Bereichs gestartet werden, werden nicht an Apps gesendet, können aber für virtuelle Tasten verwendet werden.

    Berührungen, die innerhalb des aktiven Bereichs initiiert werden, oder die den Bildschirm betreten und verlassen Bereich an Apps gesendet werden. Wenn also eine Berührung innerhalb der und bewegt sich dann aus dem aktiven Bereich, kann Touch-Ereignisse mit Anzeigekoordinaten empfangen, die negativ oder jenseits der Anzeigegrenzen. Das ist ganz normal.

    Die Touch-Koordinaten eines Touch-Geräts dürfen niemals an den Grenzen des aktiven Bereichs eingeklemmt werden. Wenn ein Touch den aktiven Bereich verlässt, sollte er als außerhalb des aktiven Bereichs gemeldet werden oder gar nicht gemeldet werden.

    Berührt der Nutzer beispielsweise den Finger in die obere linke Ecke der Touchscreen wird möglicherweise eine Koordinate von (minX, minY) gemeldet. Wenn der Finger weiterhin auf dem Display erscheint um sich weiter außerhalb des aktiven Bereichs zu bewegen, sollte der Touchscreen entweder mit Komponenten, die kleiner als minX und minY sind, z. B. (MinX – 2, MinY – 3), andernfalls wird die Berührung nicht mehr gemeldet. Mit anderen Worten, der Touchscreen sollte keine Berichte liefern (minX, minY). wenn der Finger der Nutzenden außerhalb des aktiven Bereichs berührt.

    Wenn Touch-Koordinaten am Displayrand begrenzt werden, wird eine künstliche harte Grenze um den Displayrand herum erstellt, die verhindert, dass das System Bewegungen flüssig verfolgen kann, die den Displaybereich betreten oder verlassen.

  • Die von ABS_PRESSURE oder ABS_MT_PRESSURE gemeldeten Werte, falls sie gemeldet werden. Der Wert muss ungleich null sein, wenn das Gerät das Gerät berührt. und Null, um anzuzeigen, dass sich das Tool befindet.

    Das Melden von Druckinformationen ist optional, wird aber dringend empfohlen. Apps können Druckinformationen verwenden, um druckempfindliches Zeichnen zu implementieren und andere Effekte.

  • Die Werte von ABS_TOOL_WIDTH, ABS_MT_TOUCH_MAJOR, ABS_MT_TOUCH_MINOR, ABS_MT_WIDTH_MAJOR oder ABS_MT_WIDTH_MINOR sollten nicht null sein, wenn das Tool das Gerät berührt, andernfalls null. Dies ist jedoch nicht erforderlich. Das Touchgerät kann beispielsweise die Größe von Fingerkontakten messen, aber nicht von Eingabestiftkontakten.

    Informationen zur Größe von Berichten sind optional, werden aber dringend empfohlen. Apps können Druckinformationen nutzen, um größenabhängige Zeichnungen zu implementieren und andere Effekte.

  • Die von ABS_DISTANCE oder ABS_MT_DISTANCE gemeldeten Werte sollten gegen Null gehen, wenn das Tool das Gerät berührt. Der Abstand kann auch dann ungleich Null bleiben, wenn das Werkzeug in direktem Kontakt ist. Die genauen gemeldeten Werte hängen davon ab, wie die Hardware Entfernungen misst.

    Die Angabe von Informationen zur Entfernung ist optional, wird aber für Geräte mit Eingabestift empfohlen.

  • Die von ABS_TILT_X und ABS_TILT_Y gemeldeten Werte sollten null sein, wenn das Tool senkrecht zum Gerät gehalten wird. Eine Neigung ungleich null bedeutet, dass das Werkzeug an einer Steigung gehalten wird.

    Es wird angenommen, dass die Neigungswinkel entlang der X- und Y-Achse in Grad angegeben sind. von der senkrechten Position ab. Der Mittelpunkt (perfekt senkrecht) wird für jede Achse durch (max + min) / 2 angegeben. Werte, die kleiner als der Mittelpunkt sind, stehen für eine Neigung nach oben oder links, Werte, die größer als der Mittelpunkt sind, für eine Neigung nach unten oder rechts.

    InputReader wandelt die Neigungskomponenten X und Y in einen senkrechten Neigungswinkel von 0 bis PI / 2 Radianten und einen ebenen Orientierungswinkel von -PI bis PI Radianten um. Diese Darstellung führt zu einer Beschreibung der Ausrichtung, die mit der Beschreibung von Fingerberührungen kompatibel ist.

    Die Angabe von Neigungsinformationen ist optional, wird aber für Eingabestift-Geräte empfohlen.

  • Wenn der Tooltyp von ABS_MT_TOOL_TYPE gemeldet wird, ersetzt er alle Informationen zum Tooltyp, die von BTN_TOOL_* gemeldet wurden. Wenn keine Informationen zum Werkzeugtyp verfügbar sind, wird standardmäßig MotionEvent.TOOL_TYPE_FINGER verwendet.

  • Ein Tool wird anhand der folgenden Bedingungen als aktiv eingestuft:

    • Bei Verwendung des Protokolls für die einmalige Berührung ist das Tool aktiv, wenn BTN_TOUCH oder BTN_TOOL_* den Wert 1 hat.

      Diese Bedingung impliziert, dass InputReader mindestens einige Informationen über die Beschaffenheit des Tools, sei es ein Berühren, oder zumindest den Tool-Typ. Wenn keine Informationen verfügbar sind, wird davon ausgegangen, dass das Tool inaktiv ist (außerhalb des zulässigen Bereichs).

    • Wenn Sie das Multi-Touch-Protokoll „A“ verwenden, ist das Tool immer dann aktiv, wird im neuesten Synchronisierungsbericht angezeigt. Wenn das Tool nicht mehr in den Synchronisierungsberichten angezeigt wird, ist es nicht mehr verfügbar.
    • Bei Verwendung des Multi-Touch-Protokolls „B“ ist das Tool aktiv, es eine aktive Anzeigenfläche hat. Nachdem die Anzeigenfläche gelöscht wurde, ist das Werkzeug nicht mehr vorhanden.
  • Ein Tool wird anhand der folgenden Bedingungen als schwebend erkannt:
    • Wenn das Tool den Status BTN_TOOL_MOUSE oder BTN_TOOL_LENS hat, sich nicht bewegt, auch wenn eine der folgenden Bedingungen erfüllt ist.
    • Wenn das Tool aktiv ist und der Fahrer den Druck meldet, und der gemeldete Druck gleich null ist, bewegt sich das Tool.
    • Wenn das Tool aktiv ist, der Treiber den Tastencode BTN_TOUCH unterstützt und BTN_TOUCH den Wert 0 hat, schwebt das Tool.
  • InputReader unterstützt sowohl das Multi-Touch-Protokoll A und 'B'. Neue Treiber das „B“ Beides funktioniert.

  • Ab Android 4.0 müssen die Touchscreen-Treiber möglicherweise geändert werden, um der Linux-Eingabeprotokollspezifikation zu entsprechen.

    Möglicherweise sind folgende Änderungen erforderlich:

    • Wenn ein Tool inaktiv wird (Finger wird „hoch“ bewegt), sollte es in nachfolgenden Multitouch-Synchronisierungsberichten nicht mehr angezeigt werden. Wenn alle Tools inaktiv sind (alle Finger werden „hoch“ gehalten), sollte der Fahrer ein leeres Synchronisierungsberichtspaket senden, z. B. SYN_MT_REPORT gefolgt von SYN_REPORT.

      In früheren Android-Versionen wurden „Hoch“-Ereignisse durch Senden eines Druckwerts von 0 gemeldet. Das alte Verhalten war nicht kompatibel mit dem Die Linux-Eingabeprotokollspezifikation und wird nicht mehr unterstützt.

    • Informationen zum physischen Druck oder zur Signalstärke sollten mit ABS_MT_PRESSURE

      In früheren Android-Versionen wurden Druckinformationen von ABS_MT_TOUCH_MAJOR abgerufen. Das alte Verhalten war nicht mit der Linux-Eingabeprotokollspezifikation kompatibel und wird nicht mehr unterstützt.

    • Informationen zur Größe des Touchbildschirms sollten mit ABS_MT_TOUCH_MAJOR angegeben werden.

      In früheren Android-Versionen wurden Größeninformationen aus ABS_MT_TOOL_MAJOR abgerufen. Das alte Verhalten war nicht mit der Linux-Eingabeprotokollspezifikation kompatibel und wird nicht mehr unterstützt.

    Treiber für Touch-Geräte erfordern keine Android-spezifischen Anpassungen mehr. Da Android das Standard-Eingabeprotokoll von Linux verwendet, kann es mithilfe von unveränderten Treibern eine größere Vielfalt an Touch-Peripheriegeräten wie externe HID-Multi-Touch-Touchscreens unterstützen.

Bedienung per Touchscreen

Nachfolgend finden Sie eine kurze Zusammenfassung der Funktionsweise des Touch-Geräts unter Android.

  1. EventHub liest Rohereignisse aus dem evdev-Treiber.
  2. InputReader verarbeitet die Rohereignisse und aktualisiert den internen Status zu die Position und andere Merkmale der einzelnen Tools. Außerdem werden die Schaltflächenstatus erfasst.
  3. Wenn ZURÜCK oder VORAUS gedrückt oder losgelassen wurde, benachrichtigt InputReader InputDispatcher über das Schlüsselereignis.
  4. InputReader gibt an, ob eine virtuelle Tastenpresseung stattgefunden hat. Ist das der Fall, wird InputDispatcher über das Schlüsselereignis benachrichtigt.
  5. InputReader bestimmt, ob die Berührung innerhalb des Anzeigegrenzen. In diesem Fall benachrichtigt er InputDispatcher über das Touch-Ereignis.
  6. Wenn sich keine Werkzeuge befinden, die sich berühren, aber mindestens ein Werkzeug vorhanden ist, das sich bewegt, InputReader benachrichtigt InputDispatcher über das Hover-Ereignis.
  7. Wenn das Touchgerät vom Typ Zeiger ist, führt InputReader einen Zeiger aus Bewegungserkennung, bewegt den Zeiger und erkennt entsprechend InputDispatcher zum Zeigerereignis.
  8. InputDispatcher verwendet WindowManagerPolicy, um zu bestimmen, sollten die Ereignisse ausgelöst werden und ob der Ruhemodus des Geräts beendet werden soll. Anschließend sendet InputDispatcher die Ereignisse an die entsprechenden Apps.

Konfiguration des Touch-Geräts

Das Verhalten des Touch-Geräts wird durch die Achsen, Tasten, Eingabeeigenschaften Konfiguration der Eingabegeräte, virtuelle Tastenbelegung und Tastenlayout.

In den folgenden Abschnitten finden Sie weitere Informationen zu den Dateien, die an der Tastaturkonfiguration teilnehmen:

Properties

Das System verwendet viele Konfigurationseigenschaften für Eingabegeräte, um das Verhalten von Touchgeräten zu konfigurieren und zu kalibrieren.

Ein Grund dafür ist, dass die Gerätetreiber für Touch-Geräte die Eigenschaften von Berührungen oft in gerätespezifischen Einheiten melden.

Viele Touchbedienungen messen beispielsweise die Berührungsfläche mithilfe einer internen gerätespezifischen Skala, z. B. der Gesamtzahl der Sensorknoten, die durch die Berührung ausgelöst wurden. Dieser Rohgrößenwert würde sind für Apps nicht von Bedeutung, da sie wissen müssen, physische Größe und andere Eigenschaften der Sensorknoten des Touchgeräts

Das System verwendet Kalibrierungsparameter, die in Konfigurationsdateien des Eingabegeräts codiert sind, um die vom Touchgerät gemeldeten Werte in eine einfachere Standarddarstellung zu decodieren, zu transformieren und zu normalisieren, die von Apps verstanden werden kann.

Konventionen für die Dokumentation

Zu Dokumentationszwecken verwenden wir die folgenden Konventionen, um die vom System während des Kalibrierungsvorgangs verwendeten Werte.

Rohe Achsenwerte

Die folgenden Ausdrücke stehen für die unverarbeiteten Werte, die durch die Berührung gemeldet werden. Gerätetreiber als EV_ABS-Ereignisse.

raw.x
Der Wert der ABS_X- oder ABS_MT_POSITION_X-Achse.
raw.y
Der Wert der ABS_Y- oder ABS_MT_POSITION_Y-Achse.
raw.pressure
Der Wert der ABS_PRESSURE- oder ABS_MT_PRESSURE-Achse oder „0“, wenn nicht verfügbar.
raw.touchMajor
Der Wert der ABS_MT_TOUCH_MAJOR-Achse oder 0, falls nicht verfügbar.
raw.touchMinor
Der Wert der ABS_MT_TOUCH_MINOR-Achse oder raw.touchMajor, falls nicht verfügbar.
raw.toolMajor
Der Wert der ABS_TOOL_WIDTH- oder ABS_MT_WIDTH_MAJOR-Achse oder „0“, wenn nicht verfügbar.
raw.toolMinor
Der Wert der ABS_MT_WIDTH_MINOR-Achse oder raw.toolMajor, falls nicht verfügbar.
raw.orientation
Der Wert der ABS_MT_ORIENTATION-Achse oder „0“, wenn nicht verfügbar.
raw.distance
Der Wert der Achse ABS_DISTANCE oder ABS_MT_DISTANCE oder 0, falls nicht verfügbar.
raw.tiltX
Der Wert der ABS_TILT_X-Achse oder „0“, wenn nicht verfügbar.
raw.tiltY
Der Wert der ABS_TILT_Y-Achse oder „0“, wenn nicht verfügbar.

Rohachsenbereiche

Die folgenden Ausdrücke geben die Grenzen von Rohwerten an. Sie erhalten indem Sie für jede Achse EVIOCGABS ioctl aufrufen.

raw.*.min
Der inklusive Minimalwert der Rohachse.
raw.*.max
Der maximale Wert der Rohachse (einschließlich).
raw.*.range
Entspricht raw.*.max - raw.*.min.
raw.*.fuzz
Genauigkeit der Rohachse. z. B. „fuzz = 1“ bedeutet, dass die Werte auf +/- 1 Einheit genau sind.
raw.width
Die einschließlich der Breite des Touchbereichs, entspricht raw.x.range + 1.
raw.height
Die Gesamthöhe des Touchbereichs, entspricht raw.y.range + 1.

Ausgabebereiche

Die folgenden Ausdrücke geben die Eigenschaften des Ausgabekoordinatensystems an. Das System nutzt die lineare Interpolation, um Informationen zur Berührungsposition die vom Touch-Gerät verwendeten Oberflächeneinheiten in die Ausgabeeinheiten, die an Apps gemeldet werden, z. B. Displaypixel.

output.width
Die Breite der Ausgabe. Bei Touchscreens (die mit einem Display verknüpft sind) ist dies die Displaybreite in Pixeln. Für Touchpads (nicht mit einem Display verknüpft): die Ausgabebreite gleich raw.width ist, was bedeutet, dass keine Interpolation ausgeführt wird.
output.height
Die Ausgabehöhe. Bei Touchscreens (mit einem Display verknüpft) ist dies die Displayhöhe in Pixeln. Für Touchpads (nicht mit einem Display verknüpft): die Ausgabehöhe gleich raw.height ist, was bedeutet, dass keine Interpolation durchgeführt haben.
output.diag
Die diagonale Länge des Ausgabekoordinatensystems, entspricht der sqrt(output.width ^2 + output.height ^2).

Grundlegende Konfiguration

Der Touch-Eingabe-Mapper verwendet viele Konfigurationseigenschaften in der Konfigurationsdatei des Eingabegeräts, um Kalibrierungswerte anzugeben. In der folgenden Tabelle wird beschrieben, einige allgemeine Konfigurationseigenschaften. Alle anderen Eigenschaften werden in den folgenden Abschnitten zusammen mit den Feldern beschrieben, mit denen sie kalibriert werden.

touch.deviceType

Definition: touch.deviceType = touchScreen | touchPad | pointer | default

Gibt den Typ des Touch-Geräts an.

  • Wenn der Wert touchScreen ist, ist das Touchgerät ein Touchscreen, der mit einem Display.

  • Wenn der Wert touchPad ist, ist das Touch-Gerät ein Touchpad, das nicht mit mit einem Display.

  • Wenn der Wert pointer ist, handelt es sich beim Touchgerät um ein Touchpad, das nicht mit einem Display verknüpft ist. Die Bewegungen werden für indirekte Multi-Touch-Mauszeigergesten verwendet.

  • Wenn der Wert default ist, erkennt das System den Gerätetyp automatisch anhand des Klassifizierungsalgorithmus.

Weitere Informationen finden Sie im Abschnitt Klassifizierung. wie sich der Gerätetyp auf das Verhalten des Touchgeräts auswirkt.

Unter Android 3 und niedriger wurde angenommen, dass es sich bei allen Touchscreen-Geräten um Touchscreens handelt.

touch.orientationAware

Definition: touch.orientationAware = 0 | 1

Gibt an, ob das Touchgerät auf Änderungen der Displayausrichtung reagieren soll.

  • Wenn der Wert 1 ist, werden die vom Touchgerät gemeldeten Touch-Positionen gedreht, wenn sich die Displayausrichtung ändert.

  • Wenn der Wert 0 ist, sind die vom Touchgerät gemeldeten Touch-Positionen unabhängig von Änderungen der Displayausrichtung.

Der Standardwert ist 1, wenn es sich um ein Gerät mit Touchscreen handelt, andernfalls 0.

Das System unterscheidet zwischen internen und externen Touchscreens und Displays. Ein richtungsabhängiger interner Touchscreen wird entsprechend der Ausrichtung des internen Displays gedreht. Ein externer Touchscreen mit Ausrichtungserkennung wird gedreht basierend auf der Ausrichtung des externen Displays.

Die Ausrichtung wird verwendet, um die Drehung von Touchscreens auf Geräten wie dem Nexus One zu unterstützen. Wenn das Gerät beispielsweise um 90 Grad im Uhrzeigersinn von seiner natürlichen Ausrichtung gedreht wird, werden die absoluten Positionen von Berührungen neu zugeordnet, sodass eine Berührung in der linken oberen Ecke des absoluten Koordinatensystems des Touchscreens als Berührung in der linken oberen Ecke des gedrehten Koordinatensystems des Displays gemeldet wird. Dadurch werden Berührungen mit demselben Koordinatensystem erfasst, das Apps zum Zeichnen ihrer visuellen Elemente verwenden.

Vor Honeycomb wurde angenommen, dass alle Touchgeräte die Ausrichtung berücksichtigen.

touch.gestureMode

Definition: touch.gestureMode = pointer | spots | default

Gibt den Präsentationsmodus für Zeigefingergesten an. Diese Konfigurationseigenschaft ist nur relevant, wenn das Touchgerät vom Typ Zeiger ist.

  • Wenn der Wert pointer ist, werden die Touchpad-Gesten durch einen Cursor dargestellt, der einem Mauszeiger ähnelt.

  • Wenn der Wert spots ist, werden die Touchpad-Gesten durch einen Anker die den Schwerpunkt der Geste und eine Reihe kreisförmiger Punkte darstellt die die Position einzelner Finger darstellen.

Der Standardwert ist pointer, wenn das Eingabeattribut INPUT_PROP_SEMI_MT festgelegt ist, andernfalls spots.

Felder „X“ und „Y“

Die Felder X und Y enthalten Positionsinformationen für die Mitte des Kontaktbereichs.

Berechnung

Die Berechnung ist einfach: Positionsinformationen des Touch-Treibers linear mit dem Ausgabekoordinatensystem interpoliert wird.

xScale = output.width / raw.width
yScale = output.height / raw.height

If not orientation aware or screen rotation is 0 degrees:
output.x = (raw.x - raw.x.min) * xScale
output.y = (raw.y - raw.y.min) * yScale
Else If rotation is 90 degrees:
    output.x = (raw.y - raw.y.min) * yScale
    output.y = (raw.x.max - raw.x) * xScale
Else If rotation is 180 degrees:
    output.x = (raw.x.max - raw.x) * xScale
    output.y = (raw.y.max - raw.y) * yScale
Else If rotation is 270 degrees:
    output.x = (raw.y.max - raw.y) * yScale
    output.y = (raw.x - raw.x.min) * xScale
End If

Die Felder „touchMajor“, „touchMinor“, „toolMajor“, „toolMinor“ und „size“

Die Felder touchMajor und touchMinor beschreiben die ungefähren Abmessungen der Kontaktfläche in Ausgabeeinheiten (Pixeln).

Die Felder toolMajor und toolMinor beschreiben die ungefähren Abmessungen des Tools selbst in Ausgabeeinheiten (Pixeln).

Das Feld size beschreibt die normalisierte Größe des Touch-Ereignisses im Vergleich zum größten möglichen Touch-Ereignis, das das Touch-Gerät erkennen kann. Die kleinste mögliche normalisierte Größe ist 0,0 (kein Kontakt oder sie ist nicht messbar) und die größte mögliche normalisierte Größe bei 1,0 (Sensorbereich ist gesättigt).

Wenn sowohl die ungefähre Länge als auch die Breite gemessen werden können, Feld „touchMajor“ gibt die längere Dimension an und das Feld touchMinor gibt die kürzere Dimension an. des Kontaktbereichs. Wenn nur der ungefähre Durchmesser der Kontaktfläche gemessen werden kann, sind die Felder touchMajor und touchMinor gleich.

Ebenso werden mit dem Feld toolMajor die längere Dimension und der toolMinor gibt die kürzere Abmessung des Querschnittsbereichs des Tools an.

Wenn die Berührungsgröße nicht verfügbar ist, aber die Toolgröße verfügbar ist, wird die Toolgröße der Touchscreen-Größe entspricht. Wenn die Toolgröße nicht verfügbar ist, die Touch-Größe aber, wird die Touch-Größe auf die Toolgröße festgelegt.

Auf Touchbildschirmen werden die Größe des Touch-Ereignisses und die Größe des Tools auf unterschiedliche Weise gemessen oder erfasst. Die aktuelle Implementierung unterstützt drei verschiedene Arten von Messungen: Durchmesser, Fläche und geometrischer Markierungsrahmen in Flächeneinheiten.

Definition: touch.size.calibration = none | geometric | diameter | area | default

Gibt die Art der Messung an, die vom Touch-Treiber verwendet wird, um die Touch- und Tool-Größe zu melden.

  • Wenn der Wert none ist, wird die Größe auf null gesetzt.

  • Wenn der Wert geometric ist, wird angenommen, dass die Größe im selben Flächeneinheiten als Position, sodass sie auf die gleiche Weise skaliert wird.

  • Wenn der Wert diameter ist, wird davon ausgegangen, dass die Größe proportional zum Durchmesser (Breite) des Touch-Objekts oder Tools ist.

  • Wenn der Wert area ist, wird angenommen, dass die Größe proportional zur des Touchscreens oder des Tools.

  • Wenn der Wert default ist, verwendet das System die geometric-Kalibrierung, wenn der Die Achse raw.touchMajor oder raw.toolMajor ist verfügbar. Andernfalls wird verwendet. none-Kalibrierung.

touch.size.scale

Definition: touch.size.scale = <eine nicht negative Gleitkommazahl>

Gibt einen konstanten Skalierungsfaktor an, der für die Kalibrierung verwendet wird.

Der Standardwert ist 1.0.

touch.size.bias

Definition: touch.size.bias = <eine nicht negative Gleitkommazahl>

Gibt einen konstanten Biaswert an, der bei der Kalibrierung verwendet wird.

Der Standardwert ist 0.0.

touch.size.isSummed

Definition: touch.size.isSummed = 0 | 1

Gibt an, ob die Größe als Summe der Größen aller aktive Kontakte oder wird für jeden Kontakt einzeln gemeldet.

  • Wenn der Wert 1 ist, wird die gemeldete Größe durch die Anzahl der Kontakte vor der Verwendung geteilt.

  • Wenn der Wert 0 ist, wird die gemeldete Größe unverändert verwendet.

Der Standardwert ist 0.

Einige Touch-Geräte, insbesondere „Semi-MT“-Geräte, können die einzelnen Abmessungen mehrerer Kontakte nicht unterscheiden. Daher wird eine Größe angegeben, die die Gesamtfläche oder Breite darstellt. Diese Property sollte nur für solche Geräte auf 1 festgelegt werden. Legen Sie diesen Wert im Zweifelsfall auf 0 fest.

Berechnung

Die Berechnung der Felder touchMajor, touchMinor, toolMajor, toolMinor und size hängt von den angegebenen Kalibrierungsparametern ab.

If raw.touchMajor and raw.toolMajor are available:
    touchMajor = raw.touchMajor
    touchMinor = raw.touchMinor
    toolMajor = raw.toolMajor
    toolMinor = raw.toolMinor
Else If raw.touchMajor is available:
    toolMajor = touchMajor = raw.touchMajor
    toolMinor = touchMinor = raw.touchMinor
Else If raw.toolMajor is available:
    touchMajor = toolMajor = raw.toolMajor
    touchMinor = toolMinor = raw.toolMinor
Else
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
End If

size = avg(touchMajor, touchMinor)

If touch.size.isSummed == 1:
    touchMajor = touchMajor / numberOfActiveContacts
    touchMinor = touchMinor / numberOfActiveContacts
    toolMajor = toolMajor / numberOfActiveContacts
    toolMinor = toolMinor / numberOfActiveContacts
    size = size / numberOfActiveContacts
End If

If touch.size.calibration == "none":
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
Else If touch.size.calibration == "geometric":
    outputScale = average(output.width / raw.width, output.height / raw.height)
    touchMajor = touchMajor * outputScale
    touchMinor = touchMinor * outputScale
    toolMajor = toolMajor * outputScale
    toolMinor = toolMinor * outputScale
Else If touch.size.calibration == "area":
    touchMajor = sqrt(touchMajor)
    touchMinor = touchMajor
    toolMajor = sqrt(toolMajor)
    toolMinor = toolMajor
Else If touch.size.calibration == "diameter":
    touchMinor = touchMajor
    toolMinor = toolMajor
End If

If touchMajor != 0:
    output.touchMajor = touchMajor * touch.size.scale + touch.size.bias
Else
    output.touchMajor = 0
End If

If touchMinor != 0:
    output.touchMinor = touchMinor * touch.size.scale + touch.size.bias
Else
    output.touchMinor = 0
End If

If toolMajor != 0:
    output.toolMajor = toolMajor * touch.size.scale + touch.size.bias
Else
    output.toolMajor = 0
End If

If toolMinor != 0:
    output.toolMinor = toolMinor * touch.size.scale + touch.size.bias
Else
    output.toolMinor = 0
End If

output.size = size

Druckfeld

Im Feld pressure wird der ungefähre physische Druck angegeben, der auf den Touch-Gerät als normalisierter Wert zwischen 0,0 (keine Berührung) und 1,0 (Normaldruck).

Ein Nulldruck bedeutet, dass das Werkzeug schwebt.

touch.druck.kalibrierung

Definition: touch.pressure.calibration = none | physical | amplitude | default

Gibt die Art der Messung an, die vom Touch-Treiber verwendet wird, um den Druck zu melden.

  • Wenn der Wert none ist, ist der Druck unbekannt. Er wird dann auf 1,0 gesetzt, wenn der Finger auf das Display gedrückt wird, und auf 0,0, wenn der Finger nur darüber schwebt.

  • Wenn der Wert physical ist, wird angenommen, dass die Druckachse den tatsächlichen Wert der physischer Druck, der auf das Touchpad ausgeübt wird.

  • Wenn der Wert amplitude ist, wird davon ausgegangen, dass die Druckachse die Signalamplitude misst, die mit der Größe des Kontakts und dem ausgeübten Druck zusammenhängt.

  • Wenn der Wert default ist, verwendet das System die physical-Kalibrierung, wenn der Druckachse verfügbar, andernfalls none.

Touch.Druck.Skalierung

Definition: touch.pressure.scale = <eine nicht negative Gleitkommazahl>

Gibt einen konstanten Skalierungsfaktor an, der bei der Kalibrierung verwendet wird.

Der Standardwert ist 1.0 / raw.pressure.max.

Berechnung

Die Berechnung des Felds pressure hängt von den angegebenen Kalibrierungsparametern ab.

If touch.pressure.calibration == "physical" or "amplitude":
    output.pressure = raw.pressure * touch.pressure.scale
Else
    If hovering:
        output.pressure = 0
    Else
        output.pressure = 1
    End If
End If

Ausrichtungs- und Neigungsfelder

Das Feld orientation beschreibt die Ausrichtung der Berührung und des Tools als Winkelmessung. Die Ausrichtung 0 gibt an, dass die Hauptachse vertikal ausgerichtet ist, gibt -PI/2 an, dass die Hauptachse links ausgerichtet ist, PI/2 gibt an, dass die Hauptachse nach rechts ausgerichtet ist. Wenn ein Eingabestift Tool vorhanden ist, kann der Ausrichtungsbereich als Vollkreis dargestellt werden. von -PI oder PI.

Im Feld tilt wird die Neigung des Tools als Winkelmessung beschrieben. Eine Neigung von 0 bedeutet, dass das Tool senkrecht zur Oberfläche ist. Eine Neigung von PI/2 zeigt an, dass das Werkzeug flach auf der Oberfläche liegt.

touch.orientation.calibration

Definition: touch.orientation.calibration = none | interpolated | vector | default

Gibt die Art der Messung an, die der Touch-Treiber verwendet, um die Ausrichtung zu melden.

  • Wenn der Wert none ist, ist die Ausrichtung unbekannt und wird auf 0 gesetzt.
  • Wenn der Wert interpolated ist, wird die Ausrichtung linear interpoliert, sodass ein Rohwert von raw.orientation.min auf -PI/2 und ein Rohwert von raw.orientation.max auf PI/2 abgebildet wird. Der Mittenwert von (raw.orientation.min + raw.orientation.max) / 2 verweist auf 0.
  • Wenn der Wert vector ist, wird die Ausrichtung als gepackter Vektor interpretiert, zwei signierten 4-Bit-Felder. Diese Darstellung wird für Atmel Object Based Protocol-Teile verwendet. Nach der Dekodierung liefert der Vektor einen Orientierungswinkel und eine Konfidenzmagnitude. Die Konfidenzgröße wird verwendet, um die Größeninformationen es sei denn, es ist geometrisch.
  • Wenn der Wert default ist, verwendet das System die interpolated-Kalibrierung, wenn die Ausrichtungsachse verfügbar ist, andernfalls none.

Berechnung

Die Berechnung der Felder orientation und tilt hängt von den angegebenen Kalibrierungsparametern und der verfügbaren Eingabe ab.

If touch.tiltX and touch.tiltY are available:
    tiltXCenter = average(raw.tiltX.min, raw.tiltX.max)
    tiltYCenter = average(raw.tiltY.min, raw.tiltY.max)
    tiltXAngle = (raw.tiltX - tiltXCenter) * PI / 180
    tiltYAngle = (raw.tiltY - tiltYCenter) * PI / 180
    output.orientation = atan2(-sin(tiltXAngle), sinf(tiltYAngle))
    output.tilt = acos(cos(tiltXAngle) * cos(tiltYAngle))
Else If touch.orientation.calibration == "interpolated":
    center = average(raw.orientation.min, raw.orientation.max)
    output.orientation = PI / (raw.orientation.max - raw.orientation.min)
    output.tilt = 0
Else If touch.orientation.calibration == "vector":
    c1 = (raw.orientation & 0xF0) >> 4
    c2 = raw.orientation & 0x0F

    If c1 != 0 or c2 != 0:
        If c1 >= 8 Then c1 = c1 - 16
        If c2 >= 8 Then c2 = c2 - 16
        angle = atan2(c1, c2) / 2
        confidence = sqrt(c1*c1 + c2*c2)

        output.orientation = angle

        If touch.size.calibration == "diameter" or "area":
            scale = 1.0 + confidence / 16
            output.touchMajor *= scale
            output.touchMinor /= scale
            output.toolMajor *= scale
            output.toolMinor /= scale
        End If
    Else
        output.orientation = 0
    End If
    output.tilt = 0
Else
    output.orientation = 0
    output.tilt = 0
End If

If orientation aware:
    If screen rotation is 90 degrees:
        output.orientation = output.orientation - PI / 2
    Else If screen rotation is 270 degrees:
        output.orientation = output.orientation + PI / 2
    End If
End If

Distanzfeld

Das Feld distance beschreibt den Abstand zwischen dem Tool und der Oberfläche des Touch-Geräts. Ein Wert von 0,0 bedeutet direkten Kontakt und höhere Werte einen zunehmenden Abstand von der Oberfläche.

touch.distance.calibration

Definition: touch.distance.calibration = none | scaled | default

Gibt die Art der Messung an, die der Touchscreen-Treiber verwendet, um die Entfernung aufzuzeichnen.

  • Wenn der Wert none ist, ist die Entfernung unbekannt und wird daher auf 0 festgelegt.

  • Wenn der Wert scaled ist, wird die gemeldete Entfernung mit einem Konstanten-Skalierungsfaktors.

  • Wenn der Wert default ist, verwendet das System die scaled-Kalibrierung, wenn die Entfernungsachse verfügbar ist, andernfalls none.

touch.distance.scale

Definition: touch.distance.scale = <eine nicht negative Gleitkommazahl>

Gibt einen konstanten Skalierungsfaktor an, der bei der Kalibrierung verwendet wird.

Der Standardwert ist 1.0.

Berechnung

Die Berechnung des Felds distance hängt von der angegebenen Kalibrierung ab Parameter.

If touch.distance.calibration == "scaled":
    output.distance = raw.distance * touch.distance.scale
Else
    output.distance = 0
End If

Beispiel

# Input device configuration file for a touch screen that supports pressure,
# size and orientation. The pressure and size scale factors were obtained
# by measuring the characteristics of the device itself and deriving
# useful approximations based on the resolution of the touch sensor and the
# display.
#
# Note that these parameters are specific to a particular device model.
# Different parameters need to be used for other devices.

# Basic Parameters
touch.deviceType = touchScreen
touch.orientationAware = 1

# Size
# Based on empirical measurements, we estimate the size of the contact
# using size = sqrt(area) * 28 + 0.
touch.size.calibration = area
touch.size.scale = 28
touch.size.bias = 0
touch.size.isSummed = 0

# Pressure
# Driver reports signal strength as pressure.
#
# A normal index finger touch typically registers about 80 signal strength
# units although we don't expect these values to be accurate.
touch.pressure.calibration = amplitude
touch.pressure.scale = 0.0125

# Orientation
touch.orientation.calibration = vector

Kompatibilitätshinweise

Die Konfigurationseigenschaften für Touch-Geräte haben sich in Android Ice Cream Sandwich 4.0 Alle Konfigurationsdateien für Eingabegeräte für Berührung Geräte aktualisiert werden müssen, damit sie die neuen Konfigurationseigenschaften verwenden.

Möglicherweise müssen auch Treiber für ältere Touchgeräte aktualisiert werden.

Dateien für die Zuordnung virtueller Schlüssel

Auf Touchbildschirmen können virtuelle Tasten implementiert werden.

Dafür gibt es je nach den Funktionen des Touch-Controller. Einige Touchcontroller können direkt konfiguriert werden, um Softkeys zu implementieren, indem Firmwareregister festgelegt werden. In anderen Fällen ist es wünschenswert, die Zuordnung von Berührungskoordinaten zu Tastencodes in Software.

Wenn virtuelle Tasten in der Software implementiert sind, muss der Kernel eine Datei mit einer virtuellen Tastenzuordnung namens virtualkeys.<devicename> als Boardeigenschaft exportieren. Wenn der Name der Touchscreen-Gerätetreiber beispielsweise „touchyfeely“ lautet, muss die Datei mit der virtuellen Tastenzuordnung den Pfad /sys/board_properties/virtualkeys.touchyfeely haben.

In einer Datei mit einer virtuellen Tastenkarte werden die Koordinaten und Linux-Tastencodes der virtuellen Tasten auf dem Touchscreen beschrieben.

Zusätzlich zur Datei mit der virtuellen Tastenzuordnung müssen eine entsprechende Datei mit dem Tastenlayout und eine Datei mit der Tastenbelegung vorhanden sein, um die Linux-Tastencodes den Android-Tastencodes zuzuordnen und den Typ des Tastaturgeräts anzugeben (normalerweise SPECIAL_FUNCTION).

Syntax

Eine virtuelle Schlüsselzuordnungsdatei ist eine Nur-Text-Datei, die aus einer Abfolge virtueller Schlüssel besteht. die entweder durch Zeilenumbrüche oder Doppelpunkte voneinander getrennt sind.

Kommentarzeilen beginnen mit "#" bis zum Zeilenende.

Jeder virtuelle Schlüssel wird durch sechs durch Doppelpunkte getrennte Komponenten beschrieben:

  • 0x01: Ein Versionscode. Muss immer 0x01 sein.
  • <Linux-Schlüsselcode>: Der Linux-Schlüsselcode des virtuellen Schlüssels.
  • <centerX>: Die X-Pixelkoordinate der Mitte der virtuellen Taste.
  • <centerY>: Die Y-Pixelkoordinate der Mitte der virtuellen Taste.
  • <width>: Die Breite des virtuellen Schlüssels in Pixeln.
  • <height>: Höhe des virtuellen Schlüssels in Pixeln.

Alle Koordinaten und Größen werden in Bezug auf das Anzeigekoordinatensystem angegeben.

Hier ist eine virtuelle Keymap-Datei, die alle in einer Zeile geschrieben ist.

# All on one line
0x01:158:55:835:90:55:0x01:139:172:835:125:55:0x01:102:298:835:115:55:0x01:217:412:835:95:55

Dieselbe virtuelle Keymap-Datei kann auch in mehreren Zeilen geschrieben werden.

# One key per line
0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

Im obigen Beispiel hat der Touchscreen eine Auflösung von 480 × 800 Pixeln. Daher haben alle virtuellen Tasten die <centerY>-Koordinate 835, was etwas unter dem sichtbaren Bereich des Touchscreens liegt.

Der erste Schlüssel hat den Linux-Scancode 158 (KEY_BACK), centerX von 55, MittelpunktY von 835, Breite: 90 und Höhe von 55

Beispiel

Virtuelle Schlüsselzuordnungsdatei: /sys/board_properties/virtualkeys.touchyfeely.

0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

Schlüssellayoutdatei: /system/usr/keylayout/touchyfeely.kl.

key 158 BACK
key 139 MENU
key 172 HOME
key 217 SEARCH

Datei mit Schlüsselzeichentabelle: /system/usr/keychars/touchyfeely.kcm.

type SPECIAL_FUNCTION

Indirekte Touch-Gesten für den Multi-Touch-Zeiger

Im Zeigermodus werden die folgenden Touch-Gesten vom System interpretiert:

  • Tippen mit einem Finger: Klicken.
  • Bewegung mit einem Finger: Zeiger bewegen
  • Bewegung mit einem Finger und Drücken von Tasten: Ziehen Sie den Cursor.
  • Bewegung mit zwei Fingern, die sich in dieselbe Richtung bewegen: Ziehen Sie den Bereich unter dem Cursor in diese Richtung. Der Cursor selbst bewegt sich nicht.
  • Bewegung mit zwei Fingern, die sich aufeinander zu oder in verschiedene Richtungen bewegen: Schwenken/Zoomen/Drehen des Bereichs um den Cursor. Der Cursor selbst bewegt sich nicht.
  • Mehrfingerbewegung: Freiform-Touch-Geste.

Ablehnung der Handfläche

Ab Android 13 kann das System Eingaben von Handflächen automatisch ablehnen. wenn das integrierte Framework aktiviert ist. Interne, kundenspezifische Lösungen werden weiterhin unterstützt, obwohl sie möglicherweise so geändert werden müssen, dass sie das Flag TOOL_TYPE_PALM zurückgeben, wenn ein Palm erkannt wird. Das integrierte Framework funktioniert auch in Verbindung mit benutzerdefinierten Lösungen.

Das tatsächliche Modell betrachtet die ersten 90 ms der Bewegungsdaten am aktuellen Zeiger die umgebenden Zeiger und berücksichtigt, wie weit die Berührungen vom Displayrand entfernt sind. Anschließend wird für jeden Zeiger ermittelt, ob es sich um eine Handfläche handelt. Außerdem wird die Größe der einzelnen Kontakte berücksichtigt, wie von touchMajor und touchMinor angegeben. Das Android-Framework entfernt dann die Touch-Cursor, die als Handflächen markiert sind, aus dem Touch-Stream.

Wenn bereits ein Verweis an die Apps gesendet wurde, geschieht Folgendes:

  • (Wenn andere aktive Zeiger vorhanden sind) Der Zeiger mit den festgelegten Werten ACTION_POINTER_UP und FLAG_CANCELED wird abgebrochen.
  • (Wenn dies der einzige Verweis ist) Der Verweis wird mit ACTION_CANCEL abgebrochen.

Die öffentliche API MotionEvent.FLAG_CANCELED gibt an, dass die aktuelle sollte keine Nutzeraktion auslösen. Dieses Flag ist sowohl für ACTION_CANCEL und ACTION_POINTER_UP.

Wenn der Handballenzeiger nicht an Apps gesendet wurde, lässt das System ihn einfach fallen.

Handballenablehnung aktivieren

  1. Verwenden Sie in Ihrem Touch-Treiber den input_abs_set_res-Makro um die Auflösungen für die folgenden Felder festzulegen (Einheiten sind Pixel pro mm):
    • ABS_MT_POSITION_X
    • ABS_MT_POSITION_Y
    • ABS_MT_TOUCH_MAJOR
    • ABS_MT_TOUCH_MINOR

    Die Unterstützung von ABS_MT_TOUCH_MINOR ist optional. Wenn dein Gerät diese Funktion jedoch unterstützt, achte darauf, dass die Auflösung richtig eingestellt ist.

  2. Führen Sie folgenden Befehl aus, um zu prüfen, ob die Felder richtig festgelegt sind: 
        $ adb shell getevent -li
  3. Führen Sie folgenden Befehl aus, um das Feature während der Laufzeit zu aktivieren: 
        $ adb shell device_config put input_native_boot palm_rejection_enabled 1
  4. Starten Sie den system_server-Prozess neu. 
         $ adb shell stop && adb shell start
  5. Bestätige, dass sich in adb shell dumpsys input Handflächenablehnungen befinden UnwantedInteractionBlocker. Ist dies nicht der Fall, überprüfen Sie die eingabebezogenen Logs, Hinweise darauf, was falsch konfiguriert sein könnte.

    Hier ein Beispiel:

    UnwantedInteractionBlocker:
  mEnablePalmRejection: true
  isPalmRejectionEnabled (flag value): true
  mPalmRejectors:
    deviceId = 3:
      mDeviceInfo:
        max_x = 
        max_y = 
        x_res = 11.00
        y_res = 11.00
        major_radius_res = 1.00
        minor_radius_res = 1.00
        minor_radius_supported = true
        touch_major_res = 1
        touch_minor_res = 1
      mSlotState:
        mSlotsByPointerId:

        mPointerIdsBySlot:

      mSuppressedPointerIds: {}
  6. Um die Funktion dauerhaft zu aktivieren, fügen Sie den entsprechenden Sysprop-Befehl in die init**rc Datei:

    setprop persist.device_config.input_native_boot.palm_rejection_enabled 1

Weitere Informationen