Jetpack XR SDK شامل همه ابزارها و کتابخانه‌هایی است که برای ساختن تجربه‌های فراگیر و افزوده برای دستگاه‌های Android XR نیاز دارید.
ایجاد تجربه‌های کاملاً فراگیر
دستگاه‌های اختصاصی با وفاداری بالا مانند هدست‌های واقعیت گسترده و عینک‌های واقعیت گسترده سیمی را هدف قرار دهید. از ابزارهای توسعه مدرن Android مانند Kotlin و Compose، و همچنین ابزارهای نسل قبلی مانند Java و Views استفاده کنید. می‌توانید میانای کاربرتان را فضایی کنید، مدل‌های سه‌بعدی را بار کنید و رندر کنید و به‌طور معنایی دنیای واقعی را درک کنید.
اگر ازقبل برنامه تلفن همراه یا صفحه‌نمایش بزرگ در Android دارید، Jetpack XR SDK برنامه شما را به بُعد جدیدی می‌برد و این کار را با فضایی کردن چیدمان‌های موجود و بهبود تجربه‌های شما با مدل‌های سه‌بعدی و محیط‌های فراگیر انجام می‌دهد. برای توصیه‌های ما درباره فضایی کردن برنامه Android موجودتان، رهنمودهای کیفیت ما را ببینید.
ایجاد تجربه‌های مفید و افزوده
عینک‌های صوتی و عینک‌های نمایشگردار سبک و شیک را هدف قرار دهید. از ابزارهای توسعه مدرن Android مثل Kotlin و Jetpack Compose Glimmer استفاده کنید. از میاناهای برنامه‌سازی کاربردی استفاده کنید که تجربه‌های برنامه‌های فرافکنی‌شده از تلفن به عینک را تسهیل می‌کنند.
استفاده از کتابخانه‌های Jetpack
کتابخانه‌های Jetpack XR SDK یک جعبه‌ابزار جامع برای ساختن تجربه‌های غنی و فراگیر، تجربه‌های افزوده سبک و هر چیزی بین این دو ارائه می‌دهند. کتابخانه‌های زیر بخشی از Jetpack XR SDK هستند:
- Jetpack Compose برای XR: چیدمان‌های میانای کاربر فضایی را به‌صورت اعلانی بسازید که از قابلیت‌های فضایی Android XR بهره می‌برند.
- طراحی مواد برای واقعیت گسترده: با مؤلفه‌ها و چیدمان‌های «طراحی مواد» که با واقعیت گسترده سازگار می‌شوند بسازید.
- Jetpack SceneCore: ساختن و دستکاری کردن نمودار صحنه Android XR با محتوای سه‌بعدی.
- ARCore برای Jetpack XR: محتوای دیجیتال را با قابلیت‌های ادراکی به دنیای واقعی بیاورید.
- Jetpack Compose Glimmer: یک جعبه‌ابزار واسط کاربر برای ساختن تجربه‌های افزوده Android XR که برای عینک‌های نمایشگردار بهینه‌سازی شده است.
- Jetpack Projected: میاناهای برنامه‌سازی کاربردی که تجربه‌های برنامه پخش‌شده از تلفن به عینک صوتی یا عینک نمایشگردار را تسهیل می‌کنند.
توسعه میانای برنامه‌سازی کاربردی درطول «پیش‌نمای توسعه‌دهندگان نرم‌افزار»
کتابخانه‌های Jetpack XR SDK بخشی از «پیش‌نمای توسعه‌دهندگان نرم‌افزار Android XR» هستند و این میاناهای برنامه‌سازی کاربردی هنوز درحال توسعه هستند. برای مشکلات شناخته‌شده، یادداشت‌های انتشار کتابخانه را ببینید:
- یادداشت‌های انتشار Jetpack Compose ویژه واقعیت گسترده
- یادداشت‌های انتشار ARCore برای Jetpack XR
- یادداشت‌های انتشار Jetpack SceneCore
- یادداشت‌های انتشار زمان اجرای XR
- یادداشت‌های انتشار Jetpack Compose Glimmer
- یادداشت‌های انتشار Jetpack Projected
اگر با مشکلی مواجه شدید که در این فهرست‌ها نیست، لطفاً اشکال را گزارش کنید یا بازخورد ارسال کنید.
Jetpack Compose ویژه واقعیت گسترده
با Jetpack Compose برای واقعیت گسترده، می‌توانید از مؤلفه‌های فضایی‌شده مانند ردیف‌ها و ستون‌ها برای ساختن میانای کاربر و چیدمان‌های فضایی بااستفاده از مدل Compose آشنا و توصیفی استفاده کنید.
این کتابخانه همچنین ترکیب‌بندی‌های زیرفضایی، مانند پانل‌های فضایی و مدارگردها را ارائه می‌دهد که به شما امکان می‌دهد رابط کاربری مبتنی بر Compose یا Views دوبعدی موجود خود را در یک چیدمان فضایی قرار دهید. سایر ترکیب‌پذیرهای فضای فرعی انواع دیگر موارد استفاده فضایی را مدیریت می‌کنند، مانند SceneCoreEntity که به شما امکان می‌دهد موجودیت‌هایی مانند مدل‌های سه‌بعدی را نسبت به واسط کاربر خود قرار دهید.
می‌توانید از Jetpack Compose برای XR استفاده کنید، چه درحال فضایی‌سازی برنامه Android موجود خود باشید یا درحال ایجاد یک برنامه XR جدید از ابتدا.
برای اطلاعات بیشتر، راهنمای توسعه‌دهنده برای واسط کاربر فضایی و سند مرجع کتابخانه و میانای برنامه‌سازی کاربردی را ببینید.
طراحی مواد برای واقعیت گسترده
Material Design مؤلفه‌ها و چیدمان‌هایی ارائه می‌دهد که با XR سازگار می‌شوند. اگر با چیدمان‌های تطبیقی می‌سازید. درباره پیاده‌سازی Material Design برای XR بیشتر بدانید.
Jetpack SceneCore
کتابخانه Jetpack SceneCore به شما امکان می‌دهد محتوای سه‌بعدی را که توسط نهادها تعریف شده است، نسبت به یکدیگر و محیط خود قرار دهید و مرتب کنید. با SceneCore می‌توانید:
- تنظیم محیط‌های فضایی
- ایجاد نمونه‌های
PanelEntity - قرار دادن و پویانمایی کردن مدل‌های سه‌بعدی
- مشخص کردن منابع صدای فضایی
- افزودن «عناصر» به موجودیت‌ها که آن‌ها را قابل‌جابه‌جایی و تغییر اندازه می‌کند و می‌توان آن‌ها را به دنیای واقعی متصل کرد
کتابخانه Jetpack SceneCore همچنین از فضایی‌سازی برنامه‌های ساخته‌شده بااستفاده از Views پشتیبانی می‌کند. برای جزئیات بیشتر، راهنمای کار با نماها را ببینید.
برای اطلاعات دقیق‌تر، مرجع میانای برنامه‌سازی کاربردی را مشاهده کنید.
ARCore برای Jetpack XR
با الهام از کتابخانه ARCore موجود، کتابخانه ARCore برای Jetpack XR قابلیت‌هایی را برای ترکیب محتوای دیجیتال با دنیای واقعی ارائه می‌دهد. این کتابخانه شامل ردیابی حرکت، لنگرهای پایدار، آزمایش برخورد، و شناسایی سطح با برچسب‌گذاری معنایی (برای مثال، کف، دیوارها، و روی میز) است. این کتابخانه از پشته ادراک زیربنایی که توسط OpenXR پشتیبانی می‌شود استفاده می‌کند، که سازگاری با طیف گسترده‌ای از دستگاه‌ها را تضمین می‌کند و به آینده‌نگری برنامه‌ها کمک می‌کند.
برای اطلاعات دقیق‌تر، Work with ARCore for Jetpack XR را مشاهده کنید.
Jetpack Compose Glimmer
Jetpack Compose Glimmer یک جعبه‌ابزار میانای کاربر برای ساختن تجربه‌های واقعیت گسترده Android افزوده است که برای عینک‌های نمایشگردار بهینه‌سازی شده است. رابط کاربری زیبا، ساده، و راحتی برای دستگاه‌هایی که در تمام طول روز پوشیده می‌شوند بسازید.
- ساخته‌شده برای خوانایی و نگاه اجمالی: برخلاف تلفن‌ها، بوم اصلی یک نمایشگر شفاف نوری است—شفاف است. Jetpack Compose Glimmer تم‌سازی مخصوص عینک، پالت‌های رنگی ساده‌شده، و تایپوگرافی ارائه می‌دهد تا محتوای شما خوانا، سریع برای پردازش، و بدون حواس‌پرتی باشد.
- بهینه‌سازی‌شده برای تعاملات مختص پوشیدنی‌ها: ما مدل‌های تعامل را برای نحوه استفاده افراد از عینک بهینه‌سازی کرده‌ایم. مؤلفه‌های Jetpack Compose Glimmer دارای حالت‌های تمرکز واضح هستند، مانند طرح‌های کلی بهینه‌شده به‌جای جلوه‌های موج‌دار حواس‌پرت‌کننده، و برای مدیریت ورودی‌های فیزیکی رایج مانند ضربه زدن، تند کشیدن روی قاب، و البته صدا ساخته شده‌اند.
- از الگوهای آشنای میانای کاربر اعلانی استفاده کنید: چون Jetpack Compose Glimmer کاملاً براساس Jetpack Compose ساخته شده است، می‌توانید از هرآنچه درباره ساختن میانای کاربر اعلانی در Android می‌دانید استفاده کنید. ما مجموعه کاملی از توابع «ترکیب‌پذیر» اصلی و ازپیش‌ساخته‌شده ارائه می‌دهیم—چیزهایی مانند Text، Icon، Button، و مؤلفه‌های تخصصی مانند TitleChip—که همگی برای محیط عینک بهینه‌سازی شده‌اند.
Jetpack Projected
وقتی برای عینک صوتی و عینک نمایشگردار می‌سازید، برنامه‌تان در یک دستگاه میزبان همراه، مثل تلفن Android، اجرا می‌شود که تجربه‌های واقعیت گسترده برنامه‌تان را نمایش می‌دهد. Jetpack Projected به این دستگاه‌های میزبان Android امکان می‌دهد با عینک‌های صوتی یا نمایشگردار ارتباط برقرار کنند، مشروط بر اینکه دستگاه‌های میزبان قابلیت‌های فرافکنی واقعیت گسترده داشته باشند.
- دسترسی به سخت‌افزار دستگاه پخش‌شده: بافت دستگاهی که به دستگاه پخش‌شده (عینک صوتی یا عینک نمایشگردار) گره خورده است. این بافت فرافکنی‌شده دسترسی به سخت‌افزار دستگاه فرافکنی‌شده، مانند دوربین، را فراهم می‌کند. فعالیت‌های اختصاصی که به‌طور خاص برای نمایش در عینک صوتی یا عینک نمایشگردار ایجاد شده‌اند ازقبل به‌عنوان بافت پیش‌بینی‌شده عمل می‌کنند. اگر بخش دیگری از برنامه‌تان (مثل فعالیت تلفن یا سرویس) نیاز به دسترسی به سخت‌افزار عینک داشته باشد، می‌تواند بافت پیش‌بینی‌شده‌ای را به‌دست آورد.
- ساده‌سازی درخواست‌های اجازه: عینک صوتی و عینک نمایشگردار از مدل اجازه استاندارد Android پیروی می‌کنند، با اجازه‌های مختص عینک که باید در زمان اجرا درخواست شوند تا برنامه‌تان بتواند به سخت‌افزار دستگاه، مانند دوربین، دسترسی پیدا کند. کمک‌کننده اجازه این سازوکارهای درخواست اجازه را در هر دو میانای تلفن و عینک ساده می‌کند تا تجربه درخواست ثابتی ارائه دهد.
- بررسی قابلیت‌های دستگاه و نمایشگر: بررسی کنید که آیا دستگاه پخش‌شده نمایشگر دارد یا نه و وضعیت نمایشگر را برای ارائه تصاویر بررسی کنید. برنامه‌تان را براساس قابلیت‌های دستگاه تطبیق دهید. برای مثال، اگر دستگاه نمایشگر ندارد یا نمایشگر خاموش است، شاید بخواهید بافت صوتی بیشتری ارائه دهید.
- دسترسی به کنش‌های دوربین برنامه: برنامه شما می‌تواند به کنش‌های دوربین کاربر دسترسی داشته باشد، برای مثال برای روشن یا خاموش کردن دوربین در برنامه جاری‌سازی ویدیو.
آزمایش کردن تجربه‌های برنامه «واقعیت گسترده» با «شبیه‌ساز Android XR»
«شبیه‌ساز Android XR» نسخه تخصصی «شبیه‌ساز Android» است که برای توسعه برنامه واقعیت گسترده طراحی شده است. این شبیه‌ساز به شما امکان می‌دهد برنامه‌های XR خود را در محیط آشنای Android Studio آزمایش و اشکال‌زدایی کنید. برای هر نوع دستگاه Android XR، از دستگاه‌های غوطه‌ورکننده مانند هدست‌های واقعیت گسترده و عینک‌های واقعیت گسترده سیمی گرفته تا افزاردید هوشمند مانند عینک‌های صوتی و نمایشگر، دستگاه‌های مجازی ایجاد کنید.
وقتی برای اجرا و اشکال‌زدایی برنامه‌تان آماده بودید، این راهنماها را برای شروع ببینید:
- ایجاد کردن دستگاه‌های مجازی برای هدست‌های واقعیت گسترده و عینک‌های واقعیت گسترده
- ایجاد دستگاه‌های مجازی برای عینک‌های صوتی و نمایشگردار
OpenXR™ و نشان‌واره OpenXR علامت‌های تجاری متعلق به The Khronos Group Inc. هستند و به‌عنوان علامت تجاری در چین، اتحادیه اروپا، ژاپن، و پادشاهی متحد (UK) ثبت شده‌اند.