Cihazın mevcut konumunda VPS kullanılabilirliğini kontrol edin

Coğrafi API, yüksek doğrulukta coğrafi dönüşümler oluşturmak için VPS ve GPS verilerinin bir kombinasyonunu kullanır. API, cihazın konumunu belirleyebildiği her yerde kullanılabilir:

  • Kapalı alanlar ve yoğun kentsel ortamlar gibi GPS doğruluğunun düşük olduğu bölgelerde API, yüksek doğrulukta dönüştürme işlemleri oluşturmak için VPS kapsamına dayanır.
  • Başınızın üzerinde çok az engel bulunan veya hiç engel bulunmayan dış mekan ortamlarında Geospatial API, yüksek doğrulukta coğrafi dönüşümler oluşturmak için mevcut GPS konum verilerini kullanabilir.

AR oturumu başlamadan önce belirli bir yatay konumda VPS'nin kullanılabilirliğini belirleyebilir ve daha spesifik deneyimler oluşturmak için kullanabilirsiniz (ör. yalnızca VPS kullanılabilirken "AR'ye gir" düğmesi göstermek için).

ARCore API'yi etkinleştirme

Uygulamanız, VPS kullanılabilirliğini kontrol etmek için ARCore API'yi etkinleştirmelidir.

Uygulamanızda VPS'nin kullanılabilirliğini kontrol etme

Coğrafi API, cihazın konumunu belirleyebildiği her yerde kullanılabilir. AR deneyiminiz VPS kapsamına bağlıysa GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: kullanarak GARVPSAvailabilityFuture elde edebilirsiniz. Bu, belirli bir yatay konumdaki VPS kullanılabilirliğini kontrol eden, eşzamansız bir görevdir. GARVPSAvailabilityFuture'i aldıktan sonra, anket yaparak veya geri arama yoluyla sonucunu alabilirsiniz.

Anket sonucu

Future öğesinin durumunu almak için GARFuture.state kullanın. Üç farklı durum vardır:

  • GARFutureStatePending: İşlem henüz tamamlanmadığı için sonuç bilinmiyor.
  • GARFutureStateCancelled: İşlem GARFuture#cancel tarafından iptal edildi. Kayıtlı geri arama numaraları hiçbir zaman aranmaz.
  • GARFutureStateDone: İşlem tamamlandı. Sonucu almak için GARVPSAvailabilityFuture.result kullanın.

Görev tamamlanana kadar GARFuture.state simgesini kontrol etmeye devam edebilirsiniz.

Sonuçları geri arama yoluyla alma

Future sonucunu geri çağırma işlevi aracılığıyla da alabilirsiniz. GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: kullanın ve bir completionHandler sağlayın. Bu completionHandler, Future GARFutureStateDone durumuna geldikten kısa bir süre sonra ana mesaj dizisinde çağrılır.

Future

Future'ı iptal etmek için GARFuture#cancel simgesini kullanın. İptal denemeniz, iş parçacığı paralelliği nedeniyle aslında başarılı olmayabilir. GARFuture#cancel, bu deneme başarılıysa YES, aksi takdirde NO değerini döndürür.

Coğrafi API'yi VPS kapsama alanı olmadan kullanma

Coğrafi API, VPS kapsamı olmayan alanlarda da kullanılabilir. Başınızın üzerinde çok az engel bulunan veya hiç engel bulunmayan dış mekan ortamlarında, yüksek doğrulukta bir poz oluşturmak için GPS yeterli olabilir.

Sırada ne var?