ARCore برای Jetpack XR

ARCore برای Jetpack XR

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

مرجع API
androidx.xr.arcore

محتوای دیجیتال را با قابلیت های ادراک وارد دنیای واقعی کنید.

آخرین به روز رسانی	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
12 دسامبر 2024	-	-	-	1.0.0-alpha01

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

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

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

شیار

dependencies {
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha01"
}

کاتلین

dependencies {
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha01")
}

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

بازخورد

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

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

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

نسخه 1.0

نسخه 1.0.0-alpha01

12 دسامبر 2024

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

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

با الهام از کتابخانه ARCore موجود، کتابخانه ARCore for Jetpack XR قابلیت هایی را برای ترکیب محتوای دیجیتال با دنیای واقعی فراهم می کند. این کتابخانه شامل ردیابی حرکت، لنگرهای مداوم، تست ضربه و شناسایی هواپیما با برچسب‌گذاری معنایی (به عنوان مثال، کف، دیوارها و میزها) است. برای کسب اطلاعات بیشتر در مورد کار با ARCore برای Jetpack XR ، راهنمای توسعه دهنده را مشاهده کنید.

• Session : ARCore برای Jetpack XR از Jetpack XR Runtime در زیر هود برای تقویت عملکرد خود استفاده می کند. شما از Session برای تعامل با بیشتر ARCore برای Jetpack XR API استفاده خواهید کرد، بنابراین لطفاً به مستندات آن نگاهی بیندازید.

• Plane : از هواپیما برای درک دنیای اطراف خود استفاده کنید. هر صفحه دارای یک Label است که آن را به صورت معنایی توصیف می کند. می‌توانید از subscribe استفاده کنید تا از آخرین هواپیماهای شناسایی‌شده مطلع شوید یا از تغییرات یک هواپیمای خاص مطلع state .

• Anchor : پیوندی بین یک شی مجازی و یک مکان در دنیای واقعی. لنگرها را می توان به یک مکان خاص در فضا (با استفاده از create ) یا Trackable (با استفاده از createAnchor ) متصل کرد.

  • لنگرها را می توان مجدداً در جلسات استفاده کرد. می توانید persist برای ذخیره آنها، از getPersistedAnchorUuids برای برشمردن آنها و load برای بازیابی آنها استفاده کنید. اطمینان حاصل کنید که پس از عدم استفاده از آنها، آنها unpersist .

  • لنگرها بین ARCore برای Jetpack XR و Jetpack SceneCore قابل اجرا هستند. شما می توانید یک AnchorEntity با استفاده از Anchor ایجاد کنید یا اگر AnchorEntity موجود دارید، می توانید getAnchor برای بازیابی لنگر پشتیبان آن استفاده کنید.

  • تعاملات طبیعی کاربر را با استفاده از hitTest ارائه دهید. یک hitTest از یک Ray برای تعیین اینکه کدام محتوا را قطع می کند و برای ایجاد یک Anchor از آن مکان استفاده می کند. انجام یک hitTest از یک InputEvent را در نظر بگیرید.

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

• ممکن است بین فراخوانی unpersist و حذف UUID آن از نتایج برگردانده شده توسط getPersistedAnchorUuids تاخیر وجود داشته باشد.

• create تایید نمی کند که سیستم منابع کافی برای برگرداندن لنگرهای جدید دارد. ایجاد مقدار بیش از حد لنگر ممکن است منجر به تصادف شود.

• تداوم یک لنگر که قبلاً ادامه داشت و ادامه نداشت در حال حاضر پشتیبانی نمی‌شود.

• استفاده در شبیه ساز پشتیبانی می شود، اما رفتار ممکن است به اندازه زمانی که روی یک دستگاه واقعی اجرا می شود پایدار نباشد. به ویژه، ممکن است تماس‌ها برای create با خطای کد بومی شکست بخورند و بلافاصله فعالیت را خاتمه دهند.

• در شرایط خاص، یک RuntimeException ممکن است به اشتباه هنگام فراخوانی persist با پیام "Anchor was not persisted" پرتاب شود. در آن شرایط، عملکرد همچنان موفق خواهد بود و لنگر ادامه خواهد داشت. ما توصیه می‌کنیم که تماس را برای persist با یک بلوک try به عنوان راه‌حل بسته بندی کنید.