Transição do espaço compacto para o espaço ampliado

Um usuário pode usar seu app em dois modos: Espaço Compacto ou Espaço Ampliado. No Espaço Compacto, um usuário pode realizar várias tarefas com seu app executado lado a lado com outros apps. No Modo de Espaço Ampliado, seu app é o foco da experiência do usuário com acesso total aos recursos imersivos do Android XR.

O app é aberto no Espaço Compacto por padrão, a menos que você especifique o contrário, conforme descrito na seção Declarar o modo padrão para inicialização.

A espacialização só é compatível com o espaço completo. Seu app pode fazer a transição para o Espaço Ampliado e aproveitar os recursos espaciais e 3D. Quando o app está em foco, é possível fazer a transição entre esses modos solicitando o espaço correspondente.

Transição entre o Espaço Compacto e o Espaço Ampliado

Se você estiver usando a biblioteca Jetpack Compose para XR, solicite o espaço inicial ou o espaço completo usando a composição local LocalSpatialConfiguration.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Se você estiver usando a biblioteca Jetpack SceneCore, poderá solicitar o espaço correspondente do Session. Consulte Acessar a sessão do Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Consulte o codelab Aprender os fundamentos do Android XR (Parte 1): modos e painéis espaciais para ver exemplos de como usar essas solicitações para fazer a transição entre modos clicando em um botão. Também recomendamos consultar nossas orientações de design para saber mais sobre o Espaço Compacto e o Espaço Ampliado e como fazer a transição entre eles da melhor forma.

Declarar o modo padrão para inicialização

Como alternativa, adicione as seguintes linhas ao arquivo de manifesto do Android para escolher em qual espaço o app deve ser aberto:

<!-- Launch in Full Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

<!-- Or, launch in Home Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED" />

Veja também