Compilar aplicación en Unity para Oculus Quest

¿Qué contiene esta entrada?

  • Intro­duc­ción, qué vamos a hac­er y qué se necesita
  • Un vídeo sobre cómo con­fig­u­rar el motor Uni­ty para com­pi­lar apli­ca­ciones para Ocu­lus Quest
  • Infor­ma­ción sobre pro­gra­mas nece­sar­ios y pasos previos
  • Infor­ma­ción detal­la­da sobre la con­fig­u­ración del motor Uni­ty para com­pi­lar para Ocu­lus Quest

Introducción

En este artícu­lo vemos cómo con­fig­u­rar un proyec­to de Uni­ty para crear com­pi­la­ciones para Ocu­lus Quest 2, para esto vamos a usar el paque­te "Ocu­lus Inte­gra­tion SDK" para Uni­ty el cual con­tiene todo lo nece­sario para comen­zar a crear apps de real­i­dad vir­tu­al para Ocu­lus, además viene con mod­e­los 3D y ejem­p­los útiles. Vamos a repasar cada con­fig­u­ración nece­saria, crear una com­pi­lación y cor­rerla en un dis­pos­i­ti­vo Ocu­lus Quest.

Este artícu­lo cuen­ta con un vídeo que resume la infor­ma­ción, puedes ver­lo a continuación.

🟢 Cómo con­fig­u­rar Uni­ty para com­pi­lar apli­cación para Ocu­lus Quest

Requisitos previos

Módulos Android instalados en Unity

Para poder com­pi­lar apli­ca­ciones para Ocu­los Quest se nece­si­ta ten­er insta­l­a­do el motor Uni­ty con el módu­lo de Android, que con­siste en las sigu­ientes tres aplicaciones:

aplicaciones necesarias para compilar aplicación para oculus quest con unity
Fig. 1: Se requieren estos módu­los insta­l­a­dos en Uni­ty HUB para com­pi­lar para Ocu­lus Quest.

Oculus Quest SDK — Paquete de Oculus para Unity

Vamos a descar­gar e impor­tar el paque­te Ocu­lus Quest SDK para Uni­ty el cual viene con muchos Assets útiles que nos facil­i­tarán la creación de apli­ca­ciones VR para Oculus.

Crear cuenta de desarrollador para Oculus

Es nece­saria una cuen­ta de desar­rol­lador de Ocu­lus para poder pub­licar apli­ca­ciones en la tien­da de Oculus

Oculus Developer HUB (Software auxiliar para desarrollar y publicar aplicaciones para Oculus)

Ocu­lus Devel­op­er HUB per­mite recono­cer el dis­pos­i­ti­vo Ocu­lus des­de el orde­nador, con­fig­u­rar­lo, acced­er a las imá­genes y vídeos cap­tura­dos y per­mite pub­licar apli­ca­ciones en la tien­da de Oculus.

Oculus Android App

La apli­cación para móviles de Ocu­lus nos per­mite con­fig­u­rar nue­stro dis­pos­i­ti­vo Ocu­lus y acti­var el modo desar­rol­lador para nue­stro dispositivo.

Oculus App para PC (Opcional)

La apli­cación de Ocu­lus nos per­mite uti­lizar apli­ca­ciones de real­i­dad vir­tu­al para PC con nue­stro Ocu­lus, lo cual se puede hac­er por cable o con la conex­ión AirLink.

Cómo configurar Unity para exportar aplicaciones para Oculus Quest

Aho­ra vamos a ver qué parámet­ros ten­emos que con­fig­u­rar en el motor para poder expor­tar para Ocu­lus, para esto creo un proyec­to en blan­co con el que vamos a ver todos los pasos.

Configurar plataforma Android como objetivo

Los dis­pos­i­tivos Ocu­lus Quest uti­lizan Android como sis­tema oper­a­ti­vo por lo que en primer lugar vamos a File > Build Set­tings y vamos a cam­biar la platafor­ma obje­ti­vo a Android, como se obser­va en la figu­ra 2.

ventana build settings para configurar parámetros de compilación, elegir android para compilar para oculus quest
Fig. 2: Cam­biar la platafor­ma obje­ti­vo para la compilación.

En este caso voy a uti­lizar el dis­pos­i­ti­vo Ocu­lus Quest 2, con el dis­pos­i­ti­vo conec­ta­do abro la apli­cación Ocu­lus Devel­op­er HUB para com­pro­bar que el sis­tema oper­a­ti­vo reconoce el dis­pos­i­ti­vo, si ten­emos éxi­to deberíamos ver nue­stro dis­pos­i­ti­vo como en la figu­ra 3.

Ventana de dispositivo del programa Oculus Developer HUB. Oculus Quest conectado
Fig. 3: Ven­tana de dis­pos­i­ti­vo del pro­gra­ma Ocu­lus Devel­op­er HUB.

Además en Uni­ty, en la pes­taña Build Set­tings debería apare­cer el dis­pos­i­ti­vo en el cam­po "Run Device", como se mues­tra en la figu­ra 4. Si no vemos el dis­pos­i­ti­vo hay que volver a la parte de req­ui­si­tos pre­vios, prob­a­ble­mente no se ha acti­va­do el modo desar­rol­lador o hay que acti­var la depu­ración USB.

ventana build settings para configurar parámetros de compilación, elegir android para compilar para oculus quest
Fig. 4: En la ven­tana Build Set­tings aparece el dis­pos­i­ti­vo conectado.

Importación del paquete Oculus SDK para Unity

Impor­ta­mos el paque­te Ocu­lus SDK (link para descar­gar en la parte de arri­ba de req­ui­si­tos previos).

En este caso vamos a agre­gar todos los archivos que vienen en el paquete.

importación del paquete oculus sdk para unity, con assets útiles para el desarrollo de juegos y aplicaciones para oculus quest
Fig. 5: Ven­tana para impor­tar el paque­te Ocu­lus SDK para Unity.

En este pun­to nos apare­cen var­ios carte­les con men­sajes solic­itán­donos una acción.

En gen­er­al para todos los men­sajes eli­jo las opciones recomen­dadas y las más actuales, en el caso de la figu­ra 6 le damos a "Yes", en el caso de la figu­ra 7 a "Use OpenXR".

Mensaje que aparece al importar el paquete Oculus SDK
Fig. 6: Men­saje que aparece al impor­tar el paque­te Ocu­lus SDK.
Mensaje que aparece al importar el paquete Oculus SDK
Fig. 7: Men­saje que aparece al impor­tar el paque­te Ocu­lus SDK.

Puede que nos solicite reini­ciar el edi­tor Uni­ty, en cuyo caso reini­ci­amos el editor.

Mensaje que aparece al importar el paquete Oculus SDK
Fig. 8: Men­saje que aparece al impor­tar el paque­te Ocu­lus SDK.

Las fig­uras 9 y 10 son otro ejem­p­lo de men­sajes que pueden apare­cer, apli­co el mis­mo cri­te­rio, eli­jo las opciones más actuales y reini­cio de ser necesario.

Mensaje que aparece al importar el paquete Oculus SDK
Fig. 9: Men­saje que aparece al impor­tar el paque­te Ocu­lus SDK.
Mensaje que aparece al importar el paquete Oculus SDK
Fig. 10: Men­saje que aparece al impor­tar el paque­te Ocu­lus SDK.

Al momen­to de grabar el vídeo y escribir este artícu­lo, al pasar por todo el pro­ce­so de con­fig­u­ración del paque­te Ocu­lus SDK para Uni­ty, luego de reini­ciar el edi­tor por últi­ma vez se abre una esce­na ejem­p­lo en la que se mues­tra un Avatar con Lip­Sync (sin­cronización de labios con el input del micró­fono, figu­ra 11). Vamos a com­pi­lar esta mis­ma esce­na por lo que abri­mos la pes­taña Build Set­tings (en File) y le damos al botón "Add Open Scene" para agre­gar la esce­na abier­ta a la com­pi­lación que vamos a crear.

ejemplo de escena para desarrollo de aplicaciones de realidad virtual para oculus usando unity
Fig. 11: Esce­na de ejem­p­lo que se abre al reini­ciar Unity.
ventana build settings para configurar parámetros de compilación, elegir android para compilar para oculus quest
Fig. 12: Se agre­ga la esce­na abier­ta a la compilación.

Configuración del plugin XR Management

El sigu­iente paso de la con­fig­u­ración es ir a la ven­tana "Play­er Set­tings", podemos hac­er­lo des­de "Edit" y tam­bién ten­emos un acce­so direc­to des­de la ven­tana Build Set­tings como se mues­tra en la figu­ra 13.

Acceso directo a la ventana Player Settings para configurar parámetros de la compilación.
Fig. 13: Acce­so direc­to a la ven­tana Play­er Set­tings para con­fig­u­rar parámet­ros de la compilación.

En la ven­tana Play­er Set­tings vamos al ele­men­to "XR Plu­g­in Man­age­ment" y le damos clic al botón para insta­lar que se obser­va en la figu­ra 15.

Plugin XR Plugin Management
Fig. 14: Sec­ción XR Plu­g­in Managment.
Plugin XR Plugin Management
Fig. 15: Insta­lación del Plu­g­in XR Plu­g­in Managmente.

Una vez insta­l­a­do el plu­g­in le damos clic a la casil­la "Ocu­lus" que nos aparece y esa acción hace que aparez­ca un nue­vo ele­men­to lla­ma­do Ocu­lus deba­jo del plu­g­in (figu­ra 17), le damos clic al ele­men­to Oculus.

Plugin XR Plugin Management
Fig. 16: Acti­va­mos la casil­la Ocu­lus del Plugin.
Plugin XR Plugin Management para Oculus
Fig. 17: Vamos a la nue­va pes­taña Ocu­lus del Plugin

Nos ase­gu­ramos que están mar­cadas las casil­las Quest y Quest 2 para que se aplique el plu­g­in a estos dispositivos.

configurar Unity para exportar para Oculus Quest y Oculus Quest 2
Fig. 18: Nos ase­gu­ramos que están mar­cadas las casil­las Quest y Quest2

Configurar Color Space

Antes de com­pi­lar una apli­cación para Ocu­lus Quest en Uni­ty ten­emos que ase­gu­rarnos de cam­biar el parámetro "Col­or Space" que se encuen­tra en la ven­tana Project Set­tings, Play­er y den­tro del menú desple­gable "Oth­er Set­tings", como se obser­va en la figu­ra 19. Si este paso no se hace vamos a ten­er errores en con­so­la al momen­to de com­pi­lar la aplicación.

el parámetro color space tiene que estar en Linear para poder compilar aplicaciones de realidad virtual para oculus con Unity
Fig. 19: Cam­bio del parámetro Col­or Space a Lin­ear para poder com­pi­lar para Oculus.

Compilación de aplicación de realidad virtual y prueba en Oculus Quest 2

Una vez que hemos con­fig­u­ra­do todo en el motor Uni­ty pro­cedemos a crear una com­pi­lación de la apli­cación de real­i­dad vir­tu­al y testear­la en un dis­pos­i­ti­vo como el Ocu­lus Quest 2, para eso vamos a la ven­tana Build Set­tings y ase­gurán­donos que en el parámetro "Run Device" ten­emos nue­stro dis­pos­i­ti­vo (ase­gu­rarse de que el dis­pos­i­ti­vo esté conec­ta­do por USB o Air­Link), le damos clic en Build and Run, elegi­mos la car­pe­ta de des­ti­no del archi­vo APK y le damos un nom­bre, como se obser­va en las fig­uras 20 y 21.

IMPORTANTE: Si el dis­pos­i­ti­vo no aparece en el cam­po "Run Device" se puede hac­er clic en el botón Build, expor­tar el archi­vo APK y luego insta­lar ese archi­vo por medio del soft­ware Ocu­lus Devel­op­er HUB arras­tran­do el archi­vo APK a la ven­tana que se obser­va en la figu­ra 3 al prin­ci­pio de este artículo. 

compilación de una aplicación de realidad virtual para oculus con Unity
Fig. 20: Creamos la com­pi­lación para Ocu­lus dan­do click en Build and Run.
compilación de una aplicación de realidad virtual para oculus con Unity
Fig. 21: Nom­bramos el archi­vo APK para compilar.

Cuan­do el pro­ce­so ter­mi­na la apli­cación se eje­cu­ta automáti­ca­mente en el dis­pos­i­ti­vo Ocu­lus Quest 2, el resul­ta­do de esto lo vemos en la sigu­iente imagen:

Prueba de la escena ejemplo en Oculus Quest 2.
Fig. 22: Prue­ba de la esce­na ejem­p­lo en Ocu­lus Quest 2.

Dónde se encuentra la aplicación instalada en Oculus

Como esta­mos hacien­do una prue­ba, esta apli­cación de real­i­dad vir­tu­al no fue val­i­da­da por la tien­da de Ocu­lus y por lo tan­to nue­stro dis­pos­i­ti­vo la colo­ca en una sec­ción aparte de apli­ca­ciones con "Orí­genes descono­ci­dos", en esa sec­ción podemos encon­trar la apli­cación que fue insta­l­a­da des­de Uni­ty, ver fig­uras 23 y 24.

Las aplicaciones de realidad virtual de prueba en Oculus Quest se encuentran en la sección
Fig. 23: Las apli­ca­ciones de prue­ba se encuen­tran en la sec­ción "Orí­genes Desconocidos".
Aplicación de realidad virtual para Oculus Quest 2 compilada con Unity.
Fig. 24: Apli­cación de real­i­dad vir­tu­al para Ocu­lus Quest 2 com­pi­la­da con Unity.

Para que las apli­ca­ciones aparez­can en la sec­ción prin­ci­pal debe­mos subir­las a la tien­da de oculus.

YouTube
Scroll al inicio
Secured By miniOrange