Criar editores de métodos de entrada no Wear

O Wear OS oferece suporte a métodos de entrada além da voz, estendendo o framework do editor de método de entrada (IME, na sigla em inglês) do Android. O framework do IME oferece suporte a teclados virtuais na tela, assim os usuários podem inserir texto na forma de cliques em teclas, escrita à mão ou gestos.

Os usuários do Wear OS podem escolher entre várias opções de Entrada remota. Essas opções incluem:

  • Ditado
  • Emoji
  • Respostas automáticas
  • Resposta inteligente
  • IME padrão
Exemplos de métodos de entrada.
Figura 1. Exemplo de métodos de entrada.

O Wear OS vem com um IME padrão do sistema e também permite que desenvolvedores terceirizados criem IMEs personalizados. As APIs do IME usadas para dispositivos Wear OS são as mesmas de outros formatos, embora o uso seja um pouco diferente devido ao tamanho limitado da tela.

Este documento explica como criar um IME específico do Wear OS.

Criar um método de entrada para o Wear

A plataforma Android fornece um framework padrão para criação de IMEs. Para criar um IME específico do Wear OS, é preciso otimizar o IME para o tamanho de tela limitado de um dispositivo wearable.

Filtros de IME específicos para Wear OS

Para saber como criar um método de entrada para o Wear OS, siga as instruções no guia para criar um método de entrada em smartphones. Em seguida, adicione os filtros do Google Play nas seções a seguir ao arquivo de manifesto para criar um IME específico do Wear OS.

Nível da API

Se você estiver desenvolvendo um IME para o Wear OS, não esqueça que o recurso oferece suporte apenas ao Android 6.0 (nível 23 da API) e versões mais recentes. Para garantir que seu IME só possa ser instalado em wearables com suporte a métodos de entrada além da voz, defina o minSdkVersion valor no arquivo build.gradle.kts do app como 23 ou mais recente.

Conjuntos de recursos do dispositivo

Para controlar como o app é filtrado em dispositivos sem suporte aos IMEs do Wear OS, como iPhones, adicione este código ao manifesto do app:

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

Invocar um método de entrada

O Wear OS fornece configurações no relógio que permitem ao usuário ativar vários IMEs na lista dos instalados. Depois que o usuário ativa seu IME, ele pode invocá-lo em uma notificação ou em um app usando a RemoteInput API.

Considerações gerais sobre IME

Confira o que você precisa considerar ao implementar o IME para o Wear:

  • Defina uma ação padrão.

    RemoteInput e os apps Wear OS esperam apenas entrada de texto de linha única. Sempre use a tecla Enter para acionar uma chamada para sendDefaultEditorAction, que faz com que o app dispense o teclado e prossiga para a próxima etapa ou ação.

  • Use um IME em modo de tela cheia.

    Os métodos de entrada no Wear OS cobrem a maior parte da tela, deixando muito pouco do app visível. O uso do modo de tela cheia oferece uma experiência do usuário ideal, independente da interface do app. No modo de tela cheia, um ExtractedText oferece uma visualização espelhada do campo de texto que está sendo editado e pode ser estilizado para combinar com o restante da interface do método de entrada. Para mais detalhes sobre o modo de tela cheia, consulte InputMethodService.

  • Gerenciar InputType sinalizações.

    No mínimo, por motivos de privacidade, gerencie o InputType sinalizador TYPE_TEXT_VARIATION_PASSWORD no seu IME. Quando o IME estiver no modo de senha, verifique se o teclado está otimizado para pressionamento de tecla única, ou seja, a correção ortográfica automática, o preenchimento automático e a entrada por gesto estão desativados. O mais importante é que o teclado no modo de senha precisa oferecer suporte a símbolos do Código Padrão Americano para Troca de Informações (ASCII, na sigla em inglês) independente do idioma de entrada. Para mais detalhes, consulte Como especificar o tipo de método de entrada.

  • Fornecer uma chave para alternar métodos de entrada.

    O Android permite que os usuários alternem entre todos os IMEs com suporte da plataforma. Na implementação do IME, defina o booleano supportsSwitchingToNextInputMethod como true. Isso permite que seu IME ofereça suporte ao mecanismo de alternância para que os apps possam alternar para o próximo IME com suporte da plataforma. Para saber mais sobre como implementar a alternância entre IMEs, consulte Alternar entre subtipos de IME.