Personalizzare con le foto

Nota: questa funzionalità è disponibile nella versione 4 e successive di Watch Face Format.

Consentire all'utente di selezionare le foto da includere nel quadrante può contribuire a dare un tocco personale all'esperienza del quadrante.

La sezione Lavorare con le immagini spiega già come visualizzare le immagini nel quadrante. Se vuoi consentire all'utente di scegliere tra una serie di immagini predefinite, utilizza un ListConfiguration come mostrato nella sezione Definisci le configurazioni utente.

Per utilizzare immagini nel quadrante che l'utente può configurare, utilizza l'elemento <PhotosConfiguration>, ad esempio:

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

Il valore di configType può essere SINGLE o MULTIPLE, a seconda che l'utente possa selezionare una singola immagine all'interno della companion o una raccolta di foto.

Supportare una singola foto

Nel caso di una singola immagine, la foto può essere utilizzata all'interno di un elemento PartImage come segue:

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

Prendi nota di defaultImageResource, che viene visualizzato quando l'utente non ha selezionato una foto nell'app complementare ed è un attributo obbligatorio.

Se l'utente vuole selezionare un'altra foto, deve utilizzare l'app complementare per sostituire la selezione esistente con un'altra.

Supportare più foto

L'utilizzo di PhotosConfiguration con configType="MULTIPLE" consente al quadrante di visualizzare una foto di una raccolta, che può essere visualizzata a rotazione toccando o automaticamente dopo un certo numero di visualizzazioni.

<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

L'esempio precedente mostra le due opzioni introdotte quando si utilizza MULTIPLE:

  1. L'attributo change consente allo sviluppatore di specificare quali eventi devono far scorrere le foto tra le immagini disponibili.

Nell'esempio precedente, sono specificati sia TAP sia ON_VISIBLE, il che significa che la foto cambia in risposta o al tocco della foto da parte di un utente o in risposta alla visualizzazione della foto.

  1. L'attributo changeAfterEvery si applica solo all'evento di modifica ON_VISIBLE, specificando quante volte la foto deve diventare visibile prima di essere modificata. Ad esempio, potresti ritenere che cambiare la foto ogni volta che l'utente riattiva lo smartwatch sia troppo frequente. Il valore predefinito qui è 3.

Per maggiori dettagli sull'utilizzo di PhotosConfiguration, consulta gli esempi su GitHub.