Personalizar com fotos

Observação: esse recurso está disponível na versão 4 e mais recentes do formato de mostrador do relógio.

Permitir que o usuário selecione fotos para incluir no mostrador do relógio pode ajudar a dar um toque pessoal à experiência.

A seção como trabalhar com imagens já explica como mostrar imagens no mostrador do relógio. Se você quiser permitir que o usuário escolha entre uma variedade de imagens predefinidas, use um ListConfiguration, conforme mostrado na seção definir configurações do usuário.

Para usar imagens configuráveis pelo usuário no mostrador do relógio, use o elemento <PhotosConfiguration>. Por exemplo:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

O configType pode ser SINGLE ou MULTIPLE, indicando se o usuário poderá selecionar uma única imagem no complemento ou uma coleção de fotos.

Suporte para uma única foto

Para o caso de uma única imagem, a foto pode ser usada em um elemento PartImage da seguinte forma:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Observe o defaultImageResource, que é mostrado quando o usuário não selecionou uma foto no complemento e é um atributo obrigatório.

Se o usuário quiser selecionar uma foto diferente, ele precisará usar o app complementar para substituir a seleção atual por outra.

Suporte a várias fotos

Usar PhotosConfiguration com configType="MULTIPLE" permite que o mostrador do relógio mostre uma foto de uma coleção, que pode ser alternada tocando na tela ou automaticamente após um determinado número de visualizações.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos_multi.xml

O exemplo anterior mostra as duas opções que são apresentadas ao usar MULTIPLE:

  1. O atributo change permite que o desenvolvedor especifique quais eventos devem fazer com que a foto passe pelas imagens disponíveis.

No exemplo anterior, TAP e ON_VISIBLE são especificados, o que significa que a foto muda em resposta a um toque do usuário ou em resposta à visibilidade da foto.

  1. O atributo changeAfterEvery se aplica apenas ao evento de mudança ON_VISIBLE, especificando quantas vezes a foto precisa ficar visível antes de ser alterada. Por exemplo, você pode achar que mudar a foto sempre que o usuário acorda o relógio é muito frequente. O valor padrão aqui é 3.

Para mais detalhes sobre como trabalhar com PhotosConfiguration, consulte os exemplos no GitHub.