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

ในการเริ่มต้นใช้งาน ARCore กับ Android คุณสามารถเรียกใช้ แอปตัวอย่าง hello_ar_kotlin หรือ hello_ar_java มาพร้อมกับ ARCore SDK แอปตัวอย่างเหล่านี้ใช้ OpenGL ซึ่งเป็น อินเทอร์เฟซการเขียนโปรแกรมสำหรับแสดงภาพกราฟิกเวกเตอร์ 2 มิติและ 3 มิติ แอปจะแสดง เครื่องบินที่ตรวจพบและอนุญาตให้ผู้ใช้แตะบนเครื่องบินเพื่อวางโมเดล 3 มิติ

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

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

  1. โคลนที่เก็บ ARCore SDK GitHub ใน Android Studio

    ซึ่งทำได้หลายวิธี ดังนี้

    • สำหรับการติดตั้งใน Android Studio ที่มีอยู่แล้ว ให้ทำดังนี้

      • จากเมนู Git ให้เลือก Clone
      • ในVersion control แบบเลื่อนลง ให้เลือก Git เป็นระบบควบคุมเวอร์ชัน

      • ในช่อง URL ให้ป้อน URL ต่อไปนี้ไปยัง ARCore GitHub ที่เก็บ:

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

    • คุณสามารถเปิด Terminal และออกคำสั่ง git clone เป็น ดังต่อไปนี้:

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

  2. เปิดโปรเจ็กต์ตัวอย่างดังนี้ (คุณต้องเปิด เพื่อสร้างและเรียกใช้)

    • จากเมนู File ให้เลือก Open
    • ในโฟลเดอร์ arcore-android-sdk/samples ให้เลือก hello_ar_kotlin หรือ hello_ar_java โฟลเดอร์ แล้วคลิก Open

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

คุณสามารถเรียกใช้แอป AR ในอุปกรณ์ที่รองรับ หรือ ในโปรแกรมจำลองของ Android คุณต้องอัปเดตบริการ Google Play สำหรับ AR ในโปรแกรมจำลองก่อนเรียกใช้แอป โปรดดู เรียกใช้แอป AR ในโปรแกรมจำลอง Android สำหรับข้อมูลเพิ่มเติม

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

ตรวจสอบว่าอุปกรณ์ Android เชื่อมต่อกับเครื่องที่กำลังพัฒนาแล้วคลิก Run ใน Android Studio

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

คุณอาจได้รับแจ้งให้ติดตั้งหรืออัปเดตบริการ Google Play สำหรับ AR หากข้อมูลดังกล่าวขาดหายไปหรือล้าสมัย เลือก CONTINUE เพื่อติดตั้ง Google Play Store หรืออัปเดตด้วยตนเองตามที่อธิบายไว้ใน อัปเดตบริการ Google Play สำหรับ AR

แอป hello_ar_java ให้คุณวางจำนำ ARCore 3 มิติ ตรวจพบพื้นผิวระนาบ AR ซึ่งใช้ร่วมกับ Android GL SurfaceView ซึ่งใช้เพื่อแสดงภาพตัวอย่างจากกล้องและวัตถุ AR พื้นฐาน เช่น เครื่องบิน และ Anchor โปรดดูเฟรมเวิร์กการแสดงผลตัวอย่างของ hello_ar_java ใน com/google/ar/core/examples/java/common/samplerender

ใช้การวางตำแหน่งทันที

API การจัดตำแหน่งทันทีช่วยให้ผู้ใช้วางวัตถุ AR ลงบนหน้าจอได้โดยไม่ต้องรอให้ ARCore ตรวจจับเรขาคณิตบนพื้นผิว ระบบจะปรับแต่งตำแหน่งออบเจ็กต์แบบเรียลไทม์เมื่อผู้ใช้เคลื่อนที่ออกไปรอบๆ สภาพแวดล้อม

แตะหน้าจอเพื่อวางวัตถุ อย่าลืมย้ายอุปกรณ์ต่อ หลังจากที่เห็นวัตถุโฮโลกราฟิก ปรากฏบนหน้าจอแล้ว เพื่อให้ ARCore สามารถ ได้รับข้อมูลที่เพียงพอเกี่ยวกับสิ่งต่างๆ รอบตัวคุณเพื่อกำหนดตำแหน่งสภาพแวดล้อมเสมือน ออบเจ็กต์

เมื่อ ARCore ตรวจพบรูปทรงเรขาคณิตบนพื้นผิวและสร้างวัตถุที่สามารถติดตามได้ใน บริเวณที่วางวัตถุ ตำแหน่งของวัตถุจะได้รับการอัปเดตโดยอัตโนมัติ เพื่อความถูกต้อง

ตำแหน่งโฆษณาทันใจ

ในรูปที่ 1 ปิดใช้งานตำแหน่งแบบทันใจ และไม่มีการกำหนดรูปเรขาคณิตบนพื้นผิว วัตถุที่วางอยู่บนพื้นทางด้านขวาของโต๊ะพูล (จุดสีน้ำเงินเล็กๆ 4 จุด) ปรากฏขึ้นมาจนลืมแสดงท่าทาง

ในรูปที่ 2 มีการเปิดใช้ตำแหน่งแบบทันใจจากเมนูใต้ไอคอนรูปเฟือง

ในรูปที่ 3 เมื่อเปิดใช้งานตำแหน่งแบบทันใจไว้ จะมีวัตถุใหม่วางอยู่ในฉาก ปรากฏเป็นโทนสีเทาแทนที่จะเป็นสี เพื่อแสดงให้เห็นว่าไม่ได้ เพื่อให้ได้ท่าทางที่ถูกต้อง

ในรูปที่ 4 วัตถุใหม่จะมีสี และท่าทางของวัตถุนั้นถูกต้องเมื่อ ตรวจพบเรขาคณิตบนพื้นผิว (อธิบายโดยเส้นตารางที่ติดตามได้)

ใช้ความลึก

เมื่อเปิดใช้ความลึก ARCore จะพิจารณารูปทรงเรขาคณิตและตำแหน่งของวัตถุในฉาก และคำนวณตำแหน่งของวัตถุ ที่วางไว้ในฉากซึ่งสัมพันธ์กับวัตถุอื่นๆ ในฉาก ซึ่งช่วยให้ วางวัตถุที่กีดขวางโดยวัตถุในฉาก และทำให้มีความสมจริง แอปของคุณ

ตำแหน่งโฆษณาทันใจ

ในรูปที่ 1 ปิดใช้งานความลึก ออบเจ็กต์วางอยู่ใต้ตารางพูล

ในรูปที่ 2 วัตถุจะปรากฏขึ้นขณะที่อุปกรณ์เคลื่อนที่ไปรอบๆ โต๊ะพูล เพื่อติดตามอุปกรณ์โดยไม่คำนึงถึงวัตถุในฉาก

ในรูปที่ 3 เปิดใช้งานความลึก

ในรูปที่ 4 ตอนนี้วัตถุถูกกั้นโดยตารางพูลเป็นอุปกรณ์ เคลื่อนที่ไปรอบๆ ฉาก

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