Créer des éditeurs de mode de saisie (IME) sur Wear

Wear OS prend en charge des modes de saisie autres que la voix en étendant le framework de l'éditeur de mode de saisie (IME) d'Android. Le framework IME est compatible avec les claviers virtuels à l'écran qui permettent aux utilisateurs de saisir du texte sous la forme de clics sur des touches, d'écriture manuscrite ou de gestes.

Les utilisateurs de Wear OS ont le choix entre différentes options de saisie à partir de RemoteInput :

  • Dictée
  • Emoji
  • Réponses standardisées
  • Réponses suggérées
  • IME par défaut
Exemples de modes de saisie.
Figure 1. Exemples de modes de saisie

Wear OS est fourni avec un IME système par défaut et permet également aux développeurs tiers de créer des IME personnalisés. Les API IME utilisées pour les appareils Wear OS sont les mêmes que pour les autres facteurs de forme. Leur utilisation est toutefois légèrement différente en raison d'une taille d'écran limitée.

Ce document fournit des conseils pour vous aider à créer un IME spécifique à Wear OS.

Créer un mode de saisie pour Wear

La plate-forme Android fournit un framework standard pour la création d'IME. Pour créer un IME propre à Wear OS, vous devez optimiser votre éditeur pour la taille d'écran limitée d'un appareil connecté.

Filtres IME propres à Wear OS

Pour découvrir comment créer un mode de saisie pour Wear OS, suivez le guide de création d'un mode de saisie sur les téléphones. Ajoutez ensuite les filtres Google Play dans les sections suivantes de votre fichier manifeste pour en faire un IME propre à Wear OS.

Niveau d'API

Si vous développez un IME pour Wear OS, n'oubliez pas que cette fonctionnalité n'est prise en charge que sur Android 6.0 (niveau d'API 23) ou version ultérieure. Pour vous assurer que votre IME ne peut être installé que sur les appareils connectés qui prennent en charge les modes de saisie autres que la voix, définissez la valeur minSdkVersion dans le fichier build.gradle.kts de votre application sur 23 ou une valeur supérieure.

Ensembles de fonctionnalités de l'appareil

Pour contrôler la manière dont votre application est exclue des appareils incompatibles avec les IME Wear OS, comme les iPhone, ajoutez ce qui suit au fichier manifeste de votre application :

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

Appeler un mode de saisie

Wear OS fournit des paramètres utilisateur sur la montre qui permettent à l'utilisateur d'activer plusieurs IME depuis la liste des IME installés. Une fois que l'utilisateur a activé votre IME, il peut l'appeler à partir d'une notification ou d'une application à l'aide de l' RemoteInput API.

Considérations générales liées aux IME

Voici quelques facteurs à prendre en compte lors de l'implémentation d'une IME pour Wear :

  • Définir une action par défaut

    RemoteInput et les applications Wear OS attendent uniquement la saisie de texte sur une seule ligne. Utilisez toujours la touche Entrée pour déclencher un appel vers sendDefaultEditorAction, qui fait que l'application ferme le clavier et continue à la prochaine étape ou action.

  • Utiliser un IME en mode plein écran

    Les modes de saisie sur Wear OS couvrent la majeure partie de l'écran, ne laissant qu'une très petite partie de l'application visible. Le mode plein écran offre une expérience utilisateur optimale, quelle que soit l'UI de l'application. En mode plein écran, un ExtractedText fournit une vue dupliquée du champ de texte en cours de modification et peut être stylisé pour fusionner avec le reste de l'UI du mode de saisie. Pour en savoir plus sur le mode plein écran, consultez InputMethodService.

  • Gérer les indicateurs InputType

    Au minimum, pour des raisons de sécurité, gérez l'indicateur InputType TYPE_TEXT_VARIATION_PASSWORD dans votre IME. Lorsque votre IME est en mode mot de passe, assurez-vous que le clavier est optimisé pour une pression sur une seule touche, c'est-à-dire que la correction orthographique automatique, la saisie semi-automatique et la saisie gestuelle sont désactivées. Plus important, le clavier en mode mot de passe doit prendre en charge les symboles ASCII (American Standard Code for Information Interchange) quelle que soit la langue de saisie. Pour en savoir plus, consultez Spécifier le type de mode de saisie.

  • Fournissez une touche permettant de passer au mode de saisie suivant

    Android permet aux utilisateurs de basculer entre tous les IME pris en charge par la plate-forme. Dans votre implémentation IME, définissez la valeur booléenne supportsSwitchingToNextInputMethod sur true. Cela permet à votre IME de prendre en charge le mécanisme de basculement afin que les applications puissent basculer vers l'IME suivant pris en charge par la plate-forme. Pour savoir comment implémenter le basculement entre les IME, consultez Basculer entre les sous-types d'IME.