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:
- Instalação:instale o mostrador de relógio usando o Watch Face Push, iniciado
pelo
MessageClient
. Esta etapa é simples, usandoaddWatchFace
ouupdateWatchFace
, acionados comMessageClient
do smartphone para o relógio. - 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.
- Se o usuário conceder a permissão, o relógio vai chamar