Chuyển đổi từ Không gian chính sang Không gian toàn màn hình

Người dùng có thể trải nghiệm ứng dụng của bạn ở hai chế độ là Không gian chính hoặc Không gian đầy đủ. Trong Không gian chính, người dùng có thể làm nhiều việc cùng lúc với ứng dụng của bạn chạy song song với các ứng dụng khác. Trong chế độ Không gian đầy đủ, ứng dụng của bạn sẽ là tâm điểm của trải nghiệm người dùng với quyền truy cập đầy đủ vào các tính năng sống động của Android XR.

Tính năng Phát âm không gian hiện chỉ được hỗ trợ trong chế độ Không gian đầy đủ. Ứng dụng của bạn có thể chuyển sang chế độ Toàn màn hình để tận dụng các tính năng không gian và 3D. Khi ứng dụng của bạn có tiêu điểm, bạn có thể chuyển đổi giữa các chế độ này bằng cách yêu cầu chế độ tương ứng từ phiên XR.

Theo mặc định, ứng dụng của bạn sẽ mở trong Không gian chính, trừ phi bạn chỉ định cách khác như mô tả trong phần Khai báo chế độ mặc định để khởi chạy.

Chuyển đổi giữa Không gian chính và Không gian toàn màn hình

Để chuyển đổi giữa Không gian chính và Không gian đầy đủ, bạn cần yêu cầu chế độ hoạt động từ Session. Như trong ví dụ sau, bạn có thể sử dụng các yêu cầu này để người dùng có thể chuyển đổi giữa các chế độ bằng cách nhấp vào một nút.

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

Hãy xem hướng dẫn thiết kế để tìm hiểu thêm về cách chuyển đổi giữa Không gian chính và Không gian toàn màn hình cũng như cách chuyển đổi hiệu quả nhất giữa hai không gian này.

Khai báo chế độ mặc định để khởi chạy

Để chọn xem ứng dụng của bạn sẽ chạy trong Không gian chính hay Không gian toàn màn hình, hãy thêm các dòng sau vào tệp kê khai 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" />

Xem thêm