Phiên hoạt động

Session cung cấp giao diện chính cho chức năng không gian của ứng dụng. Mỗi Hoạt động được không gian hoá phải tạo và giữ một thực thể của Phiên. Sau khi tạo, ứng dụng có thể sử dụng giao diện Phiên để tạo các thực thể nội dung không gian như bảng điều khiển hoặc mô hình 3D, cũng như thiết lập môi trường không gian, xác định vị trí người dùng và neo nội dung vào thế giới thực.

Truy cập phiên từ Jetpack Compose cho XR

Khi sử dụng Jetpack Compose cho XR, phiên sẽ được tạo cho bạn và bạn có thể truy cập vào phiên đó bằng LocalSession.current. Hãy xem ví dụ sau:

import androidx.xr.compose.platform.LocalSession

class myActivity : Activity() {
   val xrSession = checkNotNull(LocalSession.current)
}

Truy cập phiên từ Jetpack SceneCore

Nếu đang tạo các thực thể không gian từ thư viện SceneCore, bạn sẽ cần tự tạo bản sao phiên.

Tính năng tạo phiên chỉ được hỗ trợ trên thiết bị Android XR. Tại thời điểm này, nếu tạo Session và cố gắng sử dụng Session đó trên thiết bị không phải Android XR, bạn sẽ nhận được NullPointerException.

Bạn chỉ có thể tạo một phiên cho mỗi hoạt động. Để tạo một phiên, hãy truyền một hoạt động đến phương thức create, như trong ví dụ sau. Việc cố gắng tạo phiên trên một thiết bị không tương thích có thể gây ra lỗi thời gian chạy.

import androidx.xr.scenecore.Session

class myActivity : Activity() {
  val xrSession = Session.create(this)
}

Khi hoạt động của một phiên bị huỷ bỏ, tất cả giao diện người dùng không gian và nội dung 3D liên kết với phiên đó sẽ bị huỷ bỏ và phiên đó không còn hợp lệ nữa.

Xem thêm