Intégration Web
Intégrer le viewer 3D avec une iframe
L’iframe affiche le modèle public dans une surface dédiée, sans navigation Studio ni bannière analytics DevXR.
Prérequis et responsabilité
Le modèle doit être traité, enregistré et publié. Le site parent reste responsable de son propre consentement, de son texte autour du viewer et de son accessibilité.
L’iframe DevXR bloque les analytics optionnels et ne présente pas sa propre bannière de consentement. Cette absence ne donne aucun consentement au site parent.
Code d’intégration responsive
Copiez le code fourni par Studio, conservez l’origine viewer.devxr.fr et remplacez uniquement l’exemple synthétique par le code généré pour votre modèle.
- Exemple : <iframe src="https://viewer.devxr.fr/embed/pub_example_not_real" title="Modèle 3D du produit" loading="lazy" allowfullscreen></iframe>
Ajoutez un conteneur
Donnez-lui une largeur de 100 %, un ratio adapté et une hauteur minimale utilisable.
Ajoutez un titre
Décrivez le modèle dans l’attribut title pour les technologies d’assistance.
Autorisez le plein écran si utile
Conservez allowfullscreen lorsque votre présentation propose cette action.
Testez le parent réel
Contrôlez ordinateur, mobile, clavier, redimensionnement et politique de sécurité du site hôte.
À propos des domaines autorisés
Une liste vide correspond au comportement produit « intégration non restreinte par domaine ». Une liste renseignée doit contenir des origines HTTPS exactes, sans chemin ; HTTP est réservé au loopback local de développement.
La garantie navigateur repose sur la directive CSP frame-ancestors reçue dans la réponse HTML finale. Tant que le déploiement edge Caddy de viewer.devxr.fr n’a pas été validé sur l’environnement final, cette restriction reste conditionnelle et ne doit pas être présentée comme une protection active de bout en bout.
Dépannage
Un cadre vide peut venir d’un modèle dépublié, d’une URL recopiée, d’une CSP du site parent ou d’une origine refusée. Inspectez la console et la réponse HTML finale sans désactiver globalement les protections du navigateur.