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

Esta guía te muestra cómo usar el complemento Google Cardboard XR para Unity para que Unity cree tu experiencias de realidad virtual (RV).

Nota: Asegúrate de revisar el desarrollo de la marca de Cardboard lineamientos antes de distribuir la 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. R smartphone puede mostrar escenas en 3D con renderización estereoscópica, rastrear y reaccionar con la cabeza e interactuar con las apps detectando cuando el usuario presiona de visualización.

Para comenzar, usarás HelloCardboard, un juego de demostración que muestra las principales del SDK de Cardboard. En el juego, los usuarios miran alrededor de una del mundo para encontrar y recolectar objetos. Allí se indica cómo hacer lo siguiente:

• Configura tu entorno de desarrollo
• Descarga y compila la app de demostración
• Escanea el código QR de un visor Cardboard para guardar sus parámetros
• Realizar 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 RV

Configura tu entorno de desarrollo

Requisitos de software:

• Unity 2021.3.32f1 o una versión posterior
  • Asegúrate de incluir compatibilidad con la compilación de iOS y Android durante la instalación.
• Git debe estar instalado y el ejecutable git debe estar instalado estar en la variable de entorno PATH. Consulta Git administrador de paquetes de Unity documentación de asistencia 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 nuevo proyecto 3D.
2. En Unity, ve a Window > Administrador de paquetes
3. Haz clic en + y selecciona Add package from git URL.
4. Pegar https://github.com/googlevr/cardboard-xr-plugin.git en el texto campo de entrada.
   El paquete se debe agregar a los paquetes instalados.
5. Navega al paquete del complemento Google Cardboard XR para Unity. En la En la sección Samples, elige Import into Project.
   Los recursos de muestra debe cargarse en Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

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

Cómo configurar una escena de HelloCardboard

1. Ve a Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, selecciona Add Open Scenes y elige HelloCardboard. para abrir la escena de muestra.
2. Abre el menú Capas y selecciona Editar capas....
3. Define una nueva capa llamada "Interactive".
4. Haz clic en el GameObject Treasure para abrir la ventana del Inspector. Establece sea "Interactivo". Si aparece una ventana emergente en la que se te pregunta si deseas establece la capa en Interactivo para todos los objetos secundarios, haz clic en "Sí, cambiar elementos secundarios".
5. Haz clic en Reproductor > Cámara > GameObject de CardboardReticlePointer para abre la ventana del Inspector. En la sección "Puntero de retículo de cartón" secuencia de comandos, selecciona "Interactivo" como la máscara de capa de interacción con retículos.

Cómo establecer la configuración del proyecto de Android

Navega a Archivo > Configuración de la compilación.

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

Player Settings

Resolución y presentación

Navega hasta Configuración del proyecto > Reproductor > Resolución y presentación.

1. Establece la Orientación predeterminada en Horizontal izquierda o Horizontal. Derecha.
2. Inhabilita Optimized Frame Pacing.

Nota: Aunque es compatible con el complemento de Cardboard XR, las funciones Vertical y Es posible que las orientaciones retrato al revés no proporcionen suficiente espacio para la vista renderizado en dispositivos.

Otras configuraciones

Navega hasta Configuración del proyecto > Reproductor > Otras opciones de configuración.

1. Elige OpenGLES2, OpenGLES3, 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 Nivel de servicio.
3. Selecciona API level 33 o una versión posterior en el Nivel de API objetivo.
4. Selecciona IL2CPP en Backend de secuencias de comandos.
5. Para seleccionar las arquitecturas deseadas, elige ARMv7, ARM64 o ambas opciones en Arquitecturas de destino.
6. Selecciona Require en Acceso a Internet.
7. Especifica el dominio de tu empresa en Package Name.
8. Si se seleccionó Vulkan como API de Graphics:
   • Desmarca la casilla de verificación Aplicar rotación de pantalla durante la renderización en Vulkan Configuración.
   • Si la versión de Unity es 2021.2 o una posterior, selecciona ETC2 en Texture. formato de compresión.
9. Si la versión de Unity es 2023.1 o una posterior, selecciona Activity y borra GameActivity en el punto de entrada de la aplicación.

Nota: Si cambias la API de renderización, puedes usar un nivel de API mínimo más bajo. compatibilidad. Para obtener más información, consulta el SDK build.gradle.

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

Nota: OpenGL ES 2.0 ya no es compatible con Unity 2023.1 y versiones posteriores. Para versiones más recientes usan OpenGL ES 3.0 o Vulkan. Para obtener más información, consulta la Compatibilidad y requisitos de Android en el manual de Unity.

Configuración de publicación

Navega hasta Configuración del proyecto > Reproductor > Configuración de la publicación.

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.6.1'
     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 un versión diferente de la más reciente, echa un vistazo a la historia de la sección de dependencias en sdk/build.gradle del repositorio del SDK de Cardboard.

Configuración de la administración de complementos XR

Navega hasta Configuración del proyecto > Administración de complementos XR.

1. Selecciona Cardboard XR Plugin en Proveedores de complementos.

Cómo compilar un proyecto

Navega a Archivo > Configuración de la compilación.

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

Establece la configuración del proyecto de iOS

Navega a Archivo > Configuración de la compilación.

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

Player Settings

Resolución y presentación

Navega hasta Configuración del proyecto > Reproductor > Resolución y presentación.

1. Establece la Orientación predeterminada en Horizontal izquierda o Horizontal. Derecha.

Nota: Aunque es compatible con el complemento de Cardboard XR, las funciones Vertical y Es posible que las orientaciones retrato al revés no proporcionen suficiente espacio para la vista renderizado en dispositivos.

Otras configuraciones

Navega hasta Configuración del proyecto > Reproductor > Otras opciones de configuración.

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 Objetivo mínimo de la versión de iOS, escribe 12.0.
3. Especifica el dominio de tu empresa en Package Name.

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

Configuración de la administración de complementos XR

Navega hasta Configuración del proyecto > Administración de complementos XR.

1. Selecciona Cardboard XR Plugin en Proveedores de complementos.

Cómo compilar un proyecto

Navega a Archivo > Configuración de la compilación.

1. Selecciona Build o Build and Run.

Volver a centrar

El SDK de Cardboard te permite hacer lo siguiente: volver a centrar el monitor de cabeza con Recenter()

Sigue estos pasos para probarlo con la aplicación de muestra:

1. Mueve el dispositivo a la posición en la que quieras volver a centrar (usar como nuevo diseño postura de la cabeza hacia adelante).
2. Mantén el activador de tu dispositivo Cardboard activo durante al menos tres segundos.
3. Suelta el activador.
4. Ahora, la pose inicial es la dirección hacia la que apunta la cámara.

Cómo activar y desactivar el modo RV

La administración de complementos de Unity XR te permite convertir Modo RV activado o desactivado para el complemento Google Cardboard XR para Unity Documentación para usuarios finales y ejemplos de uso están disponibles en la pestaña End-user documentación.

La escena VrMode del ejemplo de HelloCardboard muestra un uso básico de antes mencionada. En esta escena, el modo RV se puede desactivar presionando salir y se puede volver a activar solo una presionando en cualquier parte de la pantalla. Cheque 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.