Passer au contenu principal

XR8.run()

XR8.run(canvas, webgl2, ownRunLoop, cameraConfig, glContextConfig, allowedDevices, sessionConfiguration)

Description

Ouvrez l'appareil photo et lancez la boucle d'exécution de l'appareil photo.

Paramètres

PropriétéTypeDéfautDescription
supportHTMLCanvasElementLe canevas HTML sur lequel le flux de la caméra sera dessiné.
webgl2 [Facultatif]BooléenvraiSi vrai, utilisez WebGL2 si disponible, sinon utilisez WebGL1. Si faux, utilisez toujours WebGL1.
ownRunLoop [Facultatif]BooléenvraiSi c'est le cas, XR doit utiliser sa propre boucle d'exécution. Si c’est faux, vous fournirez votre propre boucle d'exécution et serez responsable de l'appel à runPreRender et runPostRender par vous-même [Utilisateurs avancés uniquement]
cameraConfig : {direction} [Facultatif]Objet{direction: XR8.XrConfig.camera().BACK}Appareil photo souhaité. Les valeurs prises en charge pour la direction `` sont XR8.XrConfig.camera().BACK ou XR8.XrConfig.camera().FRONT
glContextConfig [Facultatif]WebGLContextAttributesnulLes attributs permettant de configurer le contexte du support WebGL.
allowedDevices [Facultatif]XR8.XrConfig.device()XR8.XrConfig.device().MOBILE_AND_HEADSETSSpécifiez la classe d'appareils sur lesquels le pipeline doit fonctionner. Si l'appareil actuel ne fait pas partie de cette classe, l'exécution échouera avant l'ouverture de la caméra. Si allowedDevices est XR8.XrConfig.device().ANY, ouvrez toujours la caméra. Notez que le suivi du monde ne peut être utilisé qu'avec XR8.XrConfig.device().MOBILE_AND_HEADSETS ou XR8.XrConfig.device().MOBILE.
sessionConfiguration : {disableXrTablet, xrTabletStartsMinimized, defaultEnvironment} [Facultatif]Objet{}Configurez les options relatives aux différents types de sessions.

sessionConfiguration est un objet doté des propriétés [facultatives] suivantes :

PropriétéTypeDéfautDescription
disableXrTablet [Optionnel]BooléenfauxDésactivez la tablette visible lors des sessions immersives.
xrTabletStartsMinimized [Optional]BooléenfauxLa tablette démarre en mode réduit.
defaultEnvironment {disabled, floorScale, floorTexture, floorColor, fogIntensity, skyTopColor, skyBottomColor, skyGradientStrength} [Facultatif]Objet{}Configurez les options liées à l'environnement par défaut de votre session immersive.

defaultEnvironment est un objet doté des propriétés [facultatives] suivantes :

PropriétéTypeDéfautDescription
désactivé [Facultatif]BooléenfauxDésactive l'arrière-plan "espace vide" par défaut.
floorScale [Facultatif]Nombre1Réduire ou augmenter la texture du sol.
floorTexture [Facultatif]ActifIndiquez une autre ressource de texture ou une autre URL pour le sol carrelé.
floorColor [Facultatif]Couleur hexagonale#1A1C2ADéfinissez la couleur du sol.
fogIntensity [Facultatif]Nombre1Augmenter ou diminuer la densité du brouillard.
skyTopColor [Optionnel]Couleur hexagonale#BDC0D6Définit la couleur du ciel directement au-dessus de l'utilisateur.
skyBottomColor [Optionnel]Couleur hexagonale#1A1C2ADéfinissez la couleur du ciel à l'horizon.
skyGradientStrength [Optionnel]Nombre1Contrôlez la netteté des transitions du dégradé du ciel.

Notes :

  • cameraConfig : Le suivi du monde (SLAM) n'est pris en charge que sur la caméra back . Si vous utilisez la caméra frontale `` , vous devez désactiver le suivi du monde en appelant d'abord XR8.XrController.configure({disableWorldTracking: true}).

Retours

Aucun

Exemple

// Ouvrez la caméra et lancez la boucle d'exécution de la caméra
// Dans index.html :
XR8.run({canvas: document.getElementById('camerafeed')})

Exemple - Utilisation de la caméra frontale (suivi d'image uniquement)

// Désactiver le suivi du monde (SLAM). Cela est nécessaire pour utiliser la caméra frontale.
XR8.XrController.configure({disableWorldTracking: true})
// Ouvrez la caméra et lancez la boucle d'exécution
// Dans index.html :
XR8.run({canvas: document.getElementById('camerafeed'), cameraConfig: {direction: XR8.XrConfig.camera().FRONT}})

Exemple - Définir glContextConfig

// Ouvrez la caméra et commencez à exécuter la boucle d'exécution de la caméra avec un canevas opaque.
// Dans index.html :
XR8.run({canvas: document.getElementById('camerafeed'), glContextConfig: {alpha: false, preserveDrawingBuffer: false}})