ตรวจสอบความพร้อมใช้งานของ 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 คุณสามารถใช้ AREarthManager.CheckVpsAvailabilityAsync() เพื่อรับ VpsAvailabilityPromise ซึ่งเป็นงานแบบไม่พร้อมกันที่ตรวจสอบความพร้อมใช้งาน VPS ในตำแหน่งแนวนอนที่กำหนด เมื่อมี VpsAvailabilityPromise แล้ว คุณจะดูผลลัพธ์ได้ด้วยแบบสำรวจ

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

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

  • Pending: การดำเนินการยังไม่สมบูรณ์ จึงยังไม่ทราบผลลัพธ์
  • Cancelled: VpsAvailabilityPromise.Cancel() ยกเลิกการดำเนินการแล้ว ระบบจะไม่โทรติดต่อกลับตามที่คุณลงทะเบียนไว้
  • Done: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้ VpsAvailabilityPromise.Result เพื่อดูผลลัพธ์

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

ยกเลิก InterruptiblePromise

ใช้ VpsAvailabilityPromise.Cancel() เพื่อพยายามยกเลิก InterruptiblePromise เนื่องจากชุดข้อความมีเนื้อหาพร้อมกัน จึงอาจเป็นไปได้ที่ความพยายามในการยกเลิกของคุณไม่สำเร็จ

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

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

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