Truy cập vào một phiên để tạo giao diện người dùng và các thực thể được không gian hoá

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 →

Tìm hiểu về các loại thiết bị XR →

Session cung cấp giao diện chính cho chức năng không gian hoá cho ứng dụng của bạn. Mỗi Activity được không gian hoá phải tạo và giữ một phiên bản của Session. Sau khi tạo một phiên, ứng dụng của bạn có thể sử dụng các giao diện Session để tạo các thực thể nội dung được không gian hoá, chẳng hạn 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 vào một phiên từ Jetpack Compose cho XR

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

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

Truy cập vào một phiên từ Jetpack XR Runtime

Nếu đang tạo các thực thể được không gian hoá từ thư viện Jetpack SceneCore, bạn cần tạo một phiên.

Để tạo một phiên, hãy truyền [Context] đến phương thức create(). Context này có thể là Activity trên thiết bị XR sống động hoặc thiết bị di động, hoặc là một bối cảnh được chiếu.

Việc tạo một phiên ARCore có thể là một tác vụ tốn kém và nên được xử lý ở chế độ nền, như minh hoạ trong ví dụ sau:

when (val result = Session.create(context)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Session.kt

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

Xem thêm

• Kiểm tra các chức năng không gian
• Chuyển đổi giữa HSM và FSM
• Thêm môi trường không gian vào ứng dụng
• Thêm mô hình 3D vào ứng dụng