Sceneform Quickstart برای اندروید

محیط توسعه خود را تنظیم کنید

پروژه نمونه را باز کنید

پروژه های نمونه را دریافت کنید. شما می توانید یا:

  • نمونه های Sceneform را دانلود و استخراج کنید

    -یا-

  • با دستور زیر مخزن را کلون کنید:

    git clone https://github.com/google-ar/sceneform-android-sdk.git

در Android Studio، پروژه نمونه Hello Sceneform را که در فهرست فرعی برنامه در پوشه sceneform-android-sdk قرار دارد، باز کنید.

دستگاه یا شبیه ساز خود را آماده کنید

می‌توانید برنامه‌های واقعیت افزوده را در دستگاه پشتیبانی‌شده یا در شبیه‌ساز Android اجرا کنید:

الزامات اضافی برای اجرای برنامه های Sceneform در شبیه ساز وجود دارد:

  • شما به شبیه ساز اندروید نسخه 27.2.9 یا بالاتر نیاز دارید.

  • OpenGL ES 3.0 یا بالاتر باید در شبیه ساز Android پشتیبانی و فعال شود.

    • اطمینان حاصل کنید که شبیه ساز شما برای استفاده از آخرین نسخه پیکربندی شده است. در پنل کنترل های توسعه یافته (بیشتر در نوار ابزار، تنظیمات > پیشرفته > سطح API OpenGL ES > حداکثر رندر (تا OpenGL ES 3.1) را انتخاب کنید و سپس شبیه ساز را مجددا راه اندازی کنید.

    • شبیه ساز را اجرا کنید، به طور خلاصه با دستگاه شبیه سازی شده تعامل کنید، سپس بررسی کنید که آیا OpenGL ES 3.0 یا بالاتر استفاده می شود یا خیر:

      adb logcat | grep eglMakeCurrent

      اگر ver 3 0 یا بالاتر را می بینید، می توانید برنامه های Sceneform را اجرا کنید. اگر نسخه پایین‌تری را مشاهده می‌کنید، پس GPU دسکتاپ شما از OpenGL ES 3.0 پشتیبانی نمی‌کند و باید از یک دستگاه پشتیبانی‌شده برای اجرای برنامه‌های Sceneform استفاده کنید.

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

مطمئن شوید که دستگاه اندرویدی شما به دستگاه توسعه متصل است و روی Run کلیک کنید در اندروید استودیو سپس، دستگاه خود را به عنوان هدف استقرار انتخاب کنید و روی OK کلیک کنید.

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

ممکن است از شما خواسته شود که اگر سرویس‌های Google Play برای واقعیت افزوده وجود ندارد یا قدیمی است، آن را نصب یا به‌روزرسانی کنید. برای نصب آن از فروشگاه Google Play، CONTINUE را انتخاب کنید.

برنامه Hello Sceneform به شما امکان می دهد مجسمه های اندروید را روی سطوح صاف قرار دهید و آنها را دستکاری کنید.

Sceneform را به یک پروژه موجود اضافه کنید

برای استفاده از Sceneform در یک پروژه موجود:

  1. مراحل را برای فعال کردن ARCore در برنامه خود دنبال کنید

  2. کتابخانه Sceneform را به فایل build.gradle برنامه خود اضافه کنید:

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

مراحل بعدی