Geospatial API از ترکیبی از داده های VPS و GPS برای ایجاد موقعیت های جغرافیایی با دقت بالا استفاده می کند. API را می توان در هر مکانی که دستگاه قادر به تعیین مکان خود باشد استفاده کرد:
- در مناطقی با دقت GPS پایین، مانند فضاهای داخلی و محیط های شهری متراکم، API برای ایجاد ژست های با دقت بالا به پوشش VPS متکی است.
- در محیطهای بیرونی با تعداد کم یا بدون انسداد بالای سر، Geospatial API ممکن است بتواند از دادههای موقعیت مکانی GPS موجود برای ایجاد موقعیتهای جغرافیایی با دقت بالا استفاده کند.
میتوانید قبل از شروع جلسه AR، در دسترس بودن VPS را در یک موقعیت افقی مشخص تعیین کنید و از آن برای ایجاد تجربیات خاصتر استفاده کنید - به عنوان مثال، برای ارائه دکمه "Enter AR" فقط زمانی که VPS در دسترس است.
ARCore API را فعال کنید
برنامه شما باید ARCore API را فعال کند تا در دسترس بودن VPS را بررسی کند.
در دسترس بودن VPS را در برنامه خود بررسی کنید
Geospatial API را می توان در هر مکانی که دستگاه قادر به تعیین مکان خود باشد استفاده کرد. اگر تجربه AR شما وابسته به پوشش VPS است، می توانید از AREarthManager.CheckVpsAvailabilityAsync()
برای به دست آوردن VpsAvailabilityPromise
استفاده کنید، یک کار ناهمزمان که در دسترس بودن VPS را در یک موقعیت افقی مشخص بررسی می کند. هنگامی که VpsAvailabilityPromise
را دارید، می توانید نتیجه آن را با نظرسنجی به دست آورید.
نتیجه را نظرسنجی کنید
از VpsAvailabilityPromise.State
برای به دست آوردن وضعیت InterruptiblePromise
استفاده کنید. سه حالت مختلف وجود دارد:
-
Pending
: عملیات هنوز کامل نشده است، بنابراین هیچ نتیجه ای مشخص نیست. -
Cancelled
: عملیات توسطVpsAvailabilityPromise.Cancel()
لغو شده است. با هر پاسخ تماسی ثبت شده هرگز تماس گرفته نخواهد شد. -
Done
: عملیات کامل شده است. برای به دست آوردن نتیجه ازVpsAvailabilityPromise.Result
استفاده کنید.
میتوانید VpsAvailabilityPromise.State
را بررسی کنید تا کار کامل شود.
لغو InterruptiblePromise
از VpsAvailabilityPromise.Cancel()
برای تلاش برای لغو InterruptiblePromise
استفاده کنید. به دلیل موازی بودن رشته، ممکن است تلاش برای لغو شما واقعاً موفق نباشد.
از API Geospatial بدون پوشش VPS استفاده کنید
Geospatial API همچنین در مناطقی که پوشش VPS ندارند قابل استفاده است. در محیطهای بیرونی که موانع بالای سرشان کم است یا اصلاً وجود ندارد، GPS ممکن است برای ایجاد یک حالت با دقت بالا کافی باشد.