راهنماها

شروع به کار با Unity و Android XR

‫۶ دقیقه خواندن
مشاهده نمایه لوک هاپکینز
Luke Hopkins مهندس روابط توسعه‌دهندگان، Android

Samsung Galaxy XR با پشتیبانی Android XR اینجاست! این پست وبلاگ بخشی از هفته Spotlight Android XR ما است که در آن منابعی مانند پست‌های وبلاگ، ویدیوها، کد نمونه، و موارد دیگر را ارائه می‌دهیم که همگی برای کمک به شما در یادگیری، ساخت، و آماده‌سازی برنامه‌هایتان برای Android XR طراحی شده‌اند. 

هیچ‌وقت زمانی بهتر از الآن برای ورود به توسعه واقعیت گسترده نبوده است. در دسامبر گذشته، Android XR را معرفی کردیم، پلاتفرم Android جدید Google که براساس استانداردهای باز مانند OpenXR و Vulkan ساخته شده است و توسعه XR را بیش‌ازپیش دردسترس قرار می‌دهد.


و وقتی با ابزارهای XR موجود Unity ترکیب می‌شود، پشته توسعه قدرتمند و کاملی دریافت می‌کنید. این امر ایجاد و استقرار برنامه‌های «واقعیت گسترده» را که در چندین دستگاه کار می‌کنند ممکن می‌سازد.

openxr_face_tracking2.webp

چه قبلاً توسعه واقعیت گسترده انجام داده باشید چه نه، می‌خواهیم به شما کمک کنیم شروع کنید.

این وبلاگ شما را با توسعه Android XR و Unity آشنا می‌کند و راه‌اندازی آن را به شما آموزش می‌دهد. ما بر مراحل عملی پیکربندی محیط شما، درک اکوسیستم بسته، و شروع ساخت تمرکز خواهیم کرد.

در پایان این وبلاگ، درک خوبی از موارد زیر خواهید داشت:

  • بوم‌سازگان بسته
  • مراحل ضروری راه‌اندازی
  • روش‌های ورودی
  • حریم خصوصی و اجازه‌ها
  • لایه‌های ترکیب‌بندی

Unity برای توسعه Android XR

ممکن است Unity را به‌دلیل سازگاری چندسکویی آن انتخاب کنید، که به شما امکان می‌دهد یک‌بار بسازید و در Android XR و سایر دستگاه‌های XR مستقر کنید.

هنگام استفاده از Unity، از اکوسیستم و ابزارهای XR بالغ آن بهره‌مند می‌شوید. این موتور ازقبل بسته‌هایی مانند XR Interaction Toolkit، افزونه OpenXR، لایه‌های ترکیب‌بندی XR، XR Hands، فروشگاه دارایی گسترده‌ای پر از الگوها و مؤلفه‌های آماده XR، و ابزارهای شبیه‌سازی و آزمایش XR را ایجاد کرده است. و ازآنجایی‌که Unity 6 در نوامبر گذشته منتشر شد، از بهبود عملکرد Universal Render Pipeline (URP)، پشتیبانی بهتر از گرافیک Vulkan، و نمایه‌های ساخت بهبودیافته نیز بهره‌مند خواهید شد.

در اینجا چند پروژه نمونه آورده شده است تا با کارهایی که می‌توان انجام داد آشنا شوید:

راه‌اندازی ضروری: پایه توسعه شما

الزامات و نصب Unity 6

برای ایجاد برنامه به Unity 6 نیاز دارید، زیرا نسخه‌های قبلی از Android XR پشتیبانی نمی‌کنند. با دنبال کردن این مراحل، ابتدا Unity Hub و سپس Unity 6 را با ماژول «پشتیبانی ساخت Android» نصب کنید.

unity6.png

نمایه‌های ساخت Android XR: ساده‌سازی پیکربندی

نمایه‌های ساخت Unity دارایی‌های پروژه هستند که تنظیمات و پیکربندی‌های مختص پلاتفرم شما را ذخیره می‌کنند. بنابراین، به‌جای اینکه نیاز باشد ۱۵ تا ۲۰ تنظیم مختلف را به‌صورت دستی در چندین منو تنظیم کنید، می‌توانید از نمایه ساخت برای انجام خودکار این کار استفاده کنید.
می‌توانید نمایه‌های ساخت خودتان را ایجاد کنید، اما درحال‌حاضر توصیه می‌کنیم از نمایه ساخت اختصاصی Android XR که ما ایجاد کرده‌ایم استفاده کنید.

می‌توانید نمایه ساخت خود را با انتخاب «فایل > نمایه ساخت» از پروژه Unity خود انتخاب کنید. برای دستورالعمل‌های کامل، به صفحه گردش کار توسعه برای Android XR مراجعه کنید.

اگر خودتان تغییراتی ایجاد کنید، می‌توانید نمایه ساخت جدیدی ایجاد کنید تا با تیمتان هم‌رسانی کنید. به‌این‌ترتیب، تجربه ساخت یکسانی را در سراسر صفحه تضمین می‌کنید.

buildprofiles.png

پس‌از این مراحل، می‌توانید APK خود را برای دستگاه‌های Android XR بسازید و اجرا کنید.

میانای برنامه‌سازی کاربردی گرافیک: چرا Vulkan مهم است

وقتی پروژه Unity خود را با نمایه ساخت Android XR راه‌اندازی کردید، ابتدا توصیه می‌کنیم مطمئن شوید که Vulkan را به‌عنوان میانای برنامه‌سازی کاربردی گرافیک خود تنظیم کرده‌اید. ‫Android XR به‌عنوان پلاتفرمی با اولویت Vulkan ساخته شده است. در مارس ۲۰۲۵، Google اعلام کرد که Vulkan اکنون میانای برنامه‌سازی کاربردی گرافیک رسمی برای Android است. این یک میانای برنامه‌سازی کاربردی گرافیکی مدرن و سطح پایین است که به توسعه‌دهندگان کمک می‌کند عملکرد GPUهای مدرن را به حداکثر برسانند و ویژگی‌های پیشرفته‌ای مانند ردیابی پرتوها و چندرشته‌ای را برای تصاویر واقعی و فراگیر بازی باز کنند.

این استانداردها بهترین سازگاری را برای برنامه‌های موجود شما فراهم می‌کنند و مشکلات و هزینه‌های انتقال را کاهش می‌دهند. و فعال کردن ویژگی‌های پیشرفته Android XR مانند URP Application Space Warp و foveated rendering را ممکن می‌سازد. 

Unity 6 به‌طور خودکار Vulkan را مدیریت می‌کند، بنابراین وقتی از نمایه ساخت Android XR استفاده می‌کنید، Unity Vulkan را به‌عنوان میانای برنامه‌سازی کاربردی گرافیک شما پیکربندی می‌کند. این کار باعث می‌شود بدون هیچ‌گونه پیکربندی دستی به همه ویژگی‌های پیشرفته Android XR دسترسی پیدا کنید.

می‌توانید تنظیمات میانای برنامه‌سازی کاربردی گرافیک را با رفتن به «ویرایش» > «تنظیمات پروژه» > «پخش‌کننده» > «برگه Android» > «تنظیمات دیگر» > «میاناهای برنامه‌سازی کاربردی گرافیک» به‌تأیید برسانید.

graphics-api.png
appentrypoint.png

آشنا شدن با بوم‌سازگان بسته

دو بسته مختلف وجود دارد که می‌توانید برای Android XR در Unity استفاده کنید. یکی از آن‌ها استفاده از «افزونه‌های Android XR» برای Unity است و دیگری استفاده از Unity OpenXR: بسته Android XR است.

این‌ها ممکن است یکسان به‌نظر برسند، اما با من همراه باشید.

بسته Unity OpenXR: Android XR بسته رسمی Unity برای پشتیبانی از Android XR است. این مؤلفه اکثر ویژگی‌های Android XR را ارائه می‌دهد که ازطریق استانداردهای OpenXR دردسترس قرار می‌گیرند. همچنین ادغام AR Foundation را برای ویژگی‌های واقعیت ترکیبی فعال می‌کند. مزیت اصلی استفاده از بسته Unity OpenXR: Android XR این است که یک API یکپارچه برای پشتیبانی از دستگاه‌های XR ارائه می‌دهد.


درحالی‌که افزونه‌های Android XR برای Unity بسته XR متعلق به Google است که به‌طور خاص برای توسعه دستگاه‌های Android XR طراحی شده است. این بسته Unity OpenXR را با ویژگی‌های اضافی مانند حالت‌های ترکیب محیط، مش‌بندی صحنه، ردیابی تصویر، و ردیابی بدن تکمیل می‌کند. نکته منفی این است که فقط می‌توانید برای دستگاه‌های Android XR توسعه دهید.


انتخاب شما به نیازهای خاصتان بستگی دارد، اما به‌طور کلی توصیه می‌کنیم از Unity OpenXR: Android XR استفاده کنید، زیرا انعطاف‌پذیری بسیار بیشتری برای دستگاه‌هایی که برنامه‌تان با آن‌ها سازگار خواهد بود فراهم می‌کند، و سپس براساس الزامات برنامه‌تان می‌توانید «افزونه‌های Android XR» را برای Unity اضافه کنید.

نحوه نصب بسته‌ها

برای افزودن بسته جدید، درحالی‌که پروژه شما در Unity باز است، «پنجره» > «مدیریت بسته» > «مدیر بسته» را انتخاب کنید.

از اینجا می‌توانید این بسته‌ها را از برگه «Unity Registry» نصب کنید:

packagemanager.png

می‌توانید بسته Android XR برای Unity را ازطریق Github با انتخاب نماد ➕، انتخاب «نصب بسته از نشانی وب git»، و سپس وارد کردن «https://github.com/android/android-xr-unity-package.git» نصب کنید

packagemanager2.png

ویژگی‌های OpenXR موردنیاز

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

می‌توانید تنظیم OpenXR را برای Android فعال کنید: «ویرایش» -> «تنظیمات پروژه» -> «مدیریت افزونه XR» -> روی Android کلیک کنید و OpenXR را فعال کنید

xrpluginmgmt.png

سپس باید پشتیبانی از «پشتیبانی Android XR» را فعال کنیم، ویژگی‌های دیگر OpenXR را درصورت نیاز پوشش خواهیم داد. درحال‌حاضر فقط باید پشتیبانی Android XR فعال شود.

ورودی

Android XR از ورودی برای دست‌ها، صدا، ردگیری چشم، صفحه‌کلید، و کنترل‌کننده‌ها پشتیبانی می‌کند. توصیه می‌کنیم XR Interaction Toolkit و XR Hands را نصب کنید زیرا این‌ها حاوی بهترین پیش‌ساخته‌ها برای شروع هستند. بااستفاده از این پیش‌ساخته‌ها، هرآنچه را که برای پشتیبانی از «دست‌ها» و «کنترل‌کننده‌ها» در برنامه‌تان نیاز دارید خواهید داشت.

xrinteractiontoolkit.png

وقتی XR Hands و XR Interactive toolkit هر دو نصب شدند، توصیه می‌کنم Starter Assets و Hands Interaction Demo را وارد کنید. سپس باید نمایه‌های تعامل با دست و کنترل‌کننده ساده Khronos را فعال کنید و ویژگی‌های «زیرسیستم ردیابی دست» و «هدف ردیابی دست Meta» را روشن کنید.

می‌توانید این تنظیمات را با رفتن به «ویرایش» > «تنظیمات پروژه» > «مدیریت افزایه XR» > «OpenXR» ویرایش کنید

profiles.png

همچنین پیش‌ساخته Unity، XR Origin، را توصیه می‌کنیم که موقعیت و جهت کاربر را در فضای واقعیت گسترده نشان می‌دهد. این شامل دکل دوربین و مؤلفه‌های ردیابی موردنیاز برای ارائه تجربه واقعیت گسترده شما از دیدگاه صحیح است.

ساده‌ترین راه برای افزودن این پیش‌ساخته، وارد کردن آن از نسخه نمایشی ادغام دست‌ها است که قبلاً وارد کردیم و در اینجا یافت می‌شود: «کیت ابزار ادغام دست‌ها» > «تعامل دست» > «پیش‌ساخته‌ها» > «مبدأ XR»

prefabs.png

توصیه می‌کنم از این Prefab به‌جای گزینه «XR Origin» در اشیای بازی‌تان استفاده کنید، زیرا از XR Input Modality Manager استفاده می‌کند که به‌طور خودکار بین دست‌های کاربر و کنترل‌کننده‌ها جابه‌جا می‌شود. این کار بهترین نتیجه را برای جابه‌جایی بین دست‌ها و کنترل‌کننده‌ها به شما می‌دهد.

حریم خصوصی و اجازه‌ها: ایجاد اعتماد در کاربر

هرچه می‌سازید، باید اجازه‌های زمان اجرا را از کاربران دریافت کنید. دلیل آن این است که درک صحنه، ردگیری چشم، ردگیری چهره، و ردگیری دست دسترسی به داده‌هایی را فراهم می‌کنند که ممکن است برای کاربر حساس‌تر باشند.

این قابلیت‌ها اطلاعات شخصی عمیق‌تری نسبت‌به برنامه‌های سنتی رایانه یا تلفن همراه ارائه می‌دهند، بنابراین اجازه‌های زمان اجرا تضمین می‌کنند که کاربران شما کنترل کاملی بر داده‌هایی که برای هم‌رسانی انتخاب می‌کنند داشته باشند. بنابراین، برای حفظ خط‌مشی‌های امنیتی و حریم خصوصی Android،‏ Android XR برای هریک از این ویژگی‌ها اجازه‌هایی دارد.

برای مثال، اگر از بسته XR Hands برای اشاره‌های سفارشی دست استفاده می‌کنید، باید اجازه ردیابی دست را درخواست کنید (به زیر مراجعه کنید) زیرا این بسته باید اطلاعات زیادی درباره دست‌های کاربر ردیابی کند. این شامل مواردی مثل ردیابی حالت‌های مفصل دست و سرعت‌های زاویه‌ای و خطی می‌شود؛

توجه: برای مشاهده فهرست کامل افزونه‌هایی که به اجازه نیاز دارند، اطلاعات موجود در وب‌سایت توسعه‌دهنده XR را بررسی کنید.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

بهبود کیفیت دیداری با لایه‌های ترکیب‌بندی

لایه ترکیب‌بندی روش توصیه‌شده برای رندر کردن عناصر میانای کاربر است. این کیت‌ها امکان نمایش عناصر را با کیفیت بسیار بالاتری نسبت‌به خط لوله رندرینگ استاندارد Unity فراهم می‌کنند، زیرا همه چیز مستقیماً در ترکیب‌کننده پلاتفرم رندر می‌شود.

برای مثال، اگر نوشتار نمایش می‌دهید، پرداز استاندارد Unity احتمالاً نوشتار تار، لبه‌های نرم، و مصنوعات بصری خواهد داشت. درحالی‌که با لایه‌های ترکیب‌بندی، نوشتار واضح‌تر، خطوط پیرامونی تیزتر، و تجربه کلی بهتر خواهد بود.


علاوه‌بر نوشتار، ویدیو، تصویر، و عناصر میانای کاربر را نیز با کیفیت بسیار بالاتری پرداز می‌زند. این کار را بااستفاده از پشتیبانی بومی برای لایه‌های ترکیب‌کننده زمان اجرا انجام می‌دهد.

برای روشن کردن «لایه‌های ترکیب‌بندی»، Package Manager را باز کنید، Unity Register را انتخاب کنید، سپس XR Composition Layers را نصب کنید.

ساختن و اجرا کردن

اکنون که بسته‌های OpenXR را نصب کرده‌اید و ویژگی‌ها را فعال کرده‌اید، یک راه‌اندازی پیش‌ساخته برای حرکت دست و سر، اکنون می‌توانید صحنه خود را بسازید و مستقیماً برای آزمایش در هدست خود مستقر کنید.

مرحله بعدی: گسترش مهارت‌های شما

اکنون که محیط توسعه نرم‌افزار Android XR را راه‌اندازی کرده‌اید و مفاهیم کلیدی را درک کرده‌اید، مراحل بعدی برای ادامه سفر توسعه XR شما در اینجا آمده است:

منابع ضروری برای ادامه یادگیری:

پروژه‌های نمونه برای کاوش:

نویسنده:
ادامه خواندن