Notícias sobre produtos

Como levar o Androidify para o Wear OS com a API Watch Face Push

Leitura de 3 min
Ver o perfil de Garan Jenkin
Garan Jenkin Engenheiro de relações com desenvolvedores

 

 

Há alguns meses, relançamos o Androidify como um app para gerar bots personalizados do Android. O Androidify transforma sua selfie em um bot divertido do Android usando o Gemini e o Imagen.

No entanto, como o Android abrange vários formatos, incluindo nossa adição mais recente, o XR, pensamos: como poderíamos levar a diversão do Androidify para o Wear OS?

Um mostrador do relógio do Androidify

Como os bots do Androidify são altamente personalizados, o lugar natural para mostrá-los é o mostrador do relógio. Além de ser a superfície mais visível, ela também é a mais pessoal, permitindo que você represente quem você é.

demonstration.gif

Mostrador do relógio personalizado do Androidify, gerado com base em uma selfie

O Androidify agora pode gerar um mostrador do relógio dinamicamente no app Telefone e enviá-lo ao relógio, onde ele será definido automaticamente como o mostrador do relógio. Tudo isso acontece em segundos.

Design de alto nível

image.png

Fluxo completo para criação e instalação de mostradores de relógio

Para alcançar a experiência completa, várias tecnologias precisam ser combinadas, como mostrado neste diagrama de design de alto nível.

Primeiro, o avatar do usuário é combinado com um modelo preexistente do Formato do mostrador do relógio, que é empacotado em um APK. Isso é validado, por motivos que serão explicados. - e enviadas ao relógio.

Ao ser recebida pelo relógio, a nova API Watch Face Push, que faz parte do Wear OS 6, é usada para instalar e ativar o mostrador do relógio.

Vamos conferir os detalhes:

Como criar os modelos de mostrador do relógio

O mostrador do relógio é criado com base em um modelo, que é projetado no Watch Face Designer. Esse é nosso novo plug-in do Figma que permite criar mostradores do relógio no Formato do Mostrador do Relógio diretamente no Figma.

image.png

Um modelo de mostrador do relógio do Androidify no Designer de Mostrador do Relógio

O plug-in permite que o mostrador do relógio seja exportado de várias maneiras, inclusive como recursos do Formato do Mostrador do Relógio (WFF, na sigla em inglês). Eles podem ser facilmente incorporados como recursos no app Androidify para criar dinamicamente o mostrador do relógio finalizado.

Empacotamento e validação

Depois que o modelo e o avatar forem combinados, o Portable Asset Compiler Kit (Pack) será usado para montar um APK.

No Androidify, o Pack é usado como uma biblioteca nativa no smartphone. Para mais detalhes sobre como o Androidify interage com a biblioteca Pack, consulte o repositório do GitHub.

Como etapa final antes da transmissão, o APK é verificado pelo validador da API Watch Face Push.

Esse validador verifica se o APK é adequado para instalação. Isso inclui verificar o conteúdo do APK para garantir que ele seja um mostrador do relógio válido, além de algumas verificações de desempenho. Se for válido, o validador vai produzir um token.

Esse token é necessário para a instalação no relógio.

Enviando o mostrador do relógio

O app Androidify no Wear OS usa o WearableListenerService para detectar eventos na camada de dados de wearables.

O app Telefone transfere o mostrador do relógio usando uma combinação de MessageClient para configurar o processo e ChannelClient para transmitir o APK.

Instalando o mostrador do relógio no relógio

Depois que o mostrador do relógio é recebido no dispositivo Wear OS, o app Androidify usa a nova API Watch Face Push para instalar o mostrador:

val wfpManager = 

    WatchFacePushManagerFactory.createWatchFacePushManager(context)

val response = wfpManager.listWatchFaces()



try {

    if (response.remainingSlotCount > 0) {

        wfpManager.addWatchFace(apkFd, token)

    } else {

        val slotId = response.installedWatchFaceDetails.first().slotId

        wfpManager.updateWatchFace(slotId, apkFd, token)

    }

} catch (a: WatchFacePushManager.AddWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

} catch (u: WatchFacePushManager.UpdateWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

}

O Androidify usa o método addWatchFace ou updateWatchFace, dependendo do cenário: a API Watch Face Push define um conceito de "slots", ou seja, quantos mostradores do relógio um determinado app pode ter instalados a qualquer momento. No Wear OS 6, esse valor é 1.

A abordagem do Androidify é instalar o mostrador do relógio se houver um espaço livre. Caso contrário, qualquer mostrador atual será trocado pelo novo.

Como definir o mostrador do relógio ativo

Instalar o mostrador do relógio de forma programática é uma ótima etapa, mas o Androidify busca garantir que ele também seja o mostrador ativo. 

A API Watch Face Push introduz uma nova permissão de execução que precisa ser concedida para que os apps possam fazer o seguinte:

com.google.wear.permission.SET_PUSHED_WATCH_FACE_AS_ACTIVE

Depois que essa permissão for adquirida, o método wfpManager.setWatchFaceAsActive() poderá ser chamado para definir um mostrador do relógio instalado como o mostrador do relógio ativo.

No entanto, há uma série de considerações que o Androidify precisa levar em conta:

  • setWatchFaceAsActive só pode ser usado uma vez.
  • Não é possível solicitar SET_PUSHED_WATCH_FACE_AS_ACTIVE novamente depois que o usuário nega o acesso.
  • O Androidify já pode estar controlando o mostrador do relógio ativo.

Para mais detalhes, consulte como o Androidify implementa a lógica de definição de atividade.

Começar a usar a API Watch Face Push para Wear OS

A API Watch Face Push é versátil, adequada tanto para melhorar o Androidify quanto para criar marketplaces completos de mostradores de relógio.

Talvez você tenha um app Telefone e esteja procurando oportunidades para engajar e encantar ainda mais seus usuários.

Ou talvez você já seja um desenvolvedor de mostradores de relógio e queira criar sua própria comunidade e galeria lançando um app do Marketplace?

Confira estes recursos:

Confira também o vídeo complementar para saber mais sobre como levamos o Androidify para o Wear OS.

Estamos ansiosos para ver o que você vai criar com a API Watch Face Push.

Escrito por:
Continue lendo