Eingabemethoden-Editoren in Wear erstellen

Wear OS unterstützt neben der Spracheingabe auch andere Eingabemethoden, indem das Android-Framework für Eingabemethoden-Editoren (Input Method Editor, IME) erweitert wird. Das IME-Framework bietet Unterstützung für virtuelle Bildschirmtastaturen, mit denen Nutzer Text in Form von Tastenklicks, Handschrift oder Gesten eingeben können.

Wear OS-Nutzer können unter „Remote-Eingabe“ zwischen verschiedenen Eingabeoptionen wählen. Dazu gehören:

  • Spracheingabe
  • Emoji
  • Antwortvorlagen
  • Intelligente Antwort
  • Standard-IME
Beispiele für Eingabemethoden
Abbildung 1. Beispiele für Eingabemethoden.

Wear OS enthält einen Standard-IME und ermöglicht es Drittanbietern, benutzerdefinierte IMEs zu erstellen. Die für Wear OS-Geräte verwendeten IME-APIs sind dieselben wie für andere Formfaktoren. Die Verwendung unterscheidet sich jedoch aufgrund der begrenzten Bildschirmgröße leicht.

In diesem Dokument finden Sie eine Anleitung zum Erstellen eines Wear OS-spezifischen IME.

Eingabemethode für Wear erstellen

Die Android-Plattform bietet ein Standard-Framework zum Erstellen von IMEs. Wenn Sie einen Wear OS-spezifischen IME erstellen möchten, müssen Sie ihn für die begrenzte Bildschirmgröße eines Wearable optimieren.

Wear OS-spezifische IME-Filter

Informationen zum Erstellen einer Eingabemethode für Wear OS finden Sie im Leitfaden zum Erstellen einer Eingabemethode auf Smartphones. Fügen Sie dann die Google Play-Filter in den folgenden Abschnitten Ihrer Manifestdatei hinzu, um sie zu einem Wear OS-spezifischen IME zu machen.

API-Ebene

Wenn Sie einen IME für Wear OS entwickeln, beachten Sie, dass die Funktion nur unter Android 6.0 (API-Ebene 23) und höher unterstützt wird. Damit Ihr IME nur auf Wearables installiert werden kann, die Eingabemethoden über die Spracheingabe hinaus unterstützen, legen Sie den minSdkVersion Wert in der Datei build.gradle.kts Ihrer App auf 23 oder höher fest.

Gerätefunktionen

Wenn Sie festlegen möchten, wie Ihre App auf Geräten gefiltert wird, die keine Wear OS-IMEs unterstützen, z. B. iPhones, fügen Sie der Manifestdatei Ihrer App Folgendes hinzu:

<uses-feature android:required="true" android:name="android.hardware.type.watch" />

Eingabemethode aufrufen

Wear OS bietet Nutzereinstellungen auf der Smartwatch, mit denen Nutzer mehrere IMEs aus der Liste der installierten IMEs aktivieren können. Sobald der Nutzer Ihren IME aktiviert hat, kann er ihn über eine Benachrichtigung oder eine App mit der RemoteInput API aufrufen.

Allgemeine Hinweise zu IMEs

Hier sind einige Punkte, die Sie bei der Implementierung von IMEs für Wear beachten sollten:

  • Standardaktion festlegen

    RemoteInput und Wear OS-Apps erwarten nur einzeilige Texteingaben. Verwenden Sie immer die Eingabetaste, um einen Aufruf von sendDefaultEditorAction auszulösen. Dadurch wird die Tastatur in der App geschlossen und mit dem nächsten Schritt oder der nächsten Aktion fortgefahren.

  • IME im Vollbildmodus verwenden

    Eingabemethoden unter Wear OS nehmen den größten Teil des Bildschirms ein, sodass nur sehr wenig von der App sichtbar ist. Der Vollbildmodus bietet unabhängig von der UI der App eine optimale Nutzererfahrung. Im Vollbildmodus bietet ExtractedText eine gespiegelte Ansicht des bearbeiteten Textfelds und kann so gestaltet werden, dass es sich in die restliche UI der Eingabemethode einfügt. Weitere Informationen zum Vollbildmodus finden Sie unter InputMethodService.

  • InputType-Flags verarbeiten

    Aus Datenschutzgründen sollten Sie in Ihrem IME mindestens das InputType Flag TYPE_TEXT_VARIATION_PASSWORD verarbeiten. Wenn sich Ihr IME im Passwortmodus befindet, muss die Tastatur für einzelne Tastendrücke optimiert sein. Das bedeutet, dass die automatische Rechtschreibkorrektur, die automatische Vervollständigung und die Gesteneingabe deaktiviert sind. Vor allem muss die Tastatur im Passwortmodus unabhängig von der Eingabesprache ASCII-Symbole (American Standard Code for Information Interchange) unterstützen. Weitere Informationen finden Sie unter Eingabemethodentyp angeben.

  • Taste zum Wechseln zur nächsten Eingabemethode bereitstellen

    Unter Android können Nutzer zwischen allen von der Plattform unterstützten IMEs wechseln. Legen Sie in Ihrer IME-Implementierung den booleschen Wert supportsSwitchingToNextInputMethod auf true fest. Dadurch unterstützt Ihr IME den Wechselmechanismus, sodass Apps zur nächsten von der Plattform unterstützten IME wechseln können. Weitere Informationen zum Implementieren des Wechsels zwischen IMEs finden Sie unter Zwischen IME-Untertypen wechseln.