AnchorLocateCriteria sınıfını anlama
Bu makalede, bir tutturucuyu sorgularken kullanabileceğiniz farklı seçenekleri öğreneceksiniz. AnchorLocateCriteria sınıfının, seçeneklerinin ve geçerli seçenek bileşimlerinin üzerinden geçeceğiz.
Tutturucu bulma ölçütleri
AnchorLocateCriteria sınıfı, önceden oluşturulmuş yer işaretleri için hizmeti sorgulamanıza yardımcı olur. İzleyici başına her zaman bir AnchorLocateCriteria nesnesi kullanılabilir. Her AnchorLocateCriteria nesnesi şu özelliklerden tam olarak birini içermelidir: Identifiers, NearAnchor veya NearDevice. İsterseniz Strategy, BypassCache ve RequestedCategories gibi ek özellikler ayarlanabilir.
Özellikler
İzleyicinizde aşağıdaki özelliklerden birini tam olarak tanımlayın:
Identifiers
Varsayılan Değer: boş dize dizisi
Tanımlayıcılar'ı kullanarak, bulmak istediğiniz yer işaretleri için yer işareti kimliklerinin listesini tanımlayabilirsiniz. Bağlantı kimlikleri, başarılı bağlantı oluşturma işleminden sonra başlangıçta size döndürülür. Tanımlayıcılar belirtildiğinde AnchorLocateCriteria, istenen tutturucu kümesini eşleşen yer işareti kimliklerine sahip tutturucularla kısıtlar. Bu özellik bir dize dizisi kullanılarak belirtilir.
NearAnchor
Varsayılan Değer: ayarlanmadı
NearAnchor'u kullanarak AnchorLocateCriteria'nın istenen yer işareti kümesini seçilen bir yer işaretinden uzak bir mesafedeki tutturucularla kısıtlayacağını belirtebilirsiniz. Bu seçilen tutturucuyu kaynak bağlantı noktası olarak sağlamanız gerekir. Ayrıca, aramayı daha fazla sınırlamak için kaynak bağlantıdan uzak istenen uzaklığı ve döndürülen en fazla yer işareti sayısını ayarlayabilirsiniz. Bu özellik bir NearAnchorCriteria nesnesi kullanılarak belirtilir.
NearDevice
Varsayılan Değer: ayarlanmadı
NearDevice kullanarak AnchorLocateCriteria'nın istenen yer işareti kümesini cihazın fiziksel konumuna yakın olanlarla kısıtlayacağını belirtebilirsiniz. Etkin algılayıcılar, cihazınızın etrafındaki yer işaretleri bulmanıza yardımcı olmak için kullanılır. Yer işareti bulma konusunda en iyi şansı elde etmek için SensorCapabilities'i tüm uygun algılayıcılara oturum erişimi verecek şekilde yapılandırmanız gerekir. Bu özelliği ayarlama ve kullanma hakkında daha fazla bilgi için bkz. Coarse Relocalization - Azure Spatial Anchors | Microsoft Docs ve C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT'de kaba yeniden konumlandırma kullanarak yer işaretleri oluşturma ve bulma. Bu özellik bir NearDeviceCriteria nesnesi kullanılarak belirtilir.
Ek özellikler
BypassCache
Varsayılan Değer: false
Bir bağlantı oluşturulduğunda veya bir oturumda bulunduğunda, önbellekte de depolanır. Bu özellik false olarak ayarlandığında, aynı oturumdaki sonraki tüm sorgular önbelleğe alınmış değeri döndürür. ASA hizmetine istek yapılmaz.
İstenen Kategoriler
Varsayılan Değer: Özellikler | Kayma
Bu özellik AnchorLocateCriteria kullanılarak bir sorgudan hangi verilerin döndürüleceğini belirlemek için kullanılır. Varsayılan değer hem özellikleri hem de uzamsal verileri döndürür; hem özellikler hem de uzamsal veriler isteniyorsa bu değiştirilmemelidir. Bu özellik AnchorDataCategory sabit listesi kullanılarak belirtilebilir.
| AnchorDataCategory Sabit Listesi Değeri | Döndürülen Veri |
|---|---|
| None | Veri döndürülmedi |
| Özellikler | AppProperties de dahil olmak üzere bağlantı özellikleri döndürülür. |
| Uzamsal | Yer işaretiyle ilgili uzamsal bilgiler döndürülür. |
Strateji
Varsayılan Değer: AnyStrategy
Strateji, tutturucuların nasıl konumlandırılması gerektiğini de tanımlar. Strategy özelliği bir LocateStrategy sabit listesi kullanılarak belirtilebilir.
| LocateStrategy Sabit Listesi Değeri | Tanım |
|---|---|
| AnyStrategy | Bu strateji, sistemin yer işaretleri bulmak için VisualInformation ve İlişki stratejilerinin birleşimlerini kullanmasına izin verir. |
| VisualInformation | Bu strateji, geçerli çevreden gelen görsel bilgileri tutturucunun görsel ayak iziyle eşleştirerek yer işaretleri bulmayı dener. Bir tutturucunun görsel ayak izi, yer işaretiyle ilişkilendirilmiş olan görsel bilgileri ifade eder. Bu görsel bilgiler genellikle yer işareti oluşturma sırasında özel olarak toplanmaz. Şu anda bu stratejiye yalnızca NearDevice veya Identifiers özellikleriyle birlikte izin verilir. |
| İlişki | Bu strateji, mevcut bağlı bağlantı noktalarını kullanarak tutturucuları bulmaya çalışır. Şu anda bu stratejiye yalnızca NearAnchor veya Identifiers özellikleriyle birlikte izin verilir. Tanımlayıcılar özelliğiyle kullanıldığında, aynı oturumda kullanıcının daha önce Tanımlayıcılar dizisinde kimlikleri belirtilen tutturucularla önceden kurulmuş bağlantı ilişkileri olan bir yer işareti(ler) bulunması gerekir. |
LocateStrategy ve AnchorLocateCriteria özelliklerinin geçerli birleşimleri
Strateji ve AnchorLocateCriteria özelliklerinin tüm birleşimlerine şu anda sistem tarafından izin verilmiyor. Aşağıdaki tabloda izin verilen birleşimler gösterilmektedir:
| Özellik | AnyStrategy | İlişki | VisualInformation |
|---|---|---|---|
| Identifiers | ✓ | ✓ | ✓ |
| NearAnchor | ✓ (varsayılan olarak İlişki olarak ayarlanır) | ✓ | |
| NearDevice | ✓ | ✓ |
Sonraki adımlar
AnchorLocateCriteria sınıfını kullanarak daha fazla örnek için bkz . Azure Spatial Anchors kullanarak yer işaretleri oluşturma ve bulma.