คู่มือเริ่มใช้งานฉบับย่อสําหรับ 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 Emulator คุณต้องอัปเดตบริการ 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 พื้นฐาน เช่น Planes และ Anchors ตัวอย่างเฟรมเวิร์กการแสดงผลของ hello_ar_java จะอยู่ใน com/google/ar/core/examples/java/common/samplerender

เพื่อให้ตั้งค่า AR ที่ถูกต้องสำหรับแอปพลิเคชันของคุณเอง

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

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

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

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

ตำแหน่งทันใจ

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

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

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

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

ใช้ความลึก

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

ตำแหน่งทันใจ

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

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

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

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

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