Configurar o app do smartphone para push de mostrador do relógio

No marketplace canônico, o app de smartphone é a forma predominante de interação do usuário.

Definir um mostrador de relógio

Quando o usuário seleciona um mostrador do relógio no app do smartphone, há duas partes do fluxo subsequente para definir o mostrador do relógio:

  1. Instalação:instale o mostrador do relógio usando o Push de mostrador do relógio, iniciado por MessageClient. Esta etapa é simples, usando addWatchFace ou updateWatchFace, acionado usando MessageClient do smartphone para o relógio.
  2. Ativação:define o mostrador do relógio instalado como ativo. Esta etapa tem várias possibilidades, dependendo do estado da permissão:
    • Talvez não seja necessário fazer nada. O marketplace pode já ter controle do mostrador do relógio ativo.
    • Talvez não seja necessário que o usuário intervenha. O app tem as permissões necessárias para definir o mostrador do relógio ativo e pode fazer isso diretamente usando setWatchFaceAsActive().
    • Talvez seja necessário orientação, seja sobre como aceitar solicitações de permissão ou como definir manualmente o mostrador do relógio usando um gesto de pressionar longamente ou por um app complementar.

Resposta de instalação

Para facilitar a fase de ativação, a fase de instalação precisa retornar as seguintes informações do relógio para o smartphone:

  • O resultado da tentativa de instalação
  • O resultado de isWatchFaceActive(): para determinar se o app já tem o mostrador do relógio ativo.
  • Se setWatchFaceAsActive() já foi chamado no passado, o app para Wear OS precisa rastrear e manter essas informações localmente. Essa chamada de API só pode ser usada uma vez.

Ativação

Após a instalação, a resposta pode indicar que o app já tem o mostrador do relógio ativo. No entanto, se não, o app pode mostrar um botão para definir o mostrador do relógio como ativo.

Cenário 1: todas as tentativas de definir o mostrador do relógio ativo foram esgotadas

Se a resposta da instalação indicar que setWatchFaceAsActive() já foi chamado anteriormente, o botão vai levar a uma tela de instruções no smartphone, mostrando ao usuário como tocar e pressionar o mostrador do relógio para configurá-lo manualmente.

Cenário 2: tentar definir o mostrador do relógio ativo

O smartphone precisa instruir o relógio a verificar a permissão SET_PUSHED_WATCH_FACE_AS_ACTIVE necessária:

  • Se o usuário já concedeu, chame setWatchFaceAsActive().
  • Se o usuário já tiver negado a permissão, o relógio precisa comunicar isso ao smartphone, onde uma tela de instruções pode ser mostrada explicando a necessidade da permissão e como conceder manualmente.

  • Se a permissão não tiver sido solicitada antes, o relógio precisa instruir o smartphone a mostrar um momento educativo orientando o usuário sobre como aceitar permissões no relógio, e o relógio precisa continuar solicitando a permissão.

    • Se o usuário conceder a permissão, o relógio vai chamar setWatchFaceAsActive().
    • Caso contrário, o relógio precisa instruir o smartphone a mostrar uma tela de informações explicando a necessidade da permissão e como conceder manualmente.