Personalizar com fotos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 inclusão no mostrador do relógio pode ajudar a dar um toque pessoal à experiência do mostrador.

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:

<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 a uma única foto

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

<PartImage ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

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

Se o usuário quiser selecionar uma foto diferente, ele precisará usar o companheiro 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 exiba uma foto de uma coleção, que pode ser alternada com um toque ou automaticamente após várias visualizações.

<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
    source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>

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 circule 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 usuário tocar na foto ou em resposta à foto ficar 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 é muito frequente. O valor padrão aqui é 3.

Para mais detalhes sobre o uso de PhotosConfiguration, consulte os exemplos no GitHub.