Kova dans votre page, en quelques lignes de code.
Le SDK JavaScript place une scène Kova Secure dans une iframe, et vous la pilotez depuis votre propre interface. L’image est calculée sur nos serveurs.
<div id="viewer"></div>
<script type="module">
import { Kova3D }
from 'https://kova3d.com/sdk/kova3d.js';
Kova3D.embed(document.getElementById('viewer'), {
model: 'demo:config-car'
});
</script>
Référence.
Kova3D.embed(element, options) crée l’iframe et renvoie un viewer. Chaque commande attend viewer.ready et renvoie une promesse.
Options d’intégration
model- L’identifiant du modèle.
uinone: la 3D seule (par défaut).configurator: le panneau d’options intégré.themeshowroom, sombre (par défaut), oustudio, clair.turntrue(par défaut) : le modèle tourne lentement.false: il reste immobile.host- L’adresse du moteur. Par défaut, celle d’où le SDK est chargé.
loadinglazy(par défaut) : démarre quand l’iframe approche de l’écran.eager: démarre tout de suite.title- Le titre de l’iframe, lu par les lecteurs d’écran.
Modèles
demo:config-car- La voiture de démonstration.
demo:config-chair- La chaise d’appoint de démonstration.
demo:config-watch- La montre de démonstration.
- Vos modèles
- Sur entente avec Kova.
Exemple
const viewer = Kova3D.embed(document.getElementById('viewer'), {
model: 'demo:config-car'
});
viewer.on('change', (config) => {
console.log(config.groups);
});
await viewer.setOption('wheels', 'turbine');
Méthodes
ready- Promesse résolue quand le modèle est affiché :
{ model, config }. getConfig()- La configuration en cours.
setOption()- Affiche l’option
optionIddu groupegroupId. focus()- Amène la caméra sur le groupe
groupId;nullrevient à la vue d’ensemble. setSlider()- Règle le curseur
sliderIdde 0 à 1 : portes, vue éclatée, animation. setColor()- Teinte la pièce
parten#rrggbb;nulllui rend sa couleur. setMaterial()- Applique le matériau
presetIdà la piècepart;nulllui rend le sien. setTheme()studiooushowroom.setTurn()- Lance ou arrête la rotation.
screenshot()- Une image PNG rendue sur le serveur, à la taille
{ width, height }demandée. on(),off()- Ajoute ou retire un écouteur d’événement.
destroy()- Retire l’iframe et les écouteurs.
Événements
change- Émis après chaque changement, qu’il vienne de votre page, de la 3D ou du panneau intégré. Reçoit la configuration.
select- Un clic sur une pièce :
{ part, name, group }. hover- Le pointeur sur une pièce :
{ part, name }, ounull. error- Une erreur :
{ message }.
Le SDK à l’œuvre.
Ce configurateur est fait uniquement avec le SDK. Pour l’utiliser avec vos modèles, écrivez-nous.
Vous parlez directement à ceux qui font votre 3D, ici au Québec.