Utilisation des widgets > 3D > Cible dynamique
Cible dynamique
* 
Actuellement, seuls les modèles cibles sont pris en charge par les cibles dynamiques. Pour garantir un fonctionnement adéquat, l'URL de ressource doit être définie avant l'accès à la vue contenant la cible dynamique. Pour optimiser l'utilisation, pensez à créer une vue secondaire pour gérer la liaison avec un paramètre d'application.
A quoi sert ce widget ?
Le widget Cible dynamique permet de charger différents jeux de données cibles à partir de ressources locales et distantes. Selon votre cas d'utilisation, il peut charger dynamiquement n'importe quelle cible requise durant l'exécution.
Quand faut-il utiliser ce widget ?
Utilisez une cible dynamique lorsque vous souhaitez référencer des modèles cibles dans votre expérience qui peuvent être chargés dynamiquement lors de l'exécution, ou si vous souhaitez référencer une ressource de cible externe.
Pour plus d'informations, consultez la rubrique Cas d'utilisation : Charger et comparer des actifs de manière dynamique.
Cible dynamique et modèle cible
Vous devez utiliser des modèles cibles lorsque vous souhaitez définir et générer ce type de cible directement dans votre expérience. Cette approche est idéale pour les configurations statiques mais n'est pas optimale pour la réutilisation des actifs.
Dans les cas où vous devez charger des actifs de modèle cible prégénérés, qu'ils soient hébergés dans votre Experience Service, fournis avec l'expérience ou diffusés à partir d'une source tierce, il est préférable d'utiliser le widget Cible dynamique. Ce widget permet une plus grande flexibilité d'exécution ; il n'inclut pas l'Editeur de modèles cibles car il suppose que vos actifs sont déjà préparés et accessibles.
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
Ressource
src
string/resource_url
URL directe du fichier .dat. Elle doit inclure le chemin d'accès complet au fichier, y compris le suffixe .dat. Par exemple : app/resources/Uploaded/mytarget.dat
* 
Les vues guides doivent être incluses dans le fichier .dat.
Ressource externe
srcType
boolean
Cochez cette case si vous utilisez une ressource externe, puis entrez l'URL. Par exemple : https://myserver/mytarget.dat
Cette propriété modifie le datatype de Ressource et active un menu déroulant pour les fichiers de projet locaux ou un champ d'entrée pour les liens externes.
Type de cible
targetType
string
Définit le type de cible de la ressource liée. Ce champ n'est pas modifiable et est défini sur vuforia-model://.
* 
Ne modifiez pas cette propriété via JavaScript, car actuellement, seuls les modèles cibles sont pris en charge.
Suivi
isTracked
boolean
Activé lorsque la caméra reconnaît la cible.
Fixe
stationary
boolean
Sélectionnez cette case à cocher si la cible sera utilisée dans un environnement stable et ne sera pas déplacée par l'utilisateur. La sélection de cette case à cocher peut améliorer les performances du suivi.
Taille de cible
size
number
Définit la largeur de la cible. Cela peut être utile lorsque la cible est générée avec les mesures des données CAO, mais que le suivi s'effectue sur un modèle plus petit.
Evénement
JavaScript
Description
Suivi acquis
trackingacquired
Déclenché lorsque le suivi est initialisé.
Suivi perdu
trackinglost
Déclenché lorsque le suivi est perdu.
Cible chargée
targetLoaded
Déclenché lorsque la cible est complètement chargée.
Exemple de cas d'utilisation
Limitations connues
Limitation
Recommandation et solution de contournement
Lors de l'utilisation d'un widget Cible dynamique (éventuellement en combinaison avec un widget Produit), l'aimantation à la cible peut échouer si l'application est mise en arrière-plan alors que la cible est encore en cours de chargement. Lors du retour au premier plan, il est possible que l'expérience ne reprenne pas correctement le suivi.
Recommandation : Restez dans l'application jusqu'à ce que la cible ait été complètement chargée afin de garantir le bon fonctionnement de l'aimantation.
Solution de contournement : Si le problème se produit, rechargez simplement l'expérience dans Vuforia View pour restaurer la fonctionnalité.
Est-ce que cela a été utile ?