زمان اجرا XR

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

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

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

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

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha07"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha07"

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

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

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha07")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha07")

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

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

بازخورد

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

ایجاد یک مسئله جدید

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

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۷

۲۲ اکتبر ۲۰۲۵

androidx.xr.runtime:runtime-*:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

• SessionConfigureConfigureNotSupported حذف کرده و آن را با UnsupportedOperationException ( I7680f ) جایگزین کنید.

نسخه ۱.۰.۰-alpha06

۲۴ سپتامبر ۲۰۲۵

androidx.xr.runtime:runtime-*:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

• HandJointType از xr:arcore:arcore xr:runtime:runtime arcore:arcore منتقل شده است ( Iadb9c ، b/409058039 ).
• تغییر عملگر ضرب برای componentWiseMultiplication برای Vector2 ، Vector3 ، Vector4 به مقیاس و حذف نماد عملگر برای سازگاری با سایر کتابخانه‌های ریاضی. همچنین حذف componentWiseDivision از کلاس‌های Vector به جای استفاده از Vector.scale(otherVector.inverse()) . ( I8e1f6 ، b/399146447 )
• اضافه کردن [unscaled] برای برگرداندن یک ماتریس با مقیاس یک. ( I6381d , b/434928658 )
• :xr:runtime:runtime-guava حذف خواهد شد زیرا Coroutines.kt با SuspendtoFutureAdapter جایگزین شده است. ( I0cd3c ، b/406597902 )

نسخه ۱.۰.۰-آلفا۰۵

۳۰ ژوئیه ۲۰۲۵

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 )
• یک overload اضافی برای Session.create اضافه شده است که می‌تواند یک LifecycleOwner برای Session جهت اتصال به آن فراهم کند. توجه داشته باشید که همچنان برای مالکیت منابع، یک Activity باید ارائه شود و LifecycleOwner باید در Activity تعریف شود. ( I1690b )
• تغییر نام FakeRuntimeAnchor.anchorsCreated به anchorsCreatedCount ( I96df9 ، b/424441218 )
• پیکربندی *Mode برای انعکاس رفتارشان تغییر نام داده شده‌اند. ( I6d247 ، b/414648065 )
• پروژه‌های منتشر شده با کاتلین ۲.۰ برای استفاده به KGP 2.0.0 یا جدیدتر نیاز دارند ( Idb6b5 ، b/344563182 )
• APIهای مربوط به رشته‌های manifest از :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 )
• این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان Kotlin باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش‌فرض است که از نسخه 2.1.0 کامپایلر Kotlin شروع می‌شود) ( Ia8420 ، b/326456246 )
• مصنوع اصلی زمان اجرا ( :xr:runtime:runtime ) فقط شامل APIهای ناهمزمان به سبک Kolin خواهد بود. توسعه‌دهندگان جاوا می‌توانند برای دسترسی به APIهای سازگار به :xr:runtime:runtime-guava وابسته باشند. ( I05d4a , b/426639315 )
• مصنوع اصلی زمان اجرا ( :xr:runtime:runtime ) فقط شامل APIهای ناهمزمان به سبک کاتلین خواهد بود. توسعه‌دهندگان جاوا می‌توانند برای دسترسی به APIهای سازگار به کتابخانه xr:runtime:runtime-rxjava3 وابسته باشند. ( I64122 , b/426639775 )
• Coroutineها را به :xr:runtime:runtime-guava و Flowها را به :xr:runtime:runtime-rxjava3 منتقل کنید ( I60ae9 )
• Session.create و Session.configure اکنون در صورت عدم اعطای مجوزهای کافی، به جای بازگرداندن SessionCreatePermissionsNotGranted یا SessionConfigurePermissionsNotGranted ، خطای SecurityException صادر می‌کنند ( I7c488 ، b/430651879 ).

نسخه ۱.۰.۰-آلفا۰۴

۷ مه ۲۰۲۵

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 برای قابلیت همکاری بیشتر با الگوهای چرخه حیات اندروید موجود، پیاده‌سازی می‌کند.
• رشته‌های مانیفست برای اندروید XR در اینجا مشخص و مستند شده‌اند.
• متدهای افزونه‌ی فراخوانی قابلیت دید مکانی (Spatial Visibility) برای نظارت بر حرکت محتوای صحنه در داخل یا خارج از میدان دید کاربر اضافه شده‌اند.
• یک نسخهٔ خام از JxrPlatformAdapter (و تمام کلاس‌های مرتبط با آن) اضافه شد.
• به جای Session در SceneCore ، از Session در SceneCore و Runtime استفاده خواهد شد.
• ActivityPose.hitTest اضافه شد که امکان hitTest در برابر محتوای مجازی فراهم می‌کند.
• اکنون پشتیبانی از چندین پیاده‌سازی زمان اجرا در زمان کامپایل امکان‌پذیر است. فقط یکی از آنها در زمان اجرا بر اساس مجموعه ویژگی‌های دستگاه فعلی بارگذاری خواهد شد.
• نوع کامپوننت جدید SpatialPointerComponent اضافه شده است که به کلاینت‌ها اجازه می‌دهد آیکون رندر شده برای اشاره‌گر را مشخص کنند یا آیکون را غیرفعال کنند. این کامپوننت در حال حاضر فقط می‌تواند به نمونه‌های PanelEntity متصل شود.

تغییرات API

• پیاده‌سازی پیکربندی را عمومی کنید. ( I95860 )
• اضافه کردن HandJointType و TrackingState . ( I55880 )
• پروژه‌های منتشر شده با کاتلین ۲.۰ برای استفاده به 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 فراخوانی کرد تا ویژگی‌های زمان اجرا (runtime) موجود را پیکربندی کند.
• Session.create اکنون از ارسال CoroutineContext به جای CoroutineDispatcher پشتیبانی می‌کند.
• Session.create از بارگذاری ARCore برای Jetpack XR و/یا SceneCore پشتیبانی می‌کند. حداقل یکی باید ارائه شود (نسخه‌های آزمایشی موجود است).
• FakePerceptionManager وقتی یک UUID نامعتبر به Anchor.load و Anchor.unpersist ارسال شود، خطای AnchorInvalidUuidException صادر می‌کند.
• CoreState دیگر یک کلاس داده نیست.

رفع اشکالات

• تنظیمات پروگارد زمان اجرا اصلاح شد.

نسخه ۱.۰.۰-آلفا۰۳

۲۶ فوریه ۲۰۲۵

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 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-آلفا۰۲

۱۲ فوریه ۲۰۲۵

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 الزامی است.

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

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

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۱

۱۲ دسامبر ۲۰۲۴

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

ویژگی‌های انتشار اولیه

انتشار اولیه 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 از آنها استفاده کنید.