XR8.PlayCanvas.run()

XR8.PlayCanvas.run( {pcCamera, pcApp}, [extraModules], config )

Descripción

Añada los Módulos de canalización especificados y luego abra la cámara.

Parámetros

Parámetro	Tipo	Descripción
pcCamera	pc.CameraComponent	La cámara de escena PlayCanvas para conducir con RA.
pcApp	pc.Aplicación	La aplicación PlayCanvas, normalmente this.app.
extraModules [Opcional]	[Objeto]	Un conjunto opcional de módulos de canalización adicionales para instalar.
config	{canvas, webgl2, ownRunLoop, cameraConfig, glContextConfig, allowedDevices, layers}	Parámetros de configuración para pasar a XR8.run() así como configuración específica de PlayCanvas, por ejemplo capas.

config es un objeto con las siguientes propiedades:

Propiedad	Tipo	Por defecto	Descripción
canvas	HTMLCanvasElement		El lienzo HTML en el que se dibujará la imagen de la cámara. Normalmente es document.getElementById('application-canvas').
webgl2 [Optional]	Booleano	false	Si es verdadero, utiliza WebGL2 si está disponible; si no, pasa a WebGL1. Si es falso, utiliza siempre WebGL1.
ownRunLoop [Opcional]	Booleano	false	Si es verdadero, XR debe utilizar su propio bucle de ejecución. Si es falso, usted proporcionará su propio bucle de ejecución y será responsable de llamar usted mismo a ``XR8.runPreRender() y XR8.runPostRender() [Solo usuarios avanzados]
configuración de la cámara: {direction} [Opcional]	Objeto	{direction: XR8.XrConfig.camera().BACK}	Cámara que desea utilizar. Los valores admitidos para la dirección son XR8.XrConfig.camera().BACK o XR8.XrConfig.camera().FRONT
glContextConfig [Opcional]	WebGLContextAttributes	nulo	Los atributos para configurar el contexto del lienzo WebGL.
allowedDevices [Optional]	XR8.XrConfig.device()	XR8.XrConfig.device().MOBILE	Especifique la clase de dispositivos en los que debe ejecutarse la canalización. Si el dispositivo actual no pertenece a esa clase, la ejecución fallará antes de abrir la cámara. Si allowedDevices es XR8.XrConfig.device().ANY, abra siempre la cámara. Tenga en cuenta que el seguimiento mundial solo puede utilizarse con XR8.XrConfig.device().MOBILE.
layers [Optional]	[]	[]	Especifique la lista de capas a dibujar utilizando GlTextureRenderer. La clave es el nombre de la capa de 8th Wall, y el valor es una lista de nombres de capas de PlayCanvas que debemos renderizar en una textura y máscara utilizando la capa de 8th Wall. Valor de ejemplo: {"sky": ["FirstSkyLayer", "SecondSkyLayer"]}.

Returns

Ninguno

Ejemplo

var layerscontroller = pc.createScript('layerscontroller')

layerscontroller.prototype.initialize = function() {
 // Después de que XR se haya cargado completamente, abre el feed de la cámara y empieza a mostrar AR.
  const runOnLoad = ({pcCamera, pcApp}, extramodules) => () => {
 // Introduce el nombre de su lienzo. Normalmente es el "lienzo de la aplicación".
    const config = {
      canvas: document.getElementById('application-canvas'),
      layers: {"sky": ["Sky"]}
    }
    XR8.PlayCanvas.run({pcCamera, pcApp}, extraModules, config)
 }

 // Encuentre la cámara en la escena PlayCanvas, y vincúlala al movimiento del teléfono del usuario en el
 // mundo.
  const pcCamera = XRExtras.PlayCanvas.findOneCamera(this.entity)

 // Mientras XR aún se está cargando, muestra algunas cosas útiles.
  // Almost There: Detecta si el entorno del usuario puede soportar web ar, y si no es así,
 // muestra sugerencias sobre cómo ver la experiencia.
  // Cargando: muestra solicitudes de permiso para la cámara y oculta la escena hasta que esté lista para ser mostrada.
  // Error de tiempo de ejecución: Si algo inesperado sale mal, muestra una pantalla de error.
  XRExtras.Loading.showLoading({onxrloaded: runOnLoad({pcCamera, pcApp: this.app}, [
 // Módulos opcionales que los desarrolladores pueden desear personalizar o tematizar.
    XRExtras.AlmostThere.pipelineModule(), // Detecta los navegadores no compatibles y da pistas.
    XRExtras.Loading.pipelineModule(),           // Gestiona la pantalla de carga al inicio.
    XRExtras.RuntimeError.pipelineModule(),      // Muestra una imagen de error.
    XR8.LayersController.pipelineModule(), // Añade soporte para Efectos Cielo.
  ])})
}