คู่มือเริ่มต้นฉบับย่อสําหรับ Android

ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์

เปิดโปรเจ็กต์ตัวอย่าง

รับโปรเจ็กต์ตัวอย่าง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

  • ดาวน์โหลดและแตกไฟล์ตัวอย่างฉาก

    -หรือ-

  • โคลนที่เก็บด้วยคําสั่งต่อไปนี้

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

ใน Android Studio ให้เปิดโปรเจ็กต์ตัวอย่าง Hello Sceneform ซึ่งอยู่ในไดเรกทอรีย่อย app ภายในไดเรกทอรี sceneform-android-sdk

เตรียมอุปกรณ์หรือโปรแกรมจําลอง

คุณสามารถเรียกใช้แอป AR บนอุปกรณ์ที่รองรับหรือ ในโปรแกรมจําลอง Android โดยทําดังนี้

มีข้อกําหนดเพิ่มเติมในการเรียกใช้แอป Scenform ในโปรแกรมจําลอง

  • คุณต้องมี Android Emulator เวอร์ชัน 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

เรียกใช้ตัวอย่าง

ตรวจสอบว่าอุปกรณ์ Android เชื่อมต่อกับเครื่องพัฒนาซอฟต์แวร์ แล้วคลิกเรียกใช้ ใน Android Studio จากนั้นเลือกอุปกรณ์เป็นเป้าหมายการทําให้ใช้งานได้ แล้วคลิกตกลง

Android Studio สร้างโปรเจ็กต์เป็น APK ที่แก้ไขข้อบกพร่องได้ ติดตั้ง APK จากนั้นจึงเรียกใช้แอปในอุปกรณ์ ดูข้อมูลเพิ่มเติมได้ที่สร้างและเรียกใช้แอป

ระบบอาจแจ้งให้ติดตั้งหรืออัปเดตบริการ Google Play สําหรับ AR หากขาดหายไปหรือล้าสมัย เลือกดําเนินการต่อเพื่อติดตั้งจาก Google Play Store

แอป Hello Sceneform ช่วยให้คุณวางและดัดแปลงโมเดล Android บนพื้นผิวราบเรียบได้

เพิ่ม Sceneform ในโปรเจ็กต์ที่มีอยู่

วิธีใช้ Sceneform ในโปรเจ็กต์ที่มีอยู่

  1. ทําตามขั้นตอนเพื่อเปิดใช้ ARCore ในแอป

  2. เพิ่มไลบรารี Sceneform ไปยังไฟล์ build.gradle ของ app's:

    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'
}

ขั้นตอนถัดไป