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

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

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

A espacialização só é compatível com o espaço total. O app pode fazer a transição para o modo de Espaço Ampliado para 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 principal ou o espaço total usando a composição local LocalSpatialConfiguration.

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

Se você estiver usando a biblioteca Jetpack SceneCore, poderá solicitar o espaço correspondente no Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

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

Declarar o modo padrão de inicialização

Como alternativa, adicione as linhas abaixo ao arquivo de manifesto do Android para escolher em qual espaço o app 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