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ế độ: Không gian chính hoặc Toàn 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 với ứng dụng của bạn chạy cạnh các ứng dụng khác. Trong chế độ Toàn không gian, ứ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.

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.

Tính năng Phát âm theo không gian chỉ được hỗ trợ ở chế độ Toàn không gian. Ứng dụng của bạn có thể chuyển sang chế độ Toàn không gian để 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 không gian tương ứng.

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

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 không gian đầy đủ bằng cách sử dụng thành phần LocalSpatialConfiguration cục bộ.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()

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.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

Hãy xem lớp học lập trình Tìm hiểu các 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 nhằm 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 lại hướng dẫn thiết kế của chúng tôi để tìm hiểu thêm về cách chuyển đổi giữa Không gian chính và Toàn không gian cũng như cách chuyển đổi hiệu quả 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 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_MANAGED" />

Xem thêm