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

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

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

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

เปิดใช้ ARCore API

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

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

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

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

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

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

  • PENDING: การดำเนินการยังไม่สมบูรณ์ จึงยังไม่ทราบผลลัพธ์
  • CANCELLED: Future.cancel() ยกเลิกการดำเนินการแล้ว ระบบจะไม่โทรติดต่อกลับตามที่คุณลงทะเบียนไว้
  • DONE: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้ VpsAvailabilityFuture.getResult() เพื่อดูผลลัพธ์

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

Java

// Obtain a VpsAvailabilityFuture and store it somewhere.
VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null);

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.getState() == FutureState.DONE) {
  switch (future.getResult()) {
    case AVAILABLE:
      // VPS is available at this location.
      break;
    case UNAVAILABLE:
      // VPS is unavailable at this location.
      break;
    case ERROR_NETWORK_CONNECTION:
      // The external service could not be reached due to a network connection error.
      break;

      // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...
  }
}

Kotlin

// Obtain a VpsAvailabilityFuture and store it somewhere.
val future = session.checkVpsAvailabilityAsync(latitude, longitude, null)

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.state == FutureState.DONE) {
  when (future.result) {
    VpsAvailability.AVAILABLE -> {
      // VPS is available at this location.
    }
    VpsAvailability.UNAVAILABLE -> {
      // VPS is unavailable at this location.
    }
    VpsAvailability.ERROR_NETWORK_CONNECTION -> {
      // The external service could not be reached due to a network connection error.
    }
    else -> {
      TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...")
    }
  }
}

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

นอกจากนี้ คุณยังรับผลลัพธ์ของ Future ผ่านการติดต่อกลับได้ด้วย ใช้ Session.checkVpsAvailabilityAsync() และระบุ callback ระบบจะเรียกใช้ callback นี้ในเทรดหลักทันทีหลังจาก Future มีสถานะ DONE

Java

session.checkVpsAvailabilityAsync(
    latitude,
    longitude,
    result -> {
      // Callback is called on the Main thread.
      switch (result) {
          // Handle the VpsAvailability result as shown above.
          // For example, show UI that enables your AR view.
      }
    });

Kotlin

session.checkVpsAvailabilityAsync(latitude, longitude) { result ->
  // Callback is called on the Main thread.

  // Handle the VpsAvailability result as shown above.
  // For example, show UI that enables your AR view.
  TODO("Handle VpsAvailability " + result)
}

ยกเลิก Future

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

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

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

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