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:
- O atributo
changepermite 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.
- O atributo
changeAfterEveryse aplica apenas ao evento de mudançaON_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.