การเริ่มต้นใช้งาน Cloud Anchor อย่างรวดเร็วใน iOS

ARCore Cloud Anchor API หรือบริการ ARCore Cloud Anchor เป็นความสามารถในการใช้ Anchor บนระบบคลาวด์สำหรับแอป iOS ซึ่งทำให้ ผู้ใช้ทั้งอุปกรณ์ iOS และ Android สามารถแชร์ประสบการณ์ AR ร่วมกัน

คู่มือนี้แสดงวิธีการต่อไปนี้

  • ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ให้ทำงานกับ Cloud Anchor
  • ลองโฮสต์และแก้ไข Anchor ในแอปตัวอย่าง

ข้อกำหนดเบื้องต้น

  • Xcode เวอร์ชัน 13.0 ขึ้นไป
  • CocoaPods 1.4.0 ขึ้นไปหากใช้ CocoaPods
  • อุปกรณ์ Apple ที่เข้ากันได้กับ ARKit ที่ใช้ iOS 12.0 ขึ้นไป (ต้องมีเป้าหมายการทำให้ iOS 12.0 ขึ้นไปใช้งานได้)

การใช้ Cloud Anchor

ขั้นตอนต่อไปนี้ใช้แอป Cloud Anchor ตัวอย่างเพื่อแสดงเหตุการณ์สำคัญ งานสำหรับการกำหนดค่าและสร้างแอปที่รองรับ ARCore Cloud Anchor

ดาวน์โหลดแอป Cloud Anchor ตัวอย่าง

  1. โคลนหรือดาวน์โหลด ARCore SDK สำหรับ iOS จาก GitHub เพื่อรับโค้ดของแอปตัวอย่าง

  2. เปิดหน้าต่าง Terminal หรือ Finder และไปยังโฟลเดอร์ที่คุณโคลน หรือดาวน์โหลด SDK นี้แล้ว

  3. ค้นหาโค้ดของแอปตัวอย่างได้ใน
    /arcore-ios-sdk-master/Examples/CloudAnchorExample

    โค้ดตัวอย่างของแอป Cloud Anchor แบบถาวรคือ ใน
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample

การตั้งค่าเซสชัน

แอปตัวอย่างนี้จะทำงานที่สำคัญต่อไปนี้โดยเป็นส่วนหนึ่งของการตั้งค่า เซสชัน:

ตั้งค่าการแชร์รหัส Cloud Anchor

แอปตัวอย่าง Cloud Anchor ใช้ Firebase เพื่อแชร์รหัส Cloud Anchor ระหว่าง อุปกรณ์ คุณใช้โซลูชันอื่นในแอปของตัวเองได้

วิธีตั้งค่าฐานข้อมูล Firebase ในแอปตัวอย่าง

  1. ทำตามวิธีการของ Firebase สำหรับการเพิ่ม Firebase ลงในแอป
  2. ดาวน์โหลดไฟล์ GoogleService-Info.plist ที่สร้างขึ้นจากการเพิ่ม Firebase ไปยังแอปของคุณ
  3. เปิดใช้พื้นที่เก็บข้อมูลของ Firebase สำหรับตัวอย่าง
    • ไปที่คอนโซล Firebase แล้วเลือกโปรเจ็กต์ที่คุณตั้งค่าไว้ แอปตัวอย่าง
    • เลือกแผง Database
    • ในตัวเลือก Realtime Database ให้คลิก Get Started
    • เมนู Security rules for Realtime Database จะเปิดขึ้น
      • เลือก Start in test mode เพื่อวัตถุประสงค์ในการเรียกใช้ตัวอย่าง
      • โปรดทราบว่าหากคุณกำลังใช้ Firebase สำหรับแอปที่คุณวางแผนจะเผยแพร่ คุณควรใช้กฎความปลอดภัยที่เข้มงวดยิ่งขึ้น
  4. ใน Xcode ให้เพิ่มไฟล์ GoogleService-Info.plist ลงในแอป ถัดจาก Info.plist

ตั้งค่า ARCore API

หากต้องการใช้ Cloud Anchor ก่อนอื่นคุณต้องตั้งค่าส่วน ARCore API สำหรับแอปพลิเคชันของคุณ

เรียกใช้การอัปเดตพ็อด

แอป CloudAnchorExample จัดส่งโดย Podfile ที่กำหนดค่าไว้ล่วงหน้าด้วย ARCore SDK และเวอร์ชัน iOS ที่คุณจะต้องใช้ วิธีติดตั้งทรัพยากร Dependency เหล่านี้

  1. เปิดหน้าต่างเทอร์มินัล แล้วเรียกใช้ pod update จากโฟลเดอร์ที่ มีโปรเจ็กต์ Xcode อยู่
    การดำเนินการนี้จะสร้างไฟล์ .xcworkspace ซึ่งคุณจะใช้ในภายหลังเพื่อสร้างและ เรียกใช้แอป

ดูเพิ่ม ARCore SDK ลงในแอป เพื่อดูรายละเอียดเกี่ยวกับการกำหนดค่า Podfile ในแอปของคุณ

  1. เปิดไฟล์ .xcworkspace สำหรับโปรเจ็กต์ใน Xcode

    เพื่อหลีกเลี่ยงข้อผิดพลาดในการสร้าง โปรดตรวจสอบว่าคุณกําลังสร้างจาก .xcworkspace ไม่ใช่ไฟล์ .xcodeproj

เปลี่ยนรหัส App Bundle

ใน Xcode ให้เปลี่ยนรหัสชุดของแอปเพื่อรับรองแอปกับทีมของคุณ

สร้างและเรียกใช้แอป

  1. เชื่อมต่ออุปกรณ์และเปิดแอปใน Xcode

  2. (ไม่บังคับ) หากคุณกำลังสร้างและเรียกใช้แอปตัวอย่าง ให้ดูข้อมูลต่อไปนี้ สำหรับรายละเอียดเกี่ยวกับการใช้แอปเพื่อโฮสต์และแก้ปัญหา Cloud Anchor

ลองใช้แอปตัวอย่าง

  1. สร้างและเรียกใช้แอปตัวอย่างจากไฟล์ .xcworkspace เพื่อเปิด บนอุปกรณ์ของคุณ

  2. ให้สิทธิ์กล้องแก่แอปหากได้รับข้อความแจ้ง จากนั้น ARKit เริ่มตรวจจับเครื่องบินที่อยู่หน้ากล้อง

  3. แตะ HOST เพื่อเข้าสู่โหมดโฮสติ้ง รหัสห้องสำหรับการแชร์ Anchor ที่โฮสต์ไว้ และปรากฏบนหน้าจอของคุณ

  4. แตะเครื่องบินเพื่อเริ่มโฮสต์ Cloud Anchor ที่นั่น

    • แอปวางวัตถุ Android ของแอนดี้บนเครื่องบินและติดสมอเรือ กับโมเดลนั้น
    • ระบบจะส่งคำขอโฮสต์ไปยังปลายทางระบบคลาวด์ ARCore API ผู้จัด คำขอมีข้อมูลที่แสดงตำแหน่งของ Anchor ที่สัมพันธ์กับ ฟีเจอร์ภาพที่อยู่ใกล้เคียง
    • เมื่อโฮสต์ Anchor แล้ว Anchor จะได้รับรหัสที่ใช้สำหรับแก้ปัญหาระบบคลาวด์ โฆษณา Anchor ในพื้นที่นี้

  5. แตะ RESOLVE แล้วป้อนรหัสห้องเพื่อเข้าถึงก่อนหน้านี้ โฮสต์ Cloud Anchor สำหรับห้องนี้ โดยใช้อุปกรณ์เดียวกันหรือเครื่องอื่น

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

เพิ่ม ARCore SDK ลงในแอป

ในแอปของคุณเอง คุณจะต้องอัปเดต Podfile ให้รวม ARCore SDK และการกำหนดเวอร์ชัน iOS ที่รองรับ หากต้องการทำสิ่งต่อไปนี้

  1. เพิ่ม platform และ pod ต่อไปนี้ลงใน Podfile ของโครงการ:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
  1. เปิดหน้าต่างเทอร์มินัล แล้วเรียกใช้ pod update จากโฟลเดอร์ที่ มีโปรเจ็กต์ Xcode อยู่แล้ว
    การดำเนินการนี้จะสร้างไฟล์ .xcworkspace ซึ่งคุณใช้เพื่อสร้างและ เรียกใช้แอป

Cloud Anchor แบบถาวร

ตามที่อธิบายไว้ในหัวข้อโฮสต์ Cloud Anchor ด้วยความต่อเนื่อง คุณสามารถให้ Cloud Anchor แสดงอายุการใช้งานสูงสุด 365 วัน โค้ดตัวอย่างสำหรับ ที่ใช้ตัวยึดระบบคลาวด์แบบถาวรมีให้ใช้งานใน /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample ใน ARCore SDK สำหรับ iOS จาก GitHub

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