Personalizar com fotos

Observação: esse recurso está disponível na versão 4 e mais recentes do Formato do 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á aborda como exibir 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 no mostrador do relógio que o usuário pode configurar, use o elemento <PhotosConfiguration>, por exemplo:

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

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

No caso de uma única imagem, a foto pode ser usada em um elemento PartImage da seguinte maneira:

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

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

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

Suporte a várias fotos

O uso de PhotosConfiguration com configType="MULTIPLE" permite que o mostrador do relógio mostre uma foto de uma coleção, que pode ser alternada com um toque 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>

O exemplo anterior mostra as duas opções que são introduzidas 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 ao toque do usuário ou quando ela se torna visível.

  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 ativa o relógio é uma frequência muito alta. O valor padrão aqui é 3.

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