Melhorar as experiências de apps com percepção usando o ARCore para Jetpack XR

Dispositivos XR relevantes

Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.

Saiba mais sobre tipos de dispositivos XR →

Saiba mais sobre tipos de dispositivos XR →

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 as experiências imersivas para dispositivos como headsets XR e óculos XR com fio, outras ajudam a melhorar as experiências aumentadas para dispositivos como óculos de IA e outras ajudam a melhorar as experiências de apps para todos os tipos de dispositivos Android XR.

Por exemplo, você pode usar o ARCore para Jetpack XR para recuperar dados planares, ancorar conteúdo em um local fixo no espaço ou usar uma pose geoespacial para ancorar 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 XR, adicione as dependências necessárias, dependendo do tipo de experiências de app que você está melhorando com RA.

Acessar uma sessão

Os recursos de percepção no ARCore para Jetpack XR dependem de um Session, que usa o ambiente de execução do Jetpack XR.

A forma como seu app acessa uma sessão depende dos tipos de experiências de app que você está melhorando com recursos de percepção:

• Se o app estiver melhorando experiências imersivas com a interface espacial usando o Jetpack Compose para XR, acesse uma sessão do Jetpack Compose para XR.
• Para todas as outras situações, você pode acessar acessar uma sessão do Jetpack XR Runtime, que é abordada na seção a seguir desta página.

Acessar uma sessão do ambiente de execução do Jetpack XR

Para acessar uma sessão do ambiente de execução do Jetpack XR, crie-a:

Para criar uma sessão, transmita uma atividade para o create() método, 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. */)
}
Session.kt

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 deixa de ser válida.

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 a Session. Para mais 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 usá-la para melhorar as experiências de apps para diferentes dispositivos XR:

• Detectar planos usando o ARCore para Jetpack XR
• Criar âncoras com o ARCore para Jetpack XR
• Trabalhar com as mãos usando o ARCore para Jetpack XR
• Incorporar a posição da cabeça no app com o ARCore para Jetpack XR
• Incorporar a captura de expressões faciais no app com o ARCore para Jetpack XR
• Recuperar informações de profundidade no app com o ARCore para Jetpack XR
• Rastrear a pose de um dispositivo usando o ARCore para Jetpack XR