Ev alanından tam alana geçiş

Kullanıcılar uygulamanızı Ana Alan veya Tam Alan modlarında kullanabilir. Kullanıcılar, ana ekranda uygulamanızı diğer uygulamalarla birlikte çalıştırarak çoklu görev yapabilir. Tam Alan'da, Android XR'nin sürükleyici özelliklerine tam erişim sunarak kullanıcı deneyiminin odak noktası olarak uygulamanız merkeze alınır.

Uzamsallaştırma şu anda yalnızca Tam Alan'da desteklenmektedir. Uygulamanız, uzamsal ve 3D özelliklerden yararlanmak için tam alana geçebilir. Uygulamanız odaktayken XR oturumundan ilgili modu isteyerek bu modlar arasında geçiş yapabilirsiniz.

Başlatma için varsayılan modu belirtme bölümünde açıklandığı gibi aksini belirtmediğiniz sürece uygulamanız varsayılan olarak Home alanında açılır.

Ev Alanı ile Tam Alan arasında geçiş yapma

Ev alanı ile tam alan arasında geçiş yapmak için Session'ten çalışma modunu istemeniz gerekir. Aşağıdaki örnekte gösterildiği gibi, kullanıcınızın bir düğmeyi tıklayarak modlar arasında geçiş yapabilmesi için bu istekleri kullanabilirsiniz.

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

Ana sayfa alanından tam alana geçiş ve bu iki alan arasında en iyi şekilde geçiş yapma hakkında daha fazla bilgi edinmek için tasarım kılavuzuna bakın.

Lansman için varsayılan modu belirtme

Uygulamanızın Home Space'te mi yoksa Full Space'te mi başlatılacağını seçmek için Android manifest dosyanıza aşağıdaki satırları ekleyin:

// 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" />

Ayrıca bkz.