O ARCore para Jetpack XR oferece recursos de percepção avançados para que seu app entenda o mundo real usando várias APIs. Algumas dessas APIs ajudam a melhorar experiências imersivas para dispositivos como headsets e óculos de realidade virtual com fio, outras ajudam a melhorar experiências de realidade aumentada para dispositivos como óculos de IA, e outras ajudam a melhorar experiências de apps para todos os tipos de dispositivos Android XR.
Por exemplo, você pode usar o ARCore para Jetpack XR e recuperar dados planares, fixar conteúdo em um local fixo no espaço ou usar uma postura geoespacial para fixar conteúdo em um local do mundo real.
Adicionar dependências de biblioteca
Antes de começar a usar recursos de percepção no seu app de XR, adicione as dependências necessárias, dependendo do tipo de experiências que você está aprimorando com RA.
Acessar uma sessão
Os recursos de percepção no ARCore para Jetpack XR dependem de um Session, que usa o tempo de execução do Jetpack XR.
A forma como o app deve acessar uma sessão depende dos tipos de experiências que você está aprimorando com recursos de percepção:
- Se o app estiver aprimorando experiências imersivas com interface espacial usando o Jetpack Compose para XR, acesse uma sessão do Jetpack Compose para XR.
- Para todas as outras situações, acesse uma sessão do Jetpack XR Runtime, que é abordada na seção a seguir nesta página.
Acessar uma sessão do Jetpack XR Runtime
Para acessar uma sessão do Jetpack XR Runtime, crie uma:
Para criar uma sessão, transmita uma atividade ao método create(), conforme mostrado no exemplo a seguir:
when (val result = Session.create(this)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
Quando a atividade de uma sessão é destruída, todo o conteúdo de RA associado a ela também é destruído, e a sessão perde a validade.
Configurar uma sessão
Alguns recursos podem estar desativados por padrão e precisam ser configurados para
funcionar. Para configurar uma sessão, use configure() e especifique as
opções de configuração necessárias para seu Session. Para detalhes sobre
a configuração necessária para diferentes recursos de RA, consulte as páginas
correspondentes de cada recurso.
Próximas etapas
Depois que o app tiver uma sessão, confira as maneiras de usar isso para melhorar as experiências do app em diferentes dispositivos de RV/RA:
- Detectar planos usando o ARCore para Jetpack XR
- Criar âncoras com o ARCore para o Jetpack XR
- Trabalhar com as mãos usando o ARCore para Jetpack XR
- Incorporar a posição da cabeça no seu app com o ARCore para Jetpack XR
- Incorporar o rastreamento facial no app com o ARCore para Jetpack XR
- Recuperar informações de profundidade no app com o ARCore para Jetpack XR
- Rastrear a postura de um dispositivo usando o ARCore para Jetpack XR
- Trabalhar com posturas geoespaciais usando o ARCore para Jetpack XR