انتقال از فضای خانه به فضای کامل

کاربر می تواند برنامه شما را در دو حالت Home Space یا Full Space تجربه کند. در Home Space، کاربر می‌تواند با برنامه شما که در کنار سایر برنامه‌ها اجرا می‌شود، چند کار انجام دهد. در فضای کامل، برنامه شما در مرکز توجه تجربه کاربر با دسترسی کامل به قابلیت‌های فراگیر Android XR قرار می‌گیرد.

فضایی سازی در حال حاضر فقط در فضای کامل پشتیبانی می شود. برنامه شما می‌تواند به فضای کامل منتقل شود تا از قابلیت‌های فضایی و سه بعدی استفاده کند. وقتی برنامه شما فوکوس دارد، می‌توانید با درخواست حالت مربوطه از جلسه XR، بین این حالت‌ها جابه‌جا شوید.

برنامه شما به طور پیش‌فرض در Home Space باز می‌شود، مگر اینکه چیز دیگری را همانطور که در بخش اعلام حالت پیش‌فرض برای راه‌اندازی توضیح داده شده است، مشخص کنید.

انتقال بین فضای خانه و فضای کامل

برای انتقال بین Home Space و Full Space، باید حالت عملکرد را از Session درخواست کنید. همانطور که در مثال زیر نشان داده شده است، می‌توانید از این درخواست‌ها استفاده کنید تا کاربر شما بتواند با کلیک کردن روی یک دکمه بین حالت‌ها جابه‌جا شود.

@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)
        )
    }
}

برای کسب اطلاعات بیشتر در مورد فضای خانه به فضای کامل و نحوه بهترین انتقال بین این دو، راهنمای طراحی را ببینید.

حالت پیش فرض را برای راه اندازی اعلام کنید

برای انتخاب اینکه برنامه شما در Home Space یا Full Space راه اندازی شود، خطوط زیر را به فایل Manifest Android خود اضافه کنید:

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

همچنین ببینید