ARCore para Jetpack XR ofrece potentes capacidades de percepción para que tu app comprenda el mundo real a través de una variedad de APIs. Algunas de estas APIs te ayudan a mejorar las experiencias envolventes para dispositivos como visores de realidad extendida y lentes de realidad extendida con cable, otras te ayudan a mejorar las experiencias aumentadas para dispositivos como lentes de IA y otras te ayudan a mejorar las experiencias de la app para todos los tipos de dispositivos de realidad extendida de Android.
Por ejemplo, puedes usar ARCore para Jetpack XR para recuperar datos planos, anclar contenido a una ubicación fija en el espacio o usar una postura geoespacial para anclar contenido a una ubicación del mundo real.
Agrega dependencias de bibliotecas
Antes de comenzar a usar las funciones de percepción en tu app de realidad extendida, agrega las dependencias necesarias, según el tipo de experiencias de la app que estés mejorando con la realidad aumentada.
Accede a una sesión
Las funciones de percepción en ARCore para Jetpack XR se basan en una Session, que
usa el entorno de ejecución de Jetpack XR.
La forma en que tu app debe acceder a una sesión depende de los tipos de experiencias de la app que estés mejorando con las funciones de percepción:
- Si tu app mejora las experiencias envolventes con la IU espacial mediante Jetpack Compose para realidad extendida, accede a una sesión desde Jetpack Compose para realidad extendida.
- En todas las demás situaciones, puedes acceder a una sesión desde el entorno de ejecución de Jetpack XR Runtime, que se aborda en la siguiente sección de esta página.
Accede a una sesión desde el entorno de ejecución de Jetpack XR
Para acceder a una sesión desde el entorno de ejecución de Jetpack XR, deberás crearla:
Para crear una sesión, pasa una actividad al create()
método, como se muestra en el siguiente ejemplo:
when (val result = Session.create(this)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
Cuando se destruye la actividad de una sesión, se destruye todo el contenido de RA asociado con esa sesión, y la sesión ya no es válida.
Configura una sesión
Es posible que algunas funciones estén inhabilitadas de forma predeterminada y deban configurarse para que funcionen. Para configurar una sesión, usa configure() y especifica las
opciones de configuración que necesita tu Session. Para obtener detalles sobre la configuración requerida para las diferentes funciones de realidad aumentada, consulta las páginas correspondientes de cada función de realidad aumentada.
Próximos pasos
Una vez que tu app tenga una sesión, explora las formas en que puedes usarla para mejorar las experiencias de la app para diferentes dispositivos de realidad extendida:
- Detecta planos con ARCore para Jetpack XR
- Crea anclajes con ARCore para Jetpack XR
- Trabaja con las manos usando ARCore para Jetpack XR
- Incorpora la posición de la cabeza en tu app con ARCore para Jetpack XR
- Incorpora el seguimiento facial en tu app con ARCore para Jetpack XR
- Recupera información de profundidad en tu app con ARCore para Jetpack XR
- Realiza un seguimiento de la postura de un dispositivo con ARCore para Jetpack XR