Thời gian chạy XR

Bắt đầu phiên AR hoặc 3D tuỳ chỉnh bằng thời gian chạy gốc của chúng tôi.
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 7 tháng 5 năm 2025 - - - 1.0.0-alpha04

Khai báo phần phụ thuộc

Để thêm phần phụ thuộc trên môi trường thời gian chạy XR, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc bài viết về kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

GroovyKotlin 
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha04"
}
 
dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha04")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha04")
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.0

Phiên bản 1.0.0-alpha04

Ngày 7 tháng 5 năm 2025

Phát hành androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 và androidx.xr.runtime:runtime-testing:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Phiên hiện triển khai androidx.lifecycle.LifecycleOwner để tăng khả năng tương tác với các mô hình vòng đời Android hiện có.
  • Chuỗi tệp kê khai cho Android XR được chỉ định và ghi lại tại đây.
  • Thêm các phương thức tiện ích Lệnh gọi lại khả năng hiển thị không gian để theo dõi thời điểm nội dung cảnh di chuyển bên trong hoặc bên ngoài trường nhìn của người dùng.
  • Thêm phiên bản giả lập của JxrPlatformAdapter (và tất cả các lớp liên quan).
  • Phiên sẽ được sử dụng trong cả SceneCore và Thời gian chạy thay vì Phiên trong SceneCore.
  • Thêm ActivityPose.hitTest, cho phép hitTest chống lại nội dung ảo.
  • Hiện tại, bạn có thể chỉ định nhiều cách triển khai Thời gian chạy tại thời điểm biên dịch. Chỉ một tệp sẽ được tải tại thời điểm thực thi dựa trên bộ tính năng của thiết bị hiện tại.
  • Thêm loại Thành phần mới SpatialPointerComponent, cho phép ứng dụng chỉ định biểu tượng được kết xuất cho con trỏ hoặc tắt biểu tượng. Thành phần này hiện chỉ có thể được đính kèm vào các thực thể PanelEntity.

Thay đổi về API

  • Công khai quá trình triển khai Config. (I95860)
  • Thêm HandJointType và TrackingState. (I55880)
  • Các dự án phát hành bằng Kotlin 2.0 yêu cầu sử dụng KGP 2.0.0 trở lên (Idb6b5)
  • Hand.isActive (boolean) đã đổi tên thành Hand.trackingState. Phương thức triển khai OpenXR đã được sửa đổi cho phù hợp.
  • Yêu cầu về quyền android.permission.SCENE_UNDERSTANDING trong Session.configure đã được thay đổi thành android.permission.SCENE_UNDERSTANDING_COARSE.
  • LifecycleManager.configure được triển khai và hiện truyền vào một đối tượng Config chứa một thuộc tính cho mỗi tính năng thời gian chạy có thể định cấu hình.
  • Giờ đây, bạn có thể gọi Session.configure bằng Config để định cấu hình các tính năng thời gian chạy hiện có.
  • Session.create hiện hỗ trợ truyền CoroutineContext thay vì CoroutineDispatcher.
  • Session.create hỗ trợ tải ARCore cho Jetpack XR và/hoặc SceneCore. Bạn phải cung cấp ít nhất một phiên bản (có các phiên bản thử nghiệm).
  • FakePerceptionManager gửi một AnchorInvalidUuidException khi một UUID không hợp lệ được truyền đến Anchor.load và Anchor.unpersist.
  • CoreState không còn là một lớp dữ liệu.

Sửa lỗi

  • Sửa cấu hình Proguard thời gian chạy.

Phiên bản 1.0.0-alpha03

Ngày 26 tháng 2 năm 2025

Phát hành androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 và androidx.xr.runtime:runtime-testing:1.0.0-alpha03 mà không có thay đổi đáng kể nào kể từ bản alpha gần đây nhất. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha02

Ngày 12 tháng 2 năm 2025

Phát hành androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 và androidx.xr.runtime:runtime-testing:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Thay đổi có thể gây lỗi và thay đổi về hành vi

  • Các hàm thời gian chạy OpenXR trả về một neo hiện sẽ gửi AnchorResourcesExhaustedException nếu gặp mã lỗi thông báo rằng đã đạt đến giới hạn tài nguyên OpenXR.
  • Giờ đây, bạn bắt buộc phải sử dụng quyền android.permission.HAND_TRACKING cho Session.create và Session.resume.

Tính năng mới

  • Thêm tính năng hỗ trợ theo dõi cử chỉ tay.

Sửa lỗi

  • Tạo neo ổn định hơn khi chạy trên trình mô phỏng

Phiên bản 1.0.0-alpha01

Ngày 12 tháng 12 năm 2024

Phát hành androidx.xr.runtime:runtime-* 1.0.0-alpha01.

Các tính năng của bản phát hành ban đầu

Bản phát hành đầu tiên của Jetpack XR Runtime. Thư viện này chứa các chức năng cơ bản cho bộ thư viện Jetpack XR. Trong đó bao gồm việc khám phá chức năng, quản lý vòng đời, cấu hình và nhiều tính năng khác. Thư viện Thời gian chạy cung cấp nhiều biến thể (ví dụ: runtime-openxr hoặc runtime-testing) tuỳ thuộc vào nền tảng thực thi. Ngoài ra, thư viện này còn cung cấp các khái niệm trừu tượng toán học cơ bản như Vector3 và Matrix4 được sử dụng trên toàn bộ giao diện API Jetpack XR.

  • Session: Cung cấp cho bạn các chế độ kiểm soát chi tiết đối với hệ thống XR, bao gồm cả việc quyết định thời điểm xử lý và không xử lý cũng như cấu hình tổng thể. Đây cũng là tên mà bạn sẽ sử dụng trên tất cả các API khác để khai thác các chức năng cơ bản của hệ thống.

  • Pose: Một vị trí trong hệ toạ độ tuỳ ý có vị trí và hướng liên kết với vị trí đó. Bạn sẽ sử dụng lớp này để thông báo vị trí của các đối tượng bằng ARCore cho Jetpack XR và Jetpack SceneCore.

Lỗi đã biết

  • configure hiện không hoạt động. Các bản phát hành trong tương lai sẽ thêm các chế độ cài đặt mới mà bạn có thể sử dụng để kiểm soát hành vi của Session.