Người dùng có thể trải nghiệm ứng dụng của bạn ở hai chế độ: Không gian chính hoặc Toàn bộ không gian. Trong Không gian chính, người dùng có thể làm nhiều việc cùng lúc khi ứng dụng của bạn chạy song song với các ứng dụng khác. Trong chế độ Toàn bộ không gian, ứng dụng của bạn sẽ chiếm vị trí trung tâm, là tâm điểm trong trải nghiệm của người dùng và có toàn quyền truy cập vào các chức năng sống động của Android 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 khác như mô tả trong phần Khai báo chế độ mặc định để chạy.
Tính năng không gian hoá chỉ được hỗ trợ trong Toàn bộ không gian. Ứng dụng của bạn có thể chuyển sang chế độ Toàn bộ không gian để tận dụng các chức năng không gian và 3D. Khi ứng dụng của bạn được lấy 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 không gian tương ứng.
Sử dụng SpaceToggleButton để chuyển đổi giữa Không gian chính và Toàn bộ không gian
Để chuyển đổi giữa Không gian chính và Toàn không gian, hãy sử dụng thành phần kết hợp SpaceToggleButton trong thư viện Material Design cho XR.
Đây là một nút composable, thích ứng với chế độ không gian hiện tại và chuyển đổi giữa chế độ Toàn bộ không gian và Không gian chính.
Tạo hiệu ứng chuyển đổi tuỳ chỉnh giữa Không gian chính và Toàn bộ không gian
Nếu bạn đang sử dụng thư viện Jetpack Compose cho XR, hãy yêu cầu không gian chính hoặc toàn bộ không gian bằng cách sử dụng thành phần cục bộ LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
Nếu đang sử dụng thư viện Jetpack SceneCore, bạn có thể yêu cầu không gian tương ứng từ Session; hãy xem phần Truy cập vào phiên từ Jetpack SceneCore.
xrSession.scene.requestHomeSpace()
Hãy xem hướng dẫn thiết kế của chúng tôi để tìm hiểu thêm về Không gian chính và Toàn bộ không gian, 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 để chạy
Ngoài ra, bạn có thể thêm các dòng sau vào tệp kê khai Android để chọn không gian mà ứng dụng sẽ mở:
<!-- 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" />
Xem thêm
- Kiểm tra các chức năng không gian
- Tạo phiên
- Thêm môi trường vào ứng dụng
- Thêm mô hình 3D vào ứng dụng