La API de estimación de iluminación proporciona datos detallados que te permiten imitar varios indicadores de iluminación al procesar objetos virtuales. ARCore admite tres modos de estimación de luz:
- Inhabilitado
- Modo de intensidad del ambiente
- Modo HDR ambiental
Requisitos previos
Asegúrate de comprender los conceptos fundamentales de RA y cómo configurar una sesión de ARCore antes de continuar.
Habilitar estimación de iluminación
Sigue estos pasos para habilitar la estimación de la iluminación en tu app.
- Configura un proyecto de AR Foundation o un proyecto de extensiones de ARCore.
- En la pestaña Hierarchy, navega a XR Session Origin > AR Camera.
- En el componente AR Camera Manager, selecciona Light Estimation.
- En el menú desplegable Light Estimation, selecciona los modos que deseas usar.
Habilitar el modo HDR ambiental
El modo HDR ambiental habilita la siguiente configuración de estimación de la luz:
- Dirección de la luz principal
- Intensidad de la luz principal
- Armónicos esféricos ambientales
Este modo se habilita automáticamente cuando se cumplen los siguientes criterios:
- En el modo Estimación de luz que proporciona el administrador de la cámara de RA, se seleccionan los armónicos ambiente esféricos, la dirección de la luz principal o la intensidad de la luz principal.
- Los sondeos de entorno están habilitados en un
AREnvironmentProbeManager
- Se seleccionó una configuración de cámara compatible
Habilita el modo de intensidad ambiente
La estimación de luz básica se habilita automáticamente cuando se selecciona el modo de intensidad ambiente en el componente ARCameraManager
.
El modo de intensidad ambiente habilita la siguiente configuración de estimación de la luz:
- Color ambiente
- Intensidad del ambiente
Usa información sobre la iluminación de la escena
Una vez que hayas obtenido la configuración de iluminación correcta, puedes iluminar los objetos virtuales de la escena como si fueran parte del mundo real.
El componente ARCameraManager
puede generar un evento frameReceived
que calcule las condiciones de iluminación de los fotogramas cuando esta estimación esté habilitada. La información de los eventos frameReceived
se almacena en structs ARCameraFrameEventArgs
como ARLightEstimationData
.
Sigue estos pasos para cambiar los parámetros de una lámpara durante el tiempo de ejecución.
- Crea o modifica la luz direccional existente en la escena.
Adjunta una secuencia de comandos nueva a la luz direccional.
// Sample Lighting Estimation script Light light; void Awake () { light = GetComponent<Light>(); } void OnEnable() { if (cameraManager != null) cameraManager.frameReceived += FrameChanged; } void OnDisable() { if (cameraManager != null) cameraManager.frameReceived -= FrameChanged; } void FrameChanged(ARCameraFrameEventArgs args) { // Modify `light` parameters using ARCameraFrameEventArgs. }
Modifica esta nueva secuencia de comandos para detectar cambios en la iluminación. Para ver ejemplos de cómo hacerlo, consulta las secuencias de comandos
BasicLightEstimation.cs
yHDRLightEstimation.cs
de Unity.
Usa sondeos de entorno en tu escena
Sigue estos pasos para habilitar los sondeos del entorno en tu escena.
- Habilita la ubicación automática en el
ARSessionOrigin
de tu escena. - Agrega un componente
AREnvironmentProbeManager
aARSessionOrigin
.