Sceneform Quickstart لنظام التشغيل Android

إعداد بيئة التطوير

  • تثبيت Android Studio الإصدار 3.1 أو إصدار أحدث مع الإصدار 7.0 من نظام التشغيل Android SDK Platform (المستوى 24 لواجهة برمجة التطبيقات) أو إصدار أحدث

  • ستحتاج إلى فهم أساسي لتطوير Android. إذا كنت مستخدمًا جديدًا لنظام التشغيل Android، يمكنك الاطّلاع على إنشاء تطبيق Android الأول للمبتدئين.

فتح نموذج المشروع

احصل على نماذج للمشاريع. يمكنك تنفيذ إجراء مما يلي:

  • تنزيل نماذج عينات واستخراجها

    -أو-

  • إنشاء نسخة طبق الأصل من المستودع باستخدام الأمر التالي:

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

في "استوديو Android"، افتح نموذج المشروع Welcome Sceneform، المتوفّر في الدليل الفرعي app ضمن الدليل sceneform-android-sdk.

إعداد الجهاز أو المحاكي

يمكنك تشغيل تطبيقات الواقع المعزّز على جهاز متوافق أو في محاكي Android:

هناك متطلبات إضافية لتشغيل Sneneme apps في المحاكي:

  • يجب استخدام إصدار Android Emulator 27.2.9 أو إصدار أحدث.

  • يجب أن يكون الإصدار OpenGL ES 3.0 أو إصدارًا أحدث متاحًا في "محاكي Android".

    • وتأكّد من ضبط المحاكي لاستخدام أحدث إصدار. في لوحة عناصر التحكّم الموسَّعة (المزيد في شريط الأدوات)، اختَر الإعدادات &gt؛ الإعدادات المتقدّمة &gt؛ مستوى واجهة برمجة تطبيقات OpenGL ES؛gt؛ الحد الأقصى لبرنامج العرض (حتى OpenGL ES 3.1)، ثم أعِد تشغيل المحاكي.

    • شغِّل المحاكي وتفاعل لفترة قصيرة مع المحاكي المحاكى، ثم تحقّق مما إذا كان يتم استخدام OpenGL ES 3.0 أو إصدار أحدث:

      adb logcat | grep eglMakeCurrent

      إذا كان لديك إصدار ver 3 0 أو إصدار أحدث، يمكنك تشغيل تطبيقات Sceneform. إذا كنت ترى إصدارًا أقل، هذا يعني أن وحدة معالجة الرسومات للكمبيوتر المكتبي لا تتوافق مع OpenGL ES 3.0 وعليك استخدام جهاز متوافق لتشغيل تطبيقات Sceneform.

تنفيذ النموذج

تأكّد من توصيل جهاز Android بجهاز التطوير، ثم انقر على رمز التشغيل في "استوديو Android". بعد ذلك، اختَر جهازك كهدف للنشر وانقر على حسنًا.

يطوّر "استوديو Android" مشروعك على ملف APK يمكن تصحيح الأخطاء فيه ويثبّت حِزمة APK ثم يشغّل التطبيق على جهازك. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على إنشاء التطبيق وتشغيله.

قد يُطلب منك تثبيت خدمات Google Play للواقع المعزّز أو تحديثها في حال عدم توفّرها أو أنّها قديمة. اختَر متابعة لتثبيت التطبيق من "متجر Google Play".

يتيح لك تطبيق Hello Sceneform وضع تماثيل Android ومعالجتها على الأسطح المسطحة.

إضافة Sceneform إلى مشروع حالي

لاستخدام Sceneform في مشروع حالي:

  1. اتّبِع خطوات تفعيل ARCore في تطبيقك.

  2. أضِف مكتبة Sceneform إلى ملف app's 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'
}

الخطوات اللاحقة