ตรวจสอบความพร้อมใช้งานของ 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 อาจเพียงพอต่อการสร้างท่าทางที่มีความแม่นยำสูง

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