واقعیت افزوده در یونیتی با Vuforia: راهنمای جامع از صفر تا صد

واقعیت افزوده یکی از هیجان‌انگیزترین فناوری‌های حال حاضر است که دنیای واقعی را با محتوای دیجیتال ترکیب می‌کند. در این مقاله، قدم‌به‌قدم یاد می‌گیرید چطور با استفاده از Unity و Vuforia اولین برنامه AR خود را بسازید.

مقدمه: Vuforia چیست و چرا باید از آن استفاده کنیم؟

Vuforia یکی از قدرتمندترین و محبوب‌ترین SDKهای توسعه واقعیت افزوده است که در سال ۲۰۱۷ به‌طور رسمی در یونیتی ادغام شد. این پلتفرم به شما امکان می‌دهد برنامه‌های AR حرفه‌ای برای دستگاه‌های اندروید، iOS و حتی عینک‌های هوشمند مانند HoloLens بسازید.

مزایای استفاده از Vuforia در یونیتی:

  • کاملاً رایگان برای توسعه و تست (با مجوز توسعه)
  • پشتیبانی از انواع مختلف نشانه‌ها (Image Target، 3D Object Tracking، VuMark)
  • دقت بالای ردیابی حتی در شرایط نوری مختلف
  • گردش کاری ساده و کشیدن-و-رها کردن در یونیتی

مرحله 1: آماده‌سازی محیط توسعه

نصب یونیتی با پشتیبانی Vuforia

اولین قدم، نصب نسخه مناسب یونیتی است. توصیه می‌شود از Unity 2021 LTS یا جدیدتر استفاده کنید.

  1. Unity Hub را نصب کنید
  2. هنگام نصب یونیتی، حتماً گزینه‌های زیر را انتخاب کنید:
  • Android Build Support (برای خروجی اندروید)
  • Vuforia Augmented Reality Support

اگر قبلاً یونیتی را نصب کرده‌اید، نگران نباشید! می‌توانید از طریق Unity Hub به نسخه نصب‌شده بروید و روی “Add Modules” کلیک کنید تا ماژول‌های مورد نیاز را اضافه کنید.

نصب JDK و Android SDK (برای خروجی اندروید)

برای ساختن فایل APK و تست روی گوشی اندروید، به این ابزارها نیاز دارید:

  • Java Development Kit (JDK) نسخه ۸ یا ۱۱
  • Android SDK (به همراه Android Studio)

بعد از نصب، مسیر این ابزارها را در یونیتی تنظیم کنید:

Edit > Preferences > External Tools

مسیر JDK و SDK را به پوشه‌های نصب شده指向 دهید.

مرحله 2: دریافت مجوز (License Key) از Vuforia

برای استفاده از Vuforia به یک کلید مجوز رایگان نیاز دارید:

  1. به Vuforia Developer Portal بروید و ثبت‌نام کنید
  2. وارد License Manager شوید
  3. روی Get Development Key کلیک کنید
  4. یک نام برای مجوز خود انتخاب کنید (مثلاً MyFirstARApp)
  5. پس از ایجاد، کلید مجوز (License Key) را کپی کنید – بعداً به آن نیاز خواهید داشت

نکته مهم: توصیه می‌شود با ایمیل Gmail ثبت‌نام کنید زیرا برخی ایمیل‌های ایرانی ممکن است تأییدیه Vuforia را اسپم کنند.

مرحله 3: ساخت دیتابیس تصاویر (Image Target Database)

تصاویر هدف (Image Targets) همان نشانه‌هایی هستند که با دیدن آنها، محتوای دیجیتال شما نمایش داده می‌شود.

ویژگی‌های یک تصویر هدف خوب

برای اینکه Vuforia تصویر شما را به خوبی تشخیص دهد، تصویر باید دارای ویژگی‌های زیر باشد:

  • کنتراست بالا بین بخش‌های مختلف تصویر
  • لبه‌های تیز و مشخص – تصاویر با لبه‌های نرم و ارگانیک ضعیف عمل می‌کنند
  • الگوهای غیر تکراری – تصاویر تکراری مانند صفحه‌شطرنجی اصلاً قابل تشخیص نیستند
  • توزیع یکنواخت نقاط ویژگی (Features) در سراسر تصویر

تصاویر در Vuforia از ۱ تا ۵ ستاره رتبه‌بندی می‌شوند. برای بهترین نتیجه، تصاویر ۴ یا ۵ ستاره را هدف بگیرید.

مراحل ساخت دیتابیس

  1. در Vuforia Developer Portal به Target Manager بروید
  2. روی Add Database کلیک کنید
  3. نام دیتابیس را وارد کنید (مثلاً MyTargets)
  4. روی Add Target کلیک کنید و Single Image را انتخاب کنید
  5. تصویر خود را آپلود کنید و عرض فیزیکی آن را برحسب متر وارد کنید (مثلاً برای یک کارت 0.06 متر)
  6. پس از آپلود، منتظر بمانید تا Vuforia تصویر را پردازش کند و به آن امتیاز دهد
  7. روی دیتابیس کلیک کنید و Download Database را انتخاب کنید
  8. فرمت Unity Editor را انتخاب کنید و فایل unitypackage را دانلود کنید

مرحله 4: راه‌اندازی پروژه در یونیتی

حالا نوبت ساخت پروژه در یونیتی است:

ایجاد پروژه جدید

  1. یونیتی را باز کنید و یک پروژه سه‌بعدی (3D) جدید بسازید
  2. اسم پروژه را بگذارید، مثلاً MyFirstARApp
  3. منتظر بمانید تا محیط یونیتی باز شود

وارد کردن Vuforia

اگر هنگام نصب یونیتی گزینه Vuforia را انتخاب کرده‌اید، SDK از قبل نصب است. در غیر این صورت:

  • از طریق Window > Asset Store به Asset Store بروید
  • عبارت “Vuforia Engine” را جستجو کنید و آخرین نسخه را به پروژه import کنید

وارد کردن دیتابیس تصاویر

  • فایل unitypackage که از Target Manager دانلود کرده‌اید را با دوبار کلیک وارد پروژه کنید
  • یا از منوی Assets > Import Package > Custom Package استفاده کنید

مرحله 5: تنظیم صحنه AR

افزودن دوربین AR

  1. از منوی GameObject > Vuforia Engine > AR Camera را انتخاب کنید
  2. دوربین پیش‌فرض صحنه (Main Camera) را حذف کنید – دیگر به آن نیاز نداریم
  3. دوربین AR را در Hierarchy انتخاب کنید
  4. در پنل Inspector، روی Open Vuforia Configuration کلیک کنید
  5. کلید مجوز (License Key) که قبلاً از Vuforia گرفته بودید را در فیلد App License Key paste کنید

افزودن Image Target

  1. از منوی GameObject > Vuforia Engine > Image Target را انتخاب کنید
  2. در Inspector، کامپوننت Image Target Behaviour را پیدا کنید
  3. Type را روی From Database قرار دهید
  4. Database را روی دیتابیسی که import کرده‌اید تنظیم کنید
  5. Image Target را روی تصویر مورد نظر خود قرار دهید

مرحله 6: افزودن محتوای دیجیتال

حالا جالب‌ترین بخش: اضافه کردن مدل سه‌بعدی یا هر محتوای دیگری که می‌خواهید روی تصویر هدف ظاهر شود!

روش اضافه کردن محتوا

  1. مدل سه‌بعدی خود را (مثلاً از Asset Store یا مدل‌های آماده یونیتی) به پروژه import کنید
  2. مدل را از پنجره Project به Hierarchy بکشید و روی Image Target رها کنید تا به‌طور خودکار به عنوان فرزند (Child) آن تنظیم شود
  3. موقعیت و مقیاس مدل را تنظیم کنید تا به خوبی روی تصویر هدف قرار گیرد

نکته: وقتی محتوا را به عنوان فرزند Image Target اضافه می‌کنید، فقط زمانی نمایش داده می‌شود که تصویر هدف تشخیص داده شود.

چرخاندن خودکار مدل با یک اسکریپت ساده

می‌توانید با این اسکریپت ساده، مدل خود را به آرامی بچرخانید:

using UnityEngine;

public class RotateScript : MonoBehaviour
{
    public float speed = 20f;

    void Update()
    {
        transform.Rotate(Vector3.up, speed * Time.deltaTime);
    }
}

این اسکریپت را به مدل خود attach کنید و سرعت چرخش را تنظیم کنید.

مرحله 7: تست در Editor (بدون نیاز به گوشی)

قبل از خروجی گرفتن، می‌توانید برنامه را در خود یونیتی تست کنید:

  1. مطمئن شوید وب‌کم یا دوربین لپ‌تاپ شما کار می‌کند
  2. دکمه Play را در بالای یونیتی بزنید
  3. تصویر هدف خود را (چاپ شده یا روی صفحه مانیتور) جلوی دوربین بگیرید
  4. مدل سه‌بعدی شما باید روی تصویر ظاهر شود

مرحله 8: خروجی گرفتن (Build) برای اندروید

اگر همه چیز درست کار کرد، وقت خروجی گرفتن و نصب روی گوشی است:

تنظیمات Build

  1. به File > Build Settings بروید
  2. پلتفرم Android را انتخاب کنید و روی Switch Platform کلیک کنید
  3. صحنه فعلی خود را به Scenes in Build اضافه کنید

تنظیمات Player

روی Player Settings کلیک کنید و موارد زیر را تنظیم کنید:

  • Product Name: نام برنامه خود را وارد کنید
  • Package Name: مثلاً com.yourname.myfirstarapp
  • Minimum API Level: حداقل Android 8.0 (API Level 26) را انتخاب کنید
  • در بخش XR Settings مطمئن شوید Vuforia Augmented Reality Supported فعال است

ساختن APK

  1. در Build Settings روی Build کلیک کنید
  2. یک نام برای فایل انتخاب کنید (مثلاً MyFirstARApp.apk)
  3. منتظر بمانید تا فرآیند Build کامل شود
  4. فایل APK را به گوشی انتقال دهید و نصب کنید

نکته: برای نصب مستقیم روی گوشی متصل، می‌توانید از Build And Run استفاده کنید.

مرحله 9: تست نهایی

حالا لحظه حقیقت فرا رسیده:

  1. برنامه را روی گوشی اجرا کنید
  2. تصویر هدف خود را چاپ کنید یا روی صفحه نمایشگر باز کنید
  3. دوربین گوشی را روی تصویر بگیرید
  4. مدل سه‌بعدی شما باید روی تصویر ظاهر شود و با حرکت دادن تصویر، همراه آن حرکت کند! 🎉

عیب‌یابی مشکلات رایج

مشکلراه حل
تصویر هدف شناسایی نمی‌شوداز تصویری با کنتراست بالاتر و لبه‌های تیزتر استفاده کنید. نور محیط را افزایش دهید
مدل در Editor نشان داده می‌شود ولی در گوشی نهShader مدل را به Standard تغییر دهید – برخی Shaderها روی موبایل پشتیبانی نمی‌شوند
Build فیل می‌شودمطمئن شوید JDK و SDK به درستی نصب و مسیردهی شده‌اند. از JDK نسخه ۸ یا ۱۱ استفاده کنید
برنامه کرش می‌کندمجوز دوربین را در گوشی بررسی کنید. ممکن است برنامه برای اولین بار نیاز به اجازه دسترسی به دوربین داشته باشد

گام بعدی: چه چیزهای دیگری می‌توانید بسازید؟

Vuforia امکانات پیشرفته‌تری هم دارد که می‌توانید یاد بگیرید:

  • Multiple Image Targets: شناسایی چند تصویر همزمان در یک صحنه
  • Virtual Buttons: ایجاد دکمه‌های قابل تشخیص روی تصویر هدف
  • Model Target: ردیابی اشیاء سه‌بعدی واقعی (مانند یک قوطی نوشابه)
  • VuMark: ترکیبی از QR کد و Image Target
  • Ground Plane: قرار دادن اشیاء روی زمین یا میز (بدون نیاز به تصویر هدف)

جمع‌بندی

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

Vuforia با ادغام عالی در یونیتی، شما را قادر می‌سازد بدون نیاز به تخصص عمیق در بینایی کامپیوتر، برنامه‌های AR حرفه‌ای بسازید. حالا نوبت شماست که خلاقیت خود را به کار بگیرید و ایده‌های جذابتان را به واقعیت تبدیل کنید!