Geospatial API ใช้ทั้ง VPS และข้อมูล GPS เพื่อสร้างท่าทางภูมิสารสนเทศที่มีความแม่นยำสูง คุณสามารถใช้ API ในตำแหน่งใดก็ได้ที่อุปกรณ์สามารถระบุตำแหน่งได้ ดังนี้
- ในพื้นที่ที่ GPS มีความแม่นยำต่ำ เช่น พื้นที่ในอาคารและสภาพแวดล้อมในเมืองหนาแน่น API จะอาศัยการครอบคลุมของ VPS เพื่อสร้างท่าทางที่มีความแม่นยำสูง
- ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางเหนือศีรษะน้อยมากหรือไม่มีเลย Geospatial API อาจใช้ข้อมูลตำแหน่ง GPS ที่มีอยู่เพื่อสร้างตำแหน่งทางภูมิศาสตร์ที่มีความแม่นยำสูงได้
คุณกำหนดความพร้อมใช้งานของ VPS ในตําแหน่งแนวนอนที่ต้องการก่อนที่เซสชัน AR จะเริ่มขึ้นและนำมาใช้เพื่อสร้างประสบการณ์ที่เฉพาะเจาะจงมากขึ้นได้ เช่น เพื่อนําเสนอปุ่ม "Enter AR" เมื่อ VPS พร้อมใช้งานเท่านั้น
เปิดใช้ ARCore API
แอปต้องเปิดใช้ ARCore API เพื่อตรวจสอบความพร้อมใช้งานของ VPS
เมื่อเปิดใช้ ARCore API แล้ว คุณจะตรวจสอบความพร้อมใช้งานของ VPS ได้โดยไม่ต้องดำเนินการต่อไปนี้
- เวอร์ชันปัจจุบันที่ใช้งานอยู่
ArSession
(ก่อนเรียกใช้ArSession_resume()
) - การตั้งค่า
ArGeospatialMode
ตรวจสอบความพร้อมใช้งานของ VPS ในแอปของคุณ
Geospatial API สามารถใช้ในที่ใดก็ตามที่อุปกรณ์สามารถระบุตำแหน่งของอุปกรณ์ได้ หากประสบการณ์การใช้งาน AR ขึ้นอยู่กับความครอบคลุมของ VPS คุณสามารถใช้ ArSession_checkVpsAvailabilityAsync()
เพื่อรับ ArVpsAvailabilityFuture
ซึ่งเป็นงานแบบไม่พร้อมกันที่ตรวจสอบความพร้อมใช้งานของ VPS ในตำแหน่งแนวนอนที่ระบุ
เมื่อมี ArVpsAvailabilityFuture
แล้ว คุณจะขอรับผลลัพธ์ได้โดยการทำแบบสำรวจหรือการเรียกกลับ
สำรวจผลลัพธ์
ใช้ ArFuture_getState()
เพื่อรับสถานะของ ArFuture
รัฐจะมี 3 สถานะ ดังนี้
AR_FUTURE_STATE_PENDING
: การดำเนินการยังไม่เสร็จสมบูรณ์ จึงไม่ทราบผลลัพธ์AR_FUTURE_STATE_CANCELLED
:ArFuture_cancel()
ยกเลิกการดำเนินการแล้ว ระบบจะไม่เรียกการติดต่อกลับที่ลงทะเบียนไว้AR_FUTURE_STATE_DONE
: การดำเนินการเสร็จสมบูรณ์แล้ว ใช้ArVpsAvailabilityFuture_getResult()
เพื่อดูผลลัพธ์
คุณสามารถตรวจดู ArFuture_getState()
ต่อได้จนกว่างานจะเสร็จสมบูรณ์
// Obtain a ArVpsAvailabilityFuture and store it somewhere. ArVpsAvailabilityFuture* future = NULL; CHECK(ArSession_checkVpsAvailabilityAsync(ar_session, latitude, longitude, NULL, NULL, &future) == AR_SUCCESS); // Poll ArVpsAvailabilityFuture later, for example, in a render loop. ArFutureState future_state = AR_FUTURE_STATE_PENDING; ArFuture_getState(ar_session, (ArFuture*)future, &future_state); if (future_state == AR_FUTURE_STATE_DONE) { ArVpsAvailability vps_availability = AR_VPS_AVAILABILITY_UNKNOWN; ArVpsAvailabilityFuture_getResult(ar_session, future, &vps_availability); switch (vps_availability) { case AR_VPS_AVAILABILITY_AVAILABLE: // VPS is available at this location. break; case AR_VPS_AVAILABILITY_UNAVAILABLE: // VPS is unavailable at this location. break; case AR_VPS_AVAILABILITY_ERROR_NETWORK_CONNECTION: // The external service could not be reached due to a network connection // error. break; // Handle other error states, e.g. // AR_VPS_AVAILABILITY_ERROR_RESOURCE_EXHAUSTED, // AR_VPS_AVAILABILITY_ERROR_INTERNAL, ... } ArFuture_release((ArFuture*)future); }
รับผลลัพธ์ผ่านการเรียกกลับ
คุณยังขอผลลัพธ์ของ ArFuture
ผ่านการติดต่อกลับได้ด้วย ใช้ ArSession_checkVpsAvailabilityAsync()
และระบุ callback
ระบบจะเรียกใช้ callback
นี้ในเทรดหลักหลังจากที่ ArFuture
มีสถานะ AR_FUTURE_STATE_DONE
แล้ว
void vps_availability_callback(void* context, ArVpsAvailability availability) { // Callback is called on the Main thread. // Handle the ArVpsAvailability result as shown above. // For example, show UI that enables your AR view. // It is a best practice to free `context` memory at the end of the callback. free(context); } void check_availability_with_callback(ArSession* ar_session, double latitude, double longitude) { ArVpsAvailabilityFuture* future = NULL; void* context = NULL; CHECK(ArSession_checkVpsAvailabilityAsync( ar_session, latitude, longitude, context, vps_availability_callback, &future) == AR_SUCCESS); }
ยกเลิก ArFuture
ใช้ ArFuture_cancel()
เพื่อพยายามยกเลิก ArFuture
เนื่องจากชุดข้อความพร้อมกัน การดำเนินการยกเลิกจึงอาจไม่สำเร็จจริง
ArFuture_cancel()
จะส่งคืน 1
หากความพยายามนี้สำเร็จ และ 0
ในกรณีอื่นๆ
ใช้ Geospatial API โดยไม่มี VPS
นอกจากนี้ Geospatial API สามารถใช้ในพื้นที่ที่ไม่มี VPS ครอบคลุม ในสภาพแวดล้อมกลางแจ้งที่มีสิ่งกีดขวางเหนือศีรษะน้อยมากหรือไม่มีสิ่งกีดขวาง GPS อาจเพียงพอต่อการสร้างท่าทางที่มีความแม่นยำสูง
ขั้นตอนถัดไป
- ใช้ตำแหน่งทางภูมิศาสตร์ของกล้องในอุปกรณ์เพื่อระบุตำแหน่งที่แน่นอนของอุปกรณ์ของผู้ใช้ในโลกแห่งความเป็นจริง