ตรวจสอบความพร้อมใช้งานของ VPS ที่ตำแหน่งปัจจุบันของอุปกรณ์

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

  • ในพื้นที่ที่ GPS มีความแม่นยำต่ำ เช่น พื้นที่ในอาคารและสภาพแวดล้อมในเมืองที่มีความหนาแน่นสูง API จะใช้การครอบคลุม VPS เพื่อสร้างการแปลงที่มีความแม่นยำสูง
  • ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนน้อยหรือไม่มีเลย Geospatial API อาจใช้ข้อมูลตำแหน่ง GPS ที่มีอยู่เพื่อสร้างการแปลงภูมิสารสนเทศด้วยความแม่นยำสูง

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

เปิดใช้ ARCore API

แอปของคุณต้องเปิดใช้ ARCore API เพื่อตรวจสอบความพร้อมใช้งาน VPS

ตรวจสอบความพร้อมใช้งาน VPS ในแอป

Geospatial API สามารถใช้ได้ทุกที่ที่อุปกรณ์สามารถระบุตำแหน่งได้ หากประสบการณ์ AR ขึ้นอยู่กับการครอบคลุม VPS คุณสามารถใช้ GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: เพื่อรับ GARVPSAvailabilityFuture ซึ่งเป็นงานแบบไม่พร้อมกันที่ตรวจสอบความพร้อมใช้งาน VPS ในตำแหน่งแนวนอนที่กำหนด เมื่อมี GARVPSAvailabilityFuture แล้ว คุณจะดูผลลัพธ์ได้ด้วยแบบสำรวจหรือผ่านทาง Callback

สำรวจผลลัพธ์

ใช้ GARFuture.state เพื่อดูสถานะของ Future โดยจะมีสถานะต่างๆ 3 สถานะ ดังนี้

  • GARFutureStatePending: การดำเนินการยังไม่สมบูรณ์ จึงยังไม่ทราบผลลัพธ์
  • GARFutureStateCancelled: GARFuture#cancel ยกเลิกการดำเนินการแล้ว ระบบจะไม่โทรติดต่อกลับตามที่คุณลงทะเบียนไว้
  • GARFutureStateDone: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้ GARVPSAvailabilityFuture.result เพื่อดูผลลัพธ์

คุณอาจตรวจสอบ GARFuture.state ต่อไปจนกว่างานจะเสร็จสมบูรณ์

รับผลลัพธ์ผ่าน Callback

นอกจากนี้ คุณยังรับผลลัพธ์ของ Future ผ่านการติดต่อกลับได้ด้วย ใช้ GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: และระบุ completionHandler ระบบจะเรียกใช้ completionHandler นี้ในเทรดหลักทันทีหลังจาก Future มีสถานะ GARFutureStateDone

ยกเลิก Future

ใช้ GARFuture#cancel เพื่อพยายามยกเลิก Future เนื่องจากชุดข้อความมีเนื้อหาพร้อมกัน จึงอาจเป็นไปได้ที่ความพยายามในการยกเลิกของคุณไม่สำเร็จ GARFuture#cancel จะแสดงผล YES หากความพยายามนี้สำเร็จ และ NO ในกรณีอื่นๆ

ใช้ Geospatial API ที่ไม่ครอบคลุม VPS

นอกจากนี้ Geospatial API ยังใช้ในพื้นที่ที่ไม่ครอบคลุม VPS ได้อีกด้วย ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางจากด้านบนเล็กน้อยหรือไม่มีเลย GPS อาจเพียงพอที่จะสร้างท่าทางที่มีความแม่นยำสูง

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