Guía de inicio rápido de Google Cardboard para Unity

En esta guía, se muestra cómo usar el complemento de Google Cardboard XR para Unity para crear tus propias experiencias de realidad virtual (RV).

Nota: Asegúrate de revisar los lineamientos de desarrollo de la marca de Cardboard antes de distribuir tu app a un público más amplio.

Puedes usar el SDK de Cardboard para convertir un teléfono celular en una plataforma de RV. Un dispositivo móvil puede mostrar escenas en 3D con renderización estereoscópica, hacer un seguimiento de los movimientos de la cabeza y reaccionar a ellos, y detectar cuándo el usuario presiona el botón del visor para interactuar con las apps.

Para comenzar, usarás HelloCardboard, un juego de demostración que muestra las funciones principales del SDK de Cardboard. En el juego, los usuarios exploran un mundo virtual para encontrar y recopilar objetos. En él, se muestra cómo hacer lo siguiente:

• Configura tu entorno de desarrollo
• Descarga y compila la app de demostración
• Cómo escanear el código QR de un visor Cardboard para guardar sus parámetros
• Hacer un seguimiento de los movimientos de la cabeza del usuario
• Renderiza imágenes estereoscópicas configurando la distorsión correcta para cada ojo
• Cómo activar y desactivar el modo de VR

Configura tu entorno de desarrollo

Requisitos de software:

• Unity 6000.0.23f1 o una versión posterior
  • Asegúrate de incluir la compatibilidad con compilación para iOS y Android durante la instalación.
  • Asegúrate de instalar la versión de parche 23f1 o posterior.
• Git debe estar instalado y el ejecutable git debe estar en la variable de entorno PATH. Consulta los documentos sobre la compatibilidad con Git del administrador de paquetes de Unity para obtener más detalles.

Importa el SDK y crea un proyecto nuevo

Sigue estos pasos para importar el SDK de Unity y crear un proyecto nuevo.

1. Abre Unity y crea un proyecto 3D nuevo.
2. En Unity, ve a Window > Package Manager.
3. Haz clic en + y selecciona Add package from git URL.
4. Pega https://github.com/googlevr/cardboard-xr-plugin.git en el campo de entrada de texto.
   El paquete se debe agregar a los paquetes instalados.
5. Navega al paquete Google Cardboard XR Plugin for Unity. En la sección Samples, elige Import into Project.
   Los recursos de muestra se deben cargar en Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Nota: <version> es el número de versión semántica X.Y.Z del paquete lanzado (por ejemplo, 1.1.0).

Configura la escena de HelloCardboard

1. Navega a Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, selecciona Add Open Scenes y elige HelloCardboard para abrir la escena de ejemplo.
2. Abre el menú Capas y selecciona Editar capas….
3. Define una nueva capa llamada "Interactive".
4. Haz clic en el objeto de juego Treasure para abrir la ventana del Inspector. Establece su capa como "Interactive". Si aparece una ventana emergente que te pregunta si también quieres establecer la capa como interactiva para todos los objetos secundarios, haz clic en "Sí, cambiar los secundarios".
5. Haz clic en el objeto de juego Player > Camera > CardboardReticlePointer para abrir la ventana Inspector. En la secuencia de comandos "Puntero de retículo de Cardboard", selecciona "Interactivo" como la Máscara de capa de interacción del retículo.

Cómo configurar los parámetros de compilación de Android

Navega a File > Build Settings.

1. Selecciona Android y elige Switch Platform.
2. Selecciona Add Open Scenes y elige HelloCardboard.

Player Settings

Ve a Editar > Configuración del proyecto….

Configura los parámetros de resolución y presentación

Navega a Reproductor > Resolución y presentación.

1. Establece la orientación predeterminada en Horizontal (izquierda) o Horizontal (derecha).
2. Inhabilita Optimized Frame Pacing.

Nota: Si bien el complemento de Cardboard XR admite las orientaciones Vertical y Vertical invertida, es posible que no proporcionen suficiente espacio para la renderización de los ojos en los dispositivos.

Configura Otros parámetros de configuración

Navega a Player > Other Settings.

1. Elige OpenGLES2, OpenGLES3 o Vulkan, o cualquier combinación de ellos en APIs de gráficos.
2. Selecciona Android 8.0 'Oreo' (API level 26) o una versión posterior en Minimum API Level.
3. Selecciona API level 35 o una versión posterior en Target API Level.
4. Selecciona IL2CPP en Scripting Backend.
5. Selecciona las arquitecturas deseadas eligiendo ARMv7, ARM64 o ambas en Target Architectures.
6. Selecciona Require en Acceso a Internet.
7. Selecciona Input System Package (New) en Active Input Handling.
8. Especifica el dominio de tu empresa en Package Name.
9. Si se seleccionó Vulkan como API de gráficos, haz lo siguiente:
   • Borra la casilla de verificación Aplicar rotación de pantalla durante el procesamiento en Configuración de Vulkan.
   • Selecciona ETC2 en Formato de compresión de texturas.
10. Selecciona Activity y borra GameActivity en Punto de entrada de la aplicación.

Nota: Es posible usar un nivel de API mínimo inferior si se cambia la compatibilidad de la API de renderización. Para obtener más información, consulta el build.gradle del SDK.

Nota: Si tienes problemas para seleccionar Vulkan como la API de gráficos, marca la casilla Development Build en Build Settings y analiza los registros de tiempo de ejecución en busca de errores de compatibilidad del controlador.

Nota: OpenGL ES 2.0 ya no es compatible con Unity 2023.1 ni versiones posteriores. Para las versiones más recientes, usa OpenGL ES 3.0 o Vulkan. Para obtener más información, consulta la página Requisitos y compatibilidad con Android en el manual de Unity.

Configura los parámetros de publicación

Navega a Player > Publishing Settings.

1. En la sección Compilación, selecciona Custom Main Gradle Template y Custom Gradle Properties Template.

2. Agrega las siguientes líneas a la sección de dependencias de Assets/Plugins/Android/mainTemplate.gradle:

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Agrega las siguientes líneas a Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

Nota: Las dependencias necesarias pueden cambiar entre versiones. Si quieres usar una versión diferente de la versión más reciente, consulta el historial de la sección de dependencias en sdk/build.gradle del repositorio del SDK de Cardboard.

Configura los ajustes de administración de complementos de XR

Navega a XR Plug-in Management.

1. Selecciona Cardboard XR Plugin en Proveedores de complementos.

Cómo compilar un proyecto

Navega a File > Build Settings.

1. Selecciona Build o elige un dispositivo y selecciona Build and Run.

Cómo configurar los parámetros del proyecto de iOS

Navega a File > Build Settings.

1. Selecciona iOS y elige Switch Platform.
2. Selecciona Add Open Scenes y elige HelloCardboard.

Player Settings

Ve a Editar > Configuración del proyecto….

Configura los parámetros de resolución y presentación

Navega a Player > Resolution and Presentation.

1. Establece la orientación predeterminada en Horizontal (izquierda) o Horizontal (derecha).

Nota: Si bien el complemento de Cardboard XR admite las orientaciones Vertical y Vertical invertida, es posible que no proporcionen suficiente espacio para la renderización de los ojos en los dispositivos.

Configura Otros parámetros de configuración

Navega a Player > Other Settings.

1. En Camera Usage Description, escribe Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. En Target minimum iOS Version, escribe 12.0.
3. Especifica el dominio de tu empresa en Package Name.
4. Marca Top Edge, Left Edge y Right Edge en Posponer los gestos del sistema en los bordes.

Nota: Si usas un iPhone X, selecciona la opción Ocultar el botón de inicio en el iPhone X.

Configura los ajustes de administración de complementos de XR

Navega a XR Plug-in Management.

1. Selecciona Cardboard XR Plugin en Proveedores de complementos.

Cómo compilar un proyecto

Navega a File > Build Settings.

1. Selecciona Build o Build and Run.

Volver a centrar

El SDK de Cardboard te permite volver a centrar el sensor de seguimiento de la cabeza con Recenter().

Sigue estos pasos para probarla con la aplicación de ejemplo:

1. Mueve el dispositivo a la posición en la que deseas volver a centrarlo (úsalo como una nueva posición de la cabeza mirando hacia adelante).
2. Mantén el gatillo del dispositivo Cardboard activo durante al menos tres segundos.
3. Suelta el gatillo.
4. La posición inicial ahora está en la dirección hacia la que apunta la cámara.

Cómo activar y desactivar el modo de VR

La API de Unity XR Plugin Management te permite activar o desactivar el modo de RV para el complemento Google Cardboard XR para Unity. La documentación para el usuario final y los ejemplos de uso están disponibles en la documentación para el usuario final de Unity.

La escena VrMode en el ejemplo de HelloCardboard muestra un uso básico de la API mencionada anteriormente. En esta escena, puedes desactivar el modo de RV presionando Salir y volver a activarlo presionando en cualquier lugar de la pantalla. Consulta VrModeController.cs para obtener detalles sobre cómo se realiza esta acción.

Próximos pasos

• Revisa los lineamientos de desarrollo de la marca de Cardboard.