Memahami kelas AnchorLocateCriteria
Dalam artikel ini, Anda akan mempelajari berbagai opsi yang dapat digunakan saat mengkueri jangkar. Kami akan pergi ke kelas AnchorLocateCriteria, opsinya, dan kombinasi opsi yang valid.
Kriteria lokasi jangkar
Kelas AnchorLocateCriteria membantu Anda mengkueri layanan untuk jangkar yang dibuat sebelumnya. Satu objek AnchorLocateCriteria dapat digunakan per pengamat kapan saja. Setiap objek AnchorLocateCriteria harus menyertakan satu properti berikut: Identifiers, NearAnchor, atau NearDevice. Properti tambahan seperti Strategy, BypassCache, dan RequestedCategories dapat diatur jika diinginkan.
Properti
Tentukan satu properti berikut ini di pengamat Anda:
Identifiers
Nilai Default: array string kosong
Dengan menggunakan Identifiers, Anda dapat menentukan daftar ID jangkar untuk jangkar yang ingin Anda temukan. ID jangkar awalnya ditampilkan kepada Anda setelah pembuatan jangkar yang berhasil. Dengan Identifiers ditentukan, AnchorLocateCriteria membatasi set jangkar yang diminta untuk jangkar dengan jangkar yang cocok. Properti ini ditentukan menggunakan array string.
NearAnchor
Nilai Default: tidak diatur
Dengan menggunakan NearAnchor, Anda dapat menentukan bahwa AnchorLocateCriteria membatasi set jangkar yang diminta untuk jangkar dalam jarak yang diinginkan dari jangkar yang dipilih. Anda harus menyediakan jangkar yang dipilih ini sebagai jangkar sumber. Anda juga dapat mengatur jarak yang diinginkan dari jangkar sumber, dan jumlah maksimum jangkar yang ditampilkan, untuk membatasi pencarian lebih lanjut. Properti ini ditentukan menggunakan objek NearAnchorCriteria.
NearDevice
Nilai Default: tidak diatur
Dengan menggunakan NearDevice, Anda dapat menentukan bahwa AnchorLocateCriteria membatasi set jangkar yang diminta ke jangkar yang dekat dengan lokasi fisik perangkat. Sensor yang diaktifkan akan digunakan untuk membantu menemukan jangkar di sekitar perangkat Anda. Untuk memiliki kesempatan terbaik untuk menemukan jangkar, Anda harus mengonfigurasi SensorCapabilities untuk memberikan akses sesi ke semua sensor yang sesuai. Untuk mengetahui informasi selengkapnya tentang menyiapkan dan menggunakan properti ini, lihat Relokasi Kasar - Azure Spatial Anchors | Microsoft Docs dan Cara membuat dan menemukan jangkar menggunakan relokasi kasar di C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT. Properti ini ditentukan menggunakan objek NearDeviceCriteria.
Properti tambahan
BypassCache
Nilai default: false
Setelah jangkar dibuat atau ditemukan dalam sesi, jangkar juga disimpan di cache. Dengan properti ini diatur ke false, setiap kueri berikutnya dalam sesi yang sama akan menampilkan nilai yang di-cache. Tidak ada permintaan ke layanan ASA yang dibuat.
RequestedCategories
Nilai Default: Properti | Spasial
Properti ini digunakan untuk menentukan data apa yang ditampilkan dari kueri menggunakan AnchorLocateCriteria. Nilai default menampilkan data properti dan spasial, ini tidak boleh diubah jika properti dan data spasial diinginkan. Properti ini dapat ditentukan menggunakan enum anchorDataCategory.
| Nilai Enum AnchorDataCategory | Data yang Ditampilkan |
|---|---|
| Tidak ada | Tidak ada data yang ditampilkan |
| Properti | Properti jangkar termasuk AppProperties ditampilkan. |
| Spasial | Informasi spasial tentang jangkar ditampilkan. |
Strategi
Nilai Default: AnyStrategy
Strategi lebih lanjut mendefinisikan cara jangkar harus ditempatkan. Properti Strategy dapat ditentukan menggunakan enum LocateStrategy.
| Nilai Enum LocateStrategy | Deskripsi |
|---|---|
| AnyStrategy | Strategi ini memungkinkan sistem menggunakan kombinasi strategi VisualInformation and Relationship untuk menemukan jangkar. |
| VisualInformation | Strategi ini mencoba menemukan jangkar dengan mencocokkan informasi visual dari lingkungan saat ini dengan jejak visual jangkar. Jejak visual jangkar mengacu pada informasi visual yang saat ini terkait dengan jangkar. Informasi visual ini biasanya tetapi tidak dikumpulkan secara eksklusif selama pembuatan jangkar. Saat ini, strategi ini hanya diizinkan bersama dengan properti NearDevice atau Identifiers. |
| Hubungan | Strategi ini mencoba menemukan jangkar dengan memanfaatkan jangkar yang terhubung yang ada. Saat ini, strategi ini hanya diizinkan bersama dengan properti NearAnchor atau Identifiers. Saat digunakan dengan properti Identifiers, diperlukan bahwa, dalam sesi yang sama, pengguna sebelumnya harus menempatkan jangkar dengan hubungan ikat yang sudah ditetapkan ke jangkar yang ID-nya ditentukan dalam array Identifiers. |
Kombinasi valid properti LocateStrategy dan AnchorLocateCriteria
Tidak semua kombinasi properti Strategy dan AnchorLocateCriteria saat ini diizinkan oleh sistem. Tabel berikut menunjukkan kombinasi yang diizinkan:
| Properti | AnyStrategy | Hubungan | VisualInformation |
|---|---|---|---|
| Identifiers | ✓ | ✓ | ✓ |
| NearAnchor | ✓ (akan default ke Hubungan) | ✓ | |
| NearDevice | ✓ | ✓ |
Langkah berikutnya
Lihat Cara membuat dan menemukan jangkar menggunakan Azure Spatial Anchors untuk beberapa contoh lainnya menggunakan kelas AnchorLocateCriteria.