زمان اجرا XR

زمان اجرا XR

راهنمای کاربر

مرجع API
androidx.xr.runtime
androidx.xr.runtime.java
androidx.xr.runtime.math

جلسه AR یا سه بعدی سفارشی خود را با زمان اجرا بومی ما شروع کنید.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
7 مه 2025	-	-	-	1.0.0-alpha04

اعلام وابستگی ها

برای افزودن وابستگی به زمان اجرا XR، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار کاتلین بیشتر

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")
}

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.0

نسخه 1.0.0-alpha04

7 مه 2025

androidx.xr.runtime:runtime:1.0.0-alpha04 ، androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 و androidx.xr.runtime:runtime-testing:1.0.0-alpha04 منتشر شدند. نسخه 1.0.0-alpha04 حاوی این تعهدات است.

توجه: برای استفاده از این نسخه از کتابخانه به شبیه ساز Android نسخه 35.6.7 یا بالاتر نیاز دارید.

ویژگی های جدید

• Session اکنون androidx.lifecycle.LifecycleOwner را برای همکاری بیشتر با پارادایم‌های چرخه حیات Android موجود پیاده‌سازی می‌کند.
• رشته های مانیفست برای Android XR در اینجا مشخص و مستند شده است.
• زمانی که محتوای صحنه در داخل یا خارج از میدان دید کاربر حرکت می‌کند، روش‌های افزودنی قابلیت مشاهده فضایی برای نظارت اضافه شده است.
• یک نسخه خرد از JxrPlatformAdapter (و تمام کلاس های مرتبط با آن) اضافه شد.
• Session در SceneCore و Runtime به جای Session در SceneCore استفاده خواهد شد.
• ActivityPose.hitTest اضافه شد و یک hitTest در برابر محتوای مجازی فعال کرد.
• تعیین چندین پیاده سازی Runtime در زمان کامپایل اکنون پشتیبانی می شود. فقط یک مورد در زمان اجرا بر اساس مجموعه ویژگی های دستگاه فعلی بارگیری می شود.
• نوع کامپوننت جدید SpatialPointerComponent اضافه شده است که به مشتریان امکان می دهد نماد ارائه شده برای نشانگر را مشخص کنند یا نماد را غیرفعال کنند. این کامپوننت در حال حاضر فقط می تواند به نمونه های PanelEntity متصل شود.

تغییرات API

• اجرای پیکربندی را عمومی کنید. ( I95860 )
• HandJointType و TrackingState اضافه کنید. ( I55880 )
• پروژه‌های منتشر شده با Kotlin 2.0 برای مصرف نیاز به KGP 2.0.0 یا جدیدتر دارند ( Idb6b5 )
• Hand.isActive (boolean) به Hand.trackingState تغییر یافته است. پیاده سازی OpenXR بر این اساس اصلاح شده است.
• android.permission.SCENE_UNDERSTANDING نیاز مجوز در Session.configure به android.permission.SCENE_UNDERSTANDING_COARSE تغییر کرده است.
• LifecycleManager.configure پیاده سازی شده است و اکنون در یک شی Config که حاوی یک ویژگی برای هر ویژگی زمان اجرا قابل تنظیم است، عبور می کند.
• اکنون Session.configure می توان با یک Config فراخوانی کرد تا ویژگی های زمان اجرا موجود را پیکربندی کند.
• Session.create اکنون از ارسال یک CoroutineContext به جای CoroutineDispatcher پشتیبانی می کند.
• Session.create از بارگیری ARCore برای Jetpack XR و/یا SceneCore پشتیبانی می کند. حداقل یکی باید ارائه شود (نسخه های آزمایشی موجود است).
• هنگامی که یک UUID نامعتبر به Anchor.load و Anchor.unpersist ارسال می شود، FakePerceptionManager یک AnchorInvalidUuidException می اندازد.
• CoreState دیگر یک کلاس داده نیست.

رفع اشکال

• پیکربندی‌های Runtime Proguard ثابت شد.

نسخه 1.0.0-alpha03

26 فوریه 2025

androidx.xr.runtime:runtime:1.0.0-alpha03 ، androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 ، androidx.xr.runtime:runtime-testing:1.0.0-alpha03 بدون هیچ تغییر قابل توجهی از زمان انتشار آلفا منتشر شده اند. نسخه 1.0.0-alpha03 حاوی این تعهدات است.

نسخه 1.0.0-alpha02

12 فوریه 2025

androidx.xr.runtime:runtime:1.0.0-alpha02 ، androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 و androidx.xr.runtime:runtime-testing:1.0.0-alpha02 منتشر شدند. نسخه 1.0.0-alpha02 حاوی این تعهدات است.

شکستن و تغییرات رفتاری

• توابع زمان اجرا OpenXR که یک Anchor را برمی گرداند، اکنون اگر با کد خطایی مواجه شوند که به محدودیت منبع OpenXR رسیده است، AnchorResourcesExhaustedException را پرتاب می کنند.
• مجوز android.permission.HAND_TRACKING اکنون برای Session.create و Session.resume مورد نیاز است.

ویژگی های جدید

• اضافه شدن پشتیبانی ردیابی دست

رفع اشکال

• ایجاد لنگرها هنگام اجرا بر روی شبیه ساز پایدارتر است

نسخه 1.0.0-alpha01

12 دسامبر 2024

androidx.xr.runtime:runtime-* 1.0.0-alpha01 منتشر شد.

ویژگی های Initial Release

انتشار اولیه Jetpack XR Runtime. این کتابخانه شامل بخش های اساسی از عملکرد مجموعه کتابخانه های Jetpack XR است. این شامل کشف قابلیت، مدیریت چرخه حیات، پیکربندی و موارد دیگر می شود. کتابخانه Runtime بسته به پلتفرم اجرا، تغییرات متفاوتی (به عنوان مثال runtime-openxr یا runtime-testing ) ارائه می دهد. علاوه بر این، این کتابخانه انتزاعات ریاضی اساسی مانند Vector3 و Matrix4 را ارائه می دهد که در کل سطح API Jetpack XR استفاده می شود.

• Session : کنترل‌های دقیقی را بر روی سیستم XR به شما ارائه می‌دهد، از جمله تصمیم‌گیری در مورد انجام و عدم اجرای پردازش و پیکربندی کلی. همچنین این دسته ای است که در تمام API های دیگر برای باز کردن قابلیت های سیستم زیربنایی استفاده خواهید کرد.

• Pose : مکانی در یک سیستم مختصات دلخواه که موقعیت و جهتی مرتبط با آن دارد. شما از این کلاس برای برقراری ارتباط مکان اشیا با ARCore برای Jetpack XR و Jetpack SceneCore استفاده خواهید کرد.

مسائل شناخته شده

• configure در حال حاضر بدون عملیات است. نسخه‌های آینده تنظیمات جدیدی را اضافه می‌کنند که می‌توانید از آنها برای کنترل رفتار Session استفاده کنید.