Ambiente de execução de XR

Inicie sua sessão 3D ou RA personalizada com nosso ambiente de execução nativo.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
12 de fevereiro de 2025 - - - 1.0.0-alpha02

Declarar dependências

Para adicionar uma dependência ao ambiente de execução XR, é preciso adicionar o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha01"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha01")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha01")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-alpha02

12 de fevereiro de 2025

Lançamento de androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 e androidx.xr.runtime:runtime-testing:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Mudanças de comportamento e de interrupção

  • As funções de ambiente de execução OpenXR que retornam uma âncora agora geram AnchorResourcesExhaustedException se encontrarem um código de erro que notifica que o limite de recursos OpenXR foi atingido.
  • A permissão android.permission.HAND_TRACKING agora é necessária para Session.create e Session.resume.

Novos recursos

  • Adicionamos suporte ao rastreamento de mãos.

Correções de bugs

  • A criação de âncoras é mais estável quando executada em um emulador

Versão 1.0.0-alpha01

12 de dezembro de 2024

Lançamento de androidx.xr.runtime:runtime-* 1.0.0-alpha01.

Recursos da versão inicial

Versão inicial do Jetpack XR Runtime. Ela contém peças fundamentais da funcionalidade do conjunto de bibliotecas do Jetpack XR. Isso inclui descoberta de recursos, gerenciamento de ciclo de vida, configuração e muito mais. A biblioteca Runtime oferece variações diferentes (por exemplo, runtime-openxr ou runtime-testing) dependendo da plataforma de execução. Além disso, essa biblioteca oferece abstrações matemáticas fundamentais, como Vector3 e Matrix4, que são usadas em toda a API Jetpack XR.

  • Session: oferece controles detalhados sobre o sistema de RA, incluindo a decisão de quando o processamento é e não é executado e a configuração geral. Ele também é o identificador que você vai usar em todas as outras APIs para desbloquear os recursos do sistema.

  • Pose: um local em um sistema de coordenadas arbitrário que tem uma posição e uma orientação associadas. Você vai usar essa classe para comunicar a localização de objetos com o ARCore para o Jetpack XR e o Jetpack SceneCore.

Problemas conhecidos

  • No momento, configure não faz nada. Nas próximas versões, novas configurações serão adicionadas para controlar o comportamento do Session.