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

Các thiết bị XR được hỗ trợ
Hướng dẫn này giúp bạn xây dựng các trải nghiệm cho những loại thiết bị XR sau.
Tìm hiểu về các loại thiết bị XR →
Thiết bị đeo đầu XR
Kính thông minh XR có dây
Tìm hiểu về các loại thiết bị XR →

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. Ở chế độ Toàn bộ không gian, ứng dụng của bạn sẽ là tâm điểm trong trải nghiệm của người dùng với 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ở ở chế độ Không gian chính, trừ phi bạn chỉ định chế độ khác như mô tả trong phần Khai báo chế độ mặc định để chạy.

Không gian hoá chỉ được hỗ trợ ở chế độ 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ó 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 chế độ Không gian chính và chế độ Toàn bộ không gian

Để chuyển đổi giữa Không gian chính và Toàn không gian, hãy 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 có thể kết hợp, 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à chế độ 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 đang dùng thư viện Jetpack Compose cho XR, hãy yêu cầu không gian chính hoặc toàn không gian bằng cách dùng cấu trúc cục bộ LocalSession.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

Nếu đang 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 lớp học lập trình Tìm hiểu kiến thức cơ bản về Android XR: Phần 1 – Chế độ và Bảng điều khiển không gian để biết ví dụ về cách sử dụng các yêu cầu này để chuyển đổi giữa các chế độ bằng cách nhấp vào một nút. Bạn cũng nên xem hướng dẫn thiết kế của chúng tôi để tìm hiểu thêm về chế độ Không gian chính sang chế độ Toàn bộ không gian và cách chuyển đổi tốt nhất giữa hai chế độ này.

Khai báo chế độ mặc định để khởi 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 của bạn 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