Produit
* 
Ce widget est uniquement disponible avec Vuforia Studio et Experience Service 10.0.0 et versions ultérieures.
A quoi sert ce widget ?
Le widget Produit vous permet de récupérer des actifs réutilisables, tels que des modèles et des modèles cibles, sans écriture de code. Il extrait automatiquement les données spécifiques au produit qui ont été précédemment chargées et générées sur Experience Service à l'aide de l'API produit, ce qui facilite l'intégration de contenu dynamique dans vos expériences. Pour plus d'informations, consultez la rubrique API Produit de Vuforia Studio.
Quand faut-il utiliser ce widget ?
Utilisez un widget Produit dans toute expérience dans laquelle vous souhaitez charger dynamiquement des modèles et des modèles cibles à partir de votre Experience Service. Il vous suffit de connecter le widget Produit aux widgets Modèle et Cible dynamique pour garantir le chargement transparent des actifs récupérés au moment de l'exécution, sans besoin de créer des scripts.
Lorsque vous utilisez ce widget, l'expérience suit une logique bien définie :
Si le modèle a été simplifié, l'expérience récupère automatiquement la version de qualité "moyenne".
Si plusieurs modèles cibles sont disponibles, l'expérience donne la priorité au chargement de la version de qualité la plus élevée disponible, dans l'ordre suivant : Avancé, Avancé sur site, Standard. Lorsque plusieurs versions existent dans le même niveau de qualité, la dernière version est sélectionnée automatiquement.
Pour consulter la procédure pas à pas, référez-vous à la rubrique Cas d'utilisation : Charger et comparer des actifs de manière dynamique.
Comporte-t-il des propriétés, services, événements ou actions spéciaux ?
Pour afficher la liste des propriétés, services et événements communs des widgets, consultez la rubrique Propriétés, services et événements communs à plusieurs widgets.
* 
Si vous ne parvenez pas identifier quelle version d'Experience Service vous utilisez, contactez votre administrateur.
Nom de propriété
JavaScript
Type
Description
ID produit
productID
string
ID produit du produit.
Version
version
string
Indique la version du produit. Un produit peut avoir plusieurs versions. Si aucune version n'est fournie, la dernière version disponible est utilisée par défaut.
* 
"Dernière" fait référence à la version la plus récente, pas nécessairement à celle portant le numéro de version le plus élevé.
Modèle
modelUri
string
URL de ressource du modèle du produit. (fichier .pvz)
Cible
targetUri
string
URL de ressource cible du produit. (fichier .dat)
* 
Le widget Produit permet de charger et d'afficher les données produit en fonction d'un ID de produit et d'une version (facultative). Si vous fournissez à la fois un ID de produit et une version, le widget charge cette version spécifique du produit. Si vous fournissez uniquement un ID de produit et laissez la version vide, le widget charge automatiquement la dernière version du produit.
Evénement
JavaScript
Description
Produit chargé
productLoaded
Déclenché une fois que les URL associées au produit ont été correctement récupérées. Pour détecter lorsque le modèle est complètement chargé, utilisez l'événement modelLoaded du widget Modèle cible.
Produit ayant échoué
productFailed
Déclenché lorsque le chargement du produit échoue.
* 
Si l'ID de produit ou la combinaison ID produit-Version que vous fournissez est introuvable, l'événement Product Failed est déclenché. Cet événement n'entraîne pas l'affichage automatique d'un message d'erreur dans l'interface utilisateur. En tant qu'auteur de l'expérience, il est de votre responsabilité de traiter cet événement et de créer toutes les notifications d'erreur ou comportements de secours nécessaires pour votre expérience. Vous avez ainsi un contrôle total sur la manière dont les problèmes de données produit manquantes sont communiquées à vos utilisateurs.
Exemple de cas d'utilisation
Consultez les cas d'utilisation suivants :
Est-ce que cela a été utile ?