Personalizzare con le foto

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Nota: questa funzionalità è disponibile dalla versione 4 in poi di Formato quadrante.

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

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

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

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

configType può essere SINGLE o MULTIPLE a indicare se l'utente potrà selezionare una singola immagine all'interno della creatività companion o una raccolta di foto.

Supportare una singola foto

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

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

Tieni presente che defaultImageResource 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.

Supporta più foto

L'utilizzo di PhotosConfiguration con configType="MULTIPLE" consente al quadrante di mostrare una foto di una raccolta, che può essere visualizzata passando da una all'altra tramite tocco o automaticamente dopo un determinato numero di visualizzazioni.

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

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 immagini disponibili nella foto.

Nell'esempio precedente, sono specificati sia TAP sia ON_VISIBLE, il che significa che la foto cambia in risposta o al tocco di un utente o alla sua visibilità.

1. L'attributo changeAfterEvery si applica solo all'evento di modifica ON_VISIBLE, specificando quante volte la foto deve essere diventata visibile prima di essere modificata. Ad esempio, potresti ritenere che la modifica della 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.