Fonctionnalité
Intégrer la visite à votre site
Une iframe, trois lignes, aucun plugin. Et surtout : aucun cookie ni identifiant persistant - la première question que pose un service juridique, et celle qui fait traîner une intégration six semaines.
Trois façons d’intégrer
Par ordre de simplicité. La première suffit dans 90 % des cas.
- Étape 01
Copier-coller l’iframe
Le bouton « Partager » de la visite fournit le code prêt à coller, avec le bon ratio et le chargement différé déjà réglés.
- Étape 02
Coller l’URL (oEmbed)
Sur WordPress, Notion, Slack ou tout outil compatible oEmbed, collez simplement le lien de la visite : l’aperçu interactif se construit tout seul.
- Étape 03
Le bloc HTML personnalisé
Sur un site fait main ou un CMS restrictif, un bloc HTML avec l’iframe suffit. Aucune bibliothèque JavaScript à charger.
- Étape 04
Piloter depuis la page
Pour aller plus loin, l’iframe accepte des messages : ouvrir une scène précise, lancer la rotation, écouter les changements de vue.
Le code
Les trois lignes à coller
Le bouton Partager de la visite les fournit déjà remplies. Les voici en clair, pour que vous sachiez exactement ce que vous collez.
<iframe src="https://embed.moorea.app/VOTRE-LIEN" style="aspect-ratio:16/9;width:100%;border:0" loading="lazy" allowfullscreen></iframe>
Le ratio plutôt qu’une hauteur fixe. aspect-ratio garde la visite lisible sur téléphone comme sur grand écran. Une hauteur en pixels donne une bande écrasée sur mobile, et c’est le défaut d’intégration le plus fréquent.
loading="lazy" n’est pas optionnel. Sans lui, l’iframe se charge même si le visiteur ne descend jamais jusqu’à elle. Avec lui, le coût avant interaction est proche de zéro.
allowfullscreen ouvre le plein écran. C’est une ligne, et c’est ce qui transforme une vignette en visite.
Aller plus loin
Piloter la visite depuis votre page
L’iframe accepte des messages, dans les deux sens. C’est ce qui permet de relier la visite au reste de la page - un plan cliquable, un onglet, un bouton.
Ce que vous pouvez envoyer : goToScene pour ouvrir une scène précise, goToGroup pour un groupe, lookAt pour viser une direction, setAutorotate pour lancer ou arrêter la rotation, getState pour interroger la visite.
Ce que la visite vous renvoie : ready quand elle est prête, sceneChange à chaque changement de scène, viewChange pour le mouvement de caméra, hotspotClick quand un point est cliqué.
Le relais n’accepte que les messages du parent direct : une page tierce ne peut pas piloter une visite intégrée chez vous.
Dès le plan Pilot, les domaines d’intégration autorisés restreignent en plus l’affichage aux sites que vous listez.
Les trois pièges classiques
Une intégration ratée l’est presque toujours pour la même raison : le poids, le consentement, ou le ratio.
Le poids. Une iframe chargée immédiatement en haut de page retarde l’affichage du reste. L’attribut loading="lazy" - fourni dans le code de partage - ne charge la visite que lorsqu’elle approche de l’écran. Avant l’interaction, le coût est proche de zéro.
Le consentement. La plupart des lecteurs vidéo et des visites concurrentes posent des cookies tiers, ce qui les fait tomber sous le régime du consentement : l’iframe reste alors grisée tant que le visiteur n’a pas accepté. Le lecteur Moorea n’en pose aucun, par conception.
Le ratio. Une visite écrasée dans un bloc de 200 pixels de haut ne donne envie à personne. Le code de partage impose un ratio 16:9 fluide, qui s’adapte à la largeur disponible sans déformer l’image.
Questions
Faut-il un plugin WordPress ?
Non. Collez l’URL de la visite dans un paragraphe : WordPress interroge notre point oEmbed et construit l’aperçu. Sinon, un bloc HTML personnalisé avec l’iframe fonctionne partout.
L’intégration ralentit-elle mon site ?
Pas si elle est en chargement différé, ce qui est le réglage fourni. Tant que le visiteur n’a pas fait défiler jusqu’à elle, rien n’est téléchargé. Le lecteur lui-même pèse environ 142 kilo-octets gzip sur le chemin critique, mesurés à chaque build.
Peut-on ouvrir la visite sur un point de vue précis ?
Oui, en ajoutant un paramètre à l’URL d’intégration. C’est utile pour lier la page « Piscine » de votre site directement à la vue de la piscine.
Peut-on empêcher l’intégration sur d’autres sites ?
Oui. Dès le plan Pilot, vous déclarez la liste des domaines autorisés à afficher vos visites en iframe ; ailleurs, le cadre reste vide.
Essayez sur une page de test
Créez un compte, publiez une visite de démonstration et collez son code sur une page brouillon de votre site. Dix minutes suffisent pour lever le doute.