Utilizzo dei widget > 3D > Prodotto
Prodotto
* 
Questo widget è disponibile solo con Vuforia Studio e Experience Service 10.0.0 e versioni successive.
Qual è la funzione di questo widget?
Il widget Prodotto consente di recuperare asset riutilizzabili, ad esempio modelli e model target, senza scrivere codice. Estrae automaticamente i dati specifici del prodotto che sono stati precedentemente caricati e generati in Experience Service utilizzando l'API prodotto, semplificando così l'integrazione di contenuto dinamico nelle esperienze. Per ulteriori informazioni, vedere API prodotto di Vuforia Studio.
Quando va utilizzato questo widget?
Utilizzare un widget Prodotto in qualsiasi esperienza in cui si desidera caricare dinamicamente modelli e model target da Experience Service. È sufficiente connettere il widget Prodotto al widget Modello e al widget Target dinamico per assicurarsi che gli asset recuperati vengano caricati perfettamente in fase di esecuzione, senza la necessità di creare uno script di codice.
Quando si utilizza questo widget, l'esperienza segue una logica definita:
• Se il modello è stato semplificato, l'esperienza recupera automaticamente la versione di qualità "Media".
• Se sono disponibili più model target, l'esperienza assegna la priorità al caricamento della massima qualità disponibile nel seguente ordine: Avanzata, Avanzata locale e Standard. Quando esistono più versioni nello stesso livello di qualità, viene selezionata automaticamente la versione più recente.
Per istruzioni dettagliate, vedere Caso di utilizzo: caricare e confrontare gli asset in modo dinamico.
Sono disponibili proprietà, servizi, eventi o azioni speciali?
Per visualizzare un elenco di proprietà, servizi ed eventi comuni a più widget, vedere Proprietà, servizi ed eventi comuni a più widget.
* 
Se non si è certi della versione di Experience Service in esecuzione, contattare l'amministratore.
Nome proprietà
JavaScript
Tipo
Descrizione
ID prodotto
productID
string
ID prodotto del prodotto.
Versione
version
string
Specifica la versione del prodotto. Un prodotto può avere più versioni. Se non viene specificata una versione, viene utilizzata per default la versione disponibile più recente.
* 
"Più recente" si riferisce alla versione creata più di recente, non necessariamente a quella con il numero di versione superiore.
Modello
modelUri
string
URL della risorsa modello del prodotto (file .pvz).
Target
targetUri
string
URL della risorsa target del prodotto (file .dat).
* 
Il widget Prodotto consente di caricare e visualizzare i dati di prodotto in base a un ID prodotto e a una versione opzionale. Se si specificano sia un ID prodotto che una versione, il widget carica la versione specifica del prodotto. Se si specifica solo un ID prodotto e si lascia vuota la versione, il widget carica automaticamente la versione più recente del prodotto.
Evento
JavaScript
Descrizione
Prodotto caricato
productLoaded
Attivato dopo aver completato il recupero degli URL correlati al prodotto. Per rilevare quando il modello è caricato completamente, utilizzare l'evento modelLoaded del widget Model target.
Prodotto non riuscito
productFailed
Attivato quando il caricamento del prodotto ha esito negativo.
* 
Se l'ID prodotto o la combinazione ID prodotto-versione specificata non viene trovata, viene attivato l'evento Product Failed. Questo evento non visualizza automaticamente un messaggio di errore nell'interfaccia utente. L'autore dell'esperienza ha la responsabilità di gestire questo evento e di creare tutte le notifiche di errore o i comportamenti di fallback necessari per l'esperienza. In questo modo ha il controllo completo sulla modalità di comunicazione dei dati di prodotto mancanti agli utenti.
Caso di utilizzo di esempio
Vedere i casi di utilizzo seguenti:
È stato utile?