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

Para o marketplace canônico, o app para smartphone é a principal forma de interação do usuário com o app.

Definir um mostrador de relógio

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

1. Instalação:instale o mostrador de relógio usando o Watch Face Push, iniciado pelo MessageClient. Esta etapa é simples, usando addWatchFace ou updateWatchFace, acionados com MessageClient do smartphone para o relógio.
2. Ativação:defina o mostrador do relógio instalado como ativo. Essa etapa tem vários caminhos possíveis, dependendo do estado da permissão:
   • Talvez não seja necessário fazer nada. O marketplace já pode ter controle do mostrador do relógio ativo.
   • Talvez não seja necessário fazer nada. O app tem as permissões necessárias para definir o mostrador de relógio ativo e pode fazer isso diretamente usando setWatchFaceAsActive().
   • Pode haver orientações necessárias, seja sobre como aceitar solicitações de permissão ou como definir manualmente o mostrador do relógio usando um gesto de pressionar e manter pressionado ou um app complementar.

Resposta da 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 de relógio ativo.
• Se setWatchFaceAsActive() já foi chamado no passado. O app 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 ativo. No entanto, se não for, o app poderá 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 no passado, 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 definir manualmente o que ele quer.

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á tiver concedido, chame setWatchFaceAsActive().
• Se o usuário já tiver negado a permissão, o relógio vai comunicar isso ao smartphone, onde uma tela explicativa pode ser mostrada explicando a necessidade da permissão e como concedê-la manualmente.

• Se a permissão não tiver sido solicitada antes, o relógio vai instruir o smartphone a mostrar um tutorial ensinando o usuário a aceitar permissões no relógio, e o relógio vai solicitar a permissão.

  • Se o usuário conceder a permissão, o relógio vai chamar setWatchFaceAsActive().
  • Caso contrário, o relógio vai instruir o smartphone a mostrar uma tela de educação explicando a necessidade da permissão e como concedê-la manualmente.