การเริ่มต้นใช้งานส่วนขยาย ARCore สําหรับ AR AR

แพ็กเกจ ARCore Extensions สําหรับ AR Foundation ที่เป็นตัวเลือกเพิ่มเติมจะเพิ่มฟังก์ชันการทํางานในแพ็กเกจ AR Foundation ของ Unity ซึ่งช่วยให้คุณใช้ฟีเจอร์อย่างเช่น Cloud Anchor, ตัวกรองการกําหนดค่ากล้อง และการบันทึกและการเล่นในแอปได้

ข้อกำหนด

หากต้องการพัฒนาด้วย ARCore Extensions สําหรับ AR Foundation คุณจะต้องมีสิ่งต่อไปนี้

Android

ฮาร์ดแวร์

• อุปกรณ์ Android ที่ ARCore รองรับ
• สาย USB สําหรับเชื่อมต่ออุปกรณ์กับเครื่องพัฒนาซอฟต์แวร์

ซอฟต์แวร์

• Unity 2019.4.3f1 ขึ้นไปจาก Android Build Support
• AR Foundation 4.1.5 ขึ้นไป (ติดตั้งโดยอัตโนมัติด้วย ARCore Extensions สําหรับ AR Foundation SDK)
• ปลั๊กอิน ARCore XR 4.1.5 ขึ้นไป (ติดตั้งโดยอัตโนมัติด้วย ARCore Extensions สําหรับ AR Foundation SDK)

iOS

ฮาร์ดแวร์

• อุปกรณ์ที่รองรับ ARCore
• สาย USB สําหรับเชื่อมต่ออุปกรณ์กับเครื่องพัฒนาซอฟต์แวร์

ซอฟต์แวร์

• Unity 2019.4.3f1 ขึ้นไปจาก iOS Build Support
• AR Foundation 4.1.5 ขึ้นไป (ติดตั้งโดยอัตโนมัติด้วย ARCore Extensions สําหรับ AR Foundation SDK)
• ปลั๊กอิน ARKit XR 4.1.5 ขึ้นไป (ติดตั้งโดยอัตโนมัติด้วย ARCore Extensions สําหรับ AR Foundation SDK)
• Xcode 11.0 ขึ้นไป

ติดตั้งแพ็กเกจ ARCore Extensions

ทําตามขั้นตอนต่อไปนี้เพื่อติดตั้งส่วนขยาย ARCore สําหรับ AR Foundation

ทรัพยากร Dependency แบบเป็นชุด

1. ตรวจสอบว่าได้ติดตั้งและกําหนดค่า Foundation AR ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แล้ว
2. เปิดหรือสร้างโปรเจ็กต์ Unity ใหม่
3. เลือกแพลตฟอร์มบิลด์เป้าหมายที่ต้องการ
   1. จากเมนู File ให้เลือก Build Settings
   2. เลือก Android หรือ iOS โดยขึ้นอยู่กับแพลตฟอร์มเป้าหมายที่ต้องการ
   3. คลิก Switch Platform

4. นําเข้าแพ็กเกจ ARCore Extensions ล่าสุด:

   1. นำทางไปยัง Window > Package Manager

   2. คลิกปุ่ม แล้วเลือกตัวเลือก Add package from git URL... จากเมนูแบบเลื่อนลง
      

   3. วาง URL ต่อไปนี้ในช่องข้อความ

      https://github.com/google-ar/arcore-unity-extensions.git
      

   4. คลิก Add

ไม่มี EDM4U

โดยค่าเริ่มต้น ส่วนขยาย ARCore จะมาพร้อมกับทรัพยากร Dependency เพิ่มเติม เมื่อใช้ไลบรารีอื่นๆ (เช่น Firebase Analytics) ที่ต้องอาศัยเครื่องมือจัดการทรัพยากร Dependency ภายนอกสําหรับ Unity คนละเวอร์ชัน อาจมีลักษณะการทํางานที่ไม่ได้กําหนด ซึ่งทําให้ทรัพยากร Dependency หยุดทํางานอย่างถูกต้อง

ติดตั้งส่วนขยาย ARCore ที่ไม่มีทรัพยากร Dependency เพื่อไม่ให้เกิดความขัดแย้งในการกําหนดเวอร์ชันไลบรารี

1. ดาวน์โหลดส่วนขยาย ARCore ที่ไม่มี EDM4U และ com.google.external-dependency-manager
2. ทําตามวิธีการนําเข้าแพ็กเกจ UPM ด้วยไฟล์ .tgz โดยติดตั้งแพ็กเกจตามลําดับต่อไปนี้
   1. com.google.external-dependency-manager
   2. ส่วนขยาย ARCore (ไม่มี EDM4U)

เมื่อติดตั้ง ARCore Extensions Unity จะติดตั้งทรัพยากร Dependency ที่จําเป็นในเวอร์ชันต่อไปนี้โดยอัตโนมัติด้วย

• AR Foundation
• ARCore XR Plugin (ใช้เมื่อกําหนดเป้าหมายเป็น Android)
• ARKit XR Plugin (ใช้เมื่อกําหนดเป้าหมายเป็น iOS)

ทรัพยากร Dependency เหล่านี้อาจไม่แสดงในมุมมอง Package Manager > Package: In project อย่างไรก็ตาม แพ็กเกจจะแสดงในหน้าต่าง Project ในส่วน Packages

ตั้งค่าส่วนขยาย ARCore

1. ในบานหน้าต่าง Hierarchy ให้คลิกขวาที่และเพิ่มออบเจ็กต์เกมต่อไปนี้ (หากยังไม่ได้เพิ่ม)

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. ในแผง Hierarchy ให้เลือกแพ็กเกจ ARCore Extensions

3. ในช่อง Inspector ในแต่ละช่องต่อไปนี้ ให้คลิกปุ่มเป้าหมาย และเชื่อมต่อแต่ละช่องกับออบเจ็กต์เกมที่เกี่ยวข้องดังนี้

   • Session: ใช้AR Sessionของโหมด
   • Session Origin: ใช้AR Session Originของโหมด
   • Camera Manager: ใช้AR Cameraของโหมด

4. สร้างและเชื่อมต่อเนื้อหาต่อไปนี้สําหรับ Cloud Anchor และตัวกรองการกําหนดค่ากล้อง

   1. ใน Project > Assets คลิกขวา ให้เลือก Create > XR > ARCore Extensions Config

   2. ใน Project > Assets คลิกขวา ให้เลือก Create > XR > Camera Config Filter

   3. ในแผง Hierarchy ให้เลือกแพ็กเกจ ARCore Extensions

   4. ในช่อง ARCore Extensions Config ของแผง Inspector ให้คลิกปุ่มเป้าหมาย และเชื่อมต่อกับชิ้นงาน ARCoreExtensionsConfig

   5. ในช่อง Camera Config Filter ของแผง Inspector ให้คลิกปุ่มเป้าหมาย และเชื่อมต่อกับชิ้นงาน ARCoreExtensionsCameraConfigFilter

      ดูข้อมูลเพิ่มเติมได้ในคู่มือสําหรับนักพัฒนาซอฟต์แวร์ Cloud Anchor ของ Unity (AR Foundation) สําหรับ Android หรือ iOS และคําแนะนําในการกําหนดค่ากล้อง

เมื่อจับคู่ช่อง ARCore Extensions ข้างต้นทั้งหมดอย่างเหมาะสมแล้ว แผง ARCore Inspector จะมีลักษณะดังนี้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าพร็อพเพอร์ตี้ได้จากคู่มือของ Unity สําหรับการแก้ไขพร็อพเพอร์ตี้

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

มาพร้อมกับ ARCore Extensions สําหรับ AR Foundation เป็นตัวอย่างโปรเจ็กต์ที่คุณอาจใช้ในการเริ่มต้นสร้างโปรเจ็กต์ของคุณเอง

1. จากเมนู Window ให้เปิด Package Manager แล้วเลือกแพ็กเกจ ARCore Extensions

2. ในส่วน Samples ให้คลิก Import สําหรับโปรเจ็กต์ตัวอย่างตามที่อธิบายไว้ด้านล่าง

ตัวอย่างโปรเจ็กต์ที่นําเข้าจากที่เก็บ GitHub มีดังนี้

• ภูมิศาสตร์ (Android เท่านั้น) - สร้างประสบการณ์ AR ในระดับโลก และแนบเนื้อหากับพื้นที่ซึ่งครอบคลุมโดย Google Street View จากระยะไกล ดูข้อมูลเพิ่มเติมที่ข้อมูลเบื้องต้นเกี่ยวกับ Geospatial API

• PersistentCloudAnchors (Android และ iOS) - สร้างประสบการณ์ AR ถาวรในโลกจริงด้วยเลเยอร์ข้อมูลดิจิทัลแบบอินเทอร์แอกทีฟซึ่งปักหมุดในตําแหน่งจริงและออกแบบประสบการณ์ที่ผู้ใช้หลายคนแชร์ในอุปกรณ์ต่างๆ เมื่อเวลาผ่านไป โปรดดูข้อมูลเพิ่มเติมในข้อมูลเบื้องต้นเกี่ยวกับ Anchor ของ Cloud

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

ปัจจุบัน ARCore Extensions สําหรับ AR Foundation ช่วยให้คุณใช้ Cloud Anchor และการกําหนดค่ากล้องในแอปได้แล้ว

• คู่มือนักพัฒนาซอฟต์แวร์ Cloud Anchor สําหรับ Android
• คู่มือนักพัฒนาซอฟต์แวร์ Cloud Anchor สําหรับ iOS
• คําแนะนําเกี่ยวกับการกําหนดค่ากล้อง