Creare editor del metodo di immissione su Wear

Wear OS supporta i metodi di immissione oltre alla voce estendendo il framework dell'Input Method Editor (IME) di Android. Il framework IME fornisce supporto per le tastiere virtuali su schermo che consentono agli utenti di inserire testo sotto forma di clic sui tasti, scrittura a mano o gesti.

Gli utenti di Wear OS possono scegliere tra varie opzioni di input da Input remoto. Le opzioni includono:

  • Dettatura
  • Emoji
  • Risposte predefinite
  • Risposta rapida
  • IME predefinito
Metodi di immissione di esempio.
Figura 1. Esempio di metodi di immissione.

Wear OS include un IME predefinito del sistema e consente agli sviluppatori di terze parti di creare IME personalizzati. Le API IME utilizzate per i dispositivi Wear OS sono le stesse di altri fattori di forma, anche se l'utilizzo è leggermente diverso a causa delle dimensioni ridotte dello schermo.

Questo documento fornisce indicazioni per aiutarti a creare un IME specifico per Wear OS.

Creare un metodo di immissione per Wear

La piattaforma Android fornisce un framework standard per la creazione di IME. Per creare un IME specifico per Wear OS, devi ottimizzarlo per le dimensioni ridotte dello schermo di uno smartwatch.

Filtri IME specifici per Wear OS

Per scoprire come creare un metodo di immissione per Wear OS, segui la guida per creare un metodo di immissione sugli smartphone. Poi aggiungi i filtri di Google Play nelle sezioni seguenti al file manifest per renderlo un IME specifico per Wear OS.

Livello API

Se stai sviluppando un IME per Wear OS, tieni presente che la funzionalità è supportata solo su Android 6.0 (livello API 23) e versioni successive. Per assicurarti che l'IME possa essere installato solo su smartwatch che supportano metodi di immissione oltre alla voce, imposta il minSdkVersion valore nel file build.gradle.kts dell'app su 23 o un valore superiore.

Gruppi di funzionalità dei dispositivi

Per controllare il modo in cui la tua app viene filtrata dai dispositivi che non supportano gli IME di Wear OS, come gli iPhone, aggiungi quanto segue al manifest dell'app:

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

Richiamare un metodo di immissione

Wear OS fornisce impostazioni utente sullo smartwatch che consentono all'utente di attivare più IME dall'elenco degli IME installati. Una volta che l'utente ha attivato il tuo IME, può richiamarlo da una notifica o da un'app utilizzando l'API RemoteInput.

Considerazioni generali sull'IME

Ecco alcune cose da considerare quando implementi l'IME per Wear:

  • Imposta un'azione predefinita.

    RemoteInput e le app Wear OS si aspettano solo l'inserimento di testo su una singola riga. Utilizza sempre il tasto Invio per attivare una chiamata a sendDefaultEditorAction, che fa sì che l'app chiuda la tastiera e continui con il passaggio o l'azione successiva.

  • Utilizza un IME in modalità a schermo intero.

    I metodi di immissione su Wear OS coprono la maggior parte dello schermo, lasciando visibile solo una piccola parte dell' app. L'utilizzo della modalità a schermo intero offre un'esperienza utente ottimale indipendentemente dall' interfaccia utente dell'app. In modalità a schermo intero, un ExtractedText fornisce una visualizzazione speculare del campo di testo in fase di modifica e può essere stilizzato in modo da integrarsi con il resto dell'interfaccia utente del metodo di immissione. Per maggiori dettagli sulla modalità a schermo intero, consulta InputMethodService.

  • Gestisci i flag InputType

    Come minimo, per motivi di privacy, gestisci il InputType flag TYPE_TEXT_VARIATION_PASSWORD nel tuo IME. Quando l'IME è in modalità password, assicurati che la tastiera sia ottimizzata per la pressione di un singolo tasto, il che significa che la correzione automatica dell'ortografia, il completamento automatico e l'input tramite gesti sono disattivati. Ancora più importante, la tastiera in modalità password deve supportare i simboli ASCII (American Standard Code for Information Interchange) indipendentemente dalla lingua di input. Per maggiori dettagli, consulta Specificare il tipo di metodo di immissione.

  • Fornisci un tasto per passare al metodo di immissione successivo.

    Android consente agli utenti di passare da un IME all'altro tra tutti quelli supportati dalla piattaforma. Nell'implementazione dell'IME, imposta il valore booleano supportsSwitchingToNextInputMethod su true. In questo modo, l'IME supporta il meccanismo di cambio, in modo che le app possano passare all'IME successivo supportato dalla piattaforma. Per saperne di più su come implementare il passaggio da un IME all'altro, consulta Passare da un sottotipo di IME all'altro.