زمان اجرا XR

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

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

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"

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

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")

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

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

بازخورد

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

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

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

نسخه 1.0

نسخه 1.0.0-alpha05

30 جولای 2025

androidx.xr.runtime:runtime-*:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 حاوی این تعهدات است.

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

• HandJointType و TrackingState اضافه کنید. ( I55880 , b/334645808 )
• اجرای پیکربندی را عمومی کنید. ( I95860 , b/334645808 )
• انواع SessionCreateResult و SessionConfigureResult جدید را معرفی کرد. ( Icb8cb , b/334645808 )
• یک کلاس BoundingBox جدید اضافه کنید که نمایانگر یک جعبه مرزی تراز محور در فضای سه بعدی است که با حداقل و حداکثر نقاط گوشه آن تعریف شده است. ( Ic68c5 , b/423073468 )

تغییرات API

• androidx.xr.scenecore.PixelDimensions تغییر نام داد و به androidx.xr.runtime.math.IntSize2d منتقل شد. تغییر نام داد و androidx.xr.scenecore.Dimensions به androidx.xr.runtime.math.FloatSize3d منتقل شد. androidx.xr.scenecore.PlaneType به androidx.xr.scenecore.PlaneOrientation تغییر نام داد. androidx.xr.scenecore.PlaneSemantic به androidx.xr.scenecore.PlaneSemanticType تغییر نام داد. ( Ifd405 , b/416456228 )
• کلاس androidx.xr.runtime.FoV حذف شد. به جای آن از androidx.xr.runtime.FieldOfView استفاده کنید. ( I9ae27 )
• اضافه بار اضافی برای Session.create اضافه شده است که می تواند LifecycleOwner را برای Session به آن متصل کند. توجه داشته باشید که همچنان باید یک Activity برای مالکیت منبع ارائه شود و LifecycleOwner باید در محدوده فعالیت باشد. ( I1690b )
• تغییر نام FakeRuntimeAnchor.anchorsCreated به anchorsCreatedCount ( I96df9 , b/424441218 )
• Config *Mode vals برای نشان دادن رفتار آنها تغییر نام داده شده است. ( I6d247 , b/414648065 )
• پروژه‌های منتشر شده با Kotlin 2.0 برای مصرف نیاز به KGP 2.0.0 یا جدیدتر دارند ( Idb6b5 , b/344563182 )
• API های مربوط به رشته های مانیفست از :xr:runtime:runtime به :xr:runtime:runtime-manifest منتقل شده اند. نام بسته از androidx.xr.runtime به androidx.xr.runtime.manifest تغییر کرده است. ( I610ad , b/418800249 )
• Session.resume() , Session.pause() و Session.destroy() از سطح API حذف شده اند. Session دیگر یک LifecycleOwner نیست. چرخه عمر Session اکنون به چرخه حیات Activity منتقل شده در Session.create() متصل می شود. ( I28a03 )
• این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این به طور پیش فرض با نسخه 2.1.0 کامپایلر Kotlin شروع می شود) ( Ia8420 , b/326456246 )
• مصنوع اصلی Runtime ( :xr:runtime:runtime ) فقط حاوی APIهای ناهمگام به سبک Kolin خواهد بود. توسعه دهندگان جاوا می توانند برای دسترسی به API های سازگار به :xr:runtime:runtime-guava وابسته باشند. ( I05d4a , b/426639315 )
• مصنوع اصلی Runtime ( :xr:runtime:runtime ) فقط حاوی APIهای همگام به سبک Kotlin خواهد بود. توسعه دهندگان جاوا می توانند برای دسترسی به API های سازگار به کتابخانه xr:runtime:runtime-rxjava3 وابسته باشند. ( I64122 , b/426639775 )
• Coroutines را به :xr:runtime:runtime-guava و Flows را به :xr:runtime:runtime-rxjava3 منتقل کنید. ( I60ae9 )
• Session.create و Session.configure اکنون به جای بازگرداندن SessionCreatePermissionsNotGranted یا SessionConfigurePermissionsNotGranted ، SecurityException زمانی که مجوزهای کافی داده نشده است، پرتاب می کنند. ( I7c488 , b/430651879 )

نسخه 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 حاوی این تعهدات است.

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

• 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 استفاده کنید.