ARCore para Jetpack XR brinda 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 inmersivas para dispositivos como visores de realidad extendida y gafas de realidad extendida con cable, otras te ayudan a mejorar las experiencias de realidad aumentada para dispositivos como gafas con IA y otras te ayudan a mejorar las experiencias de las apps para todo tipo de dispositivos Android XR.
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 XR, agrega las dependencias necesarias, según el tipo de experiencias de la app que estés mejorando con RA.
Cómo acceder a una sesión
Las funciones de percepción en ARCore para Jetpack XR dependen de un Session, que usa el tiempo 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 funciones de percepción:
- Si tu app mejora las experiencias envolventes con una IU espacial usando Jetpack Compose para XR, accede a una sesión desde Jetpack Compose para XR.
- Para todas las demás situaciones, puedes acceder a una sesión desde el tiempo de ejecución de Jetpack XR, que se explica en la siguiente sección de esta página.
Cómo acceder a una sesión desde el entorno de ejecución de Jetpack XR
Para acceder a una sesión desde Jetpack XR Runtime, deberás crearla:
Para crear una sesión, pasa una actividad al método create(), 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 a esa sesión, y la sesión deja de ser válida.
Cómo configurar 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 RA, consulta las páginas correspondientes a cada función de RA.
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 en diferentes dispositivos XR:
- Cómo detectar planos con ARCore para Jetpack XR
- Crea anclajes con ARCore para Jetpack XR
- Cómo trabajar con las manos usando ARCore para Jetpack XR
- Cómo incorporar la posición de la cabeza en tu app con ARCore para Jetpack XR
- Incorpora el seguimiento de rostros en tu app con ARCore para Jetpack XR
- Cómo recuperar información de profundidad en tu app con ARCore para Jetpack XR
- Cómo hacer un seguimiento de la postura de un dispositivo con ARCore para Jetpack XR
- Trabaja con poses geoespaciales usando ARCore para Jetpack XR