Konfigurasi setelan aplikasi agar dapat menggunakan Geospatial API.
Prasyarat
Pastikan Anda memahami konsep dasar AR dan cara mengonfigurasi sesi ARCore sebelum melanjutkan.
Jika Anda ingin menjalankan aplikasi contoh yang mendemonstrasikan fungsi yang dijelaskan di sini, lihat Panduan memulai ARCore Geospatial untuk iOS.
Lihat Pengantar Geospatial API untuk informasi selengkapnya informasi tentang Geospatial API.
Jika Anda baru pertama kali melakukan pengembangan dengan ARCore, lihat Memulai untuk informasi tentang persyaratan perangkat lunak dan perangkat keras, prasyarat dan informasi lain khusus untuk platform yang Anda gunakan.
Mengaktifkan ARCore API
Sebelum menggunakan Sistem Pemosisi Visual (VPS) di aplikasi, Anda harus terlebih dahulu mengaktifkan ARCore API di project Google Cloud baru atau yang sudah ada. Layanan ini bertanggung jawab untuk menghosting, menyimpan, dan me-resolve anchor Geospasial.
Otorisasi tanpa kunci lebih disukai, tetapi otorisasi Kunci API juga didukung.
Menambahkan library yang diperlukan ke aplikasi Anda
Setelah memberikan otorisasi pada aplikasi untuk memanggil ARCore API, Anda harus menambahkan library ke mengaktifkan fitur Geospasial di aplikasi Anda.
UpdatePodfile
untuk aplikasi Anda agar menyertakan ARCore SDK dan iOS yang didukung
pembuatan versi. Untuk melakukannya:
Tambahkan
platform
danpod
berikut kePodfile
project:platform :ios, '11.0' pod 'ARCore/Geospatial', '~> 1.45.0'
Anda juga dapat menentukan
platform :ios, '10.0'
jika ingin mendukung iOS 10, tetapi perlu diperhatikan bahwa Geospatial API hanya akan berfungsi saat runtime di iOS >= 11.Buka jendela Terminal dan jalankan
pod install
dari folder tempat ada project Xcode Anda.Tindakan ini akan menghasilkan file
.xcworkspace
yang Anda gunakan untuk membangun dan menjalankan aplikasi.
Pastikan lingkungan pengembangan Anda memenuhi persyaratan ARCore SDK, karena yang dijelaskan dalam Panduan Memulai.
Mengaktifkan kemampuan Geospasial dalam konfigurasi sesi
Periksa kompatibilitas perangkat
Tidak semua perangkat yang mendukung ARCore juga mendukung Geospatial API, karena yang dijelaskan dalam panduan memulai.
Gunakan
GARSession.isGeospatialModeSupported:
untuk memeriksa perangkat, seperti berikut:
if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
[self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
return;
}
GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
[self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
(int)error.code]];
return;
}
Meminta izin akses lokasi kepada pengguna saat runtime
Aplikasi Anda harus meminta izin akses lokasi berikut saat runtime, sebelum mengonfigurasi sesi:
kCLAuthorizationStatusAuthorizedWhenInUse
CLAccuracyAuthorizationFullAccuracy
(Berlaku saat iOS >= 14)
Memeriksa ketersediaan Geospasial di lokasi perangkat saat ini
Karena Geospatial API menggunakan kombinasi VPS dan GPS untuk menentukan transformasi Geospasial, API ini dapat digunakan selama perangkat dapat menentukan lokasinya. Di area dengan akurasi GPS rendah, seperti dalam ruangan dan lingkungan perkotaan yang padat, API ini akan mengandalkan cakupan VPS untuk menghasilkan transformasi dengan akurasi tinggi. Dalam kondisi umum, VPS dapat diharapkan memberikan akurasi posisi sekitar 5 meter, dan akurasi rotasi 5 derajat. Gunakan GARSession.checkVPSAvailabilityAtCoordinate:completionHandler:
untuk menentukan apakah lokasi tertentu memiliki cakupan VPS.
Geospatial API juga dapat digunakan di area yang tidak memiliki cakupan VPS. Di lingkungan luar ruangan dengan sedikit atau tanpa penghalang di atas, GPS mungkin cukup untuk membuat transformasi dengan akurasi tinggi.
Langkah berikutnya
- Dapatkan transformasi Geospasial kamera perangkat untuk menentukan lokasi persis perangkat pengguna di dunia nyata.
- Memeriksa ketersediaan VPS di lokasi tertentu pada perangkat.