Opis klasy AnchorLocateCriteria
W tym artykule poznasz różne opcje, których można użyć podczas wykonywania zapytań dotyczących kotwicy. Przejdziemy przez klasę AnchorLocateCriteria, jej opcje i prawidłowe kombinacje opcji.
Kryteria lokalizowania zakotwiczenia
Klasa AnchorLocateCriteria ułatwia wykonywanie zapytań o usługę dla wcześniej utworzonych kotwic. Jeden obiekt AnchorLocateCriteria może być używany w dowolnym momencie dla obserwatora. Każdy obiekt AnchorLocateCriteria musi zawierać dokładnie jedną z następujących właściwości: Identifiers, NearAnchor lub NearDevice. W razie potrzeby można ustawić dodatkowe właściwości, takie jak Strategia, BypassCache i RequestedCategories .
Właściwości
Zdefiniuj dokładnie jedną z następujących właściwości w obserwatorze:
Identifiers
Wartość domyślna: pusta tablica ciągów
Za pomocą identyfikatorów można zdefiniować listę identyfikatorów kotwic dla kotwic, które chcesz zlokalizować. Identyfikatory kotwicy są początkowo zwracane do Ciebie po pomyślnym utworzeniu kotwicy. Po określeniu identyfikatorów anchorLocateCriteria ogranicza zestaw żądanych kotwic do kotwic z pasującymi identyfikatorami kotwic. Ta właściwość jest określana przy użyciu tablicy ciągów.
NearAnchor
Wartość domyślna: nie ustawiono
Za pomocą funkcji NearAnchor można określić, że właściwość AnchorLocateCriteria ogranicza zestaw żądanych kotwic do kotwic w żądanej odległości od wybranej kotwicy. Musisz podać tę wybraną kotwicę jako kotwicę źródłową. Możesz również ustawić żądaną odległość od kotwicy źródłowej i maksymalną liczbę zwróconych kotwic, aby jeszcze bardziej ograniczyć wyszukiwanie. Ta właściwość jest określana przy użyciu obiektu NearAnchorCriteria.
NearDevice
Wartość domyślna: nie ustawiono
Za pomocą funkcji NearDevice można określić, że właściwość AnchorLocateCriteria ogranicza zestaw żądanych kotwic do tych znajdujących się w pobliżu lokalizacji fizycznej urządzenia. Wszystkie włączone czujniki będą używane do odnajdywania kotwic wokół urządzenia. Aby mieć największe szanse na znalezienie kotwic, należy skonfigurować elementy SensorCapabilities, aby zapewnić dostęp sesji do wszystkich odpowiednich czujników. Aby uzyskać więcej informacji na temat konfigurowania i używania tej właściwości, zobacz Coarse Relocalization — Azure Spatial Anchors | Microsoft Docs and How to create and locate anchors using coarse relocalization in C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT. Ta właściwość jest określana przy użyciu obiektu NearDeviceCriteria.
Dodatkowe właściwości
BypassCache
Wartość domyślna: false
Gdy kotwica została utworzona lub znaleziona w sesji, jest również przechowywana w pamięci podręcznej. Jeśli ta właściwość ma wartość false, każde kolejne zapytanie w tej samej sesji zwróci wartość buforowanej. Nie jest wykonywane żadne żądanie do usługi ASA.
RequestedCategories
Wartość domyślna: Właściwości | Przestrzennej
Ta właściwość służy do określania, jakie dane są zwracane z zapytania przy użyciu elementu AnchorLocateCriteria. Wartość domyślna zwraca zarówno właściwości, jak i dane przestrzenne. Nie należy jej zmieniać, jeśli właściwości i dane przestrzenne są żądane. Tę właściwość można określić przy użyciu wyliczenia AnchorDataCategory.
| AnchorDataCategory, wartość wyliczenia | Zwrócone dane |
|---|---|
| None | Żadne dane nie są zwracane |
| Właściwości | Zostaną zwrócone właściwości kotwicy, w tym właściwości appProperties. |
| Spatial | Zwracane są informacje przestrzenne o kotwicy. |
Strategia
Wartość domyślna: AnyStrategy
Strategia dodatkowo definiuje sposób, w jaki powinny znajdować się kotwice. Właściwość Strategy można określić przy użyciu wyliczenia LocateStrategy.
| LocateStrategy, wartość wyliczenia | opis |
|---|---|
| AnyStrategy | Ta strategia umożliwia systemowi używanie kombinacji strategii VisualInformation i Relacji w celu znajdowania kotwic. |
| VisualInformation | Ta strategia próbuje znaleźć kotwice, pasując do informacji wizualnych z bieżącego otoczenia do tych z wizualizacji kotwicy. Ślad wizualny kotwicy odnosi się do informacji wizualnych aktualnie skojarzonych z kotwicą. Te informacje wizualne są zwykle, ale nie są zbierane wyłącznie podczas tworzenia kotwicy. Obecnie ta strategia jest dozwolona tylko w połączeniu z właściwościami NearDevice lub Identifiers. |
| Relacja | Ta strategia próbuje znaleźć kotwice, korzystając z istniejących połączonych kotwic. Obecnie ta strategia jest dozwolona tylko w połączeniu z właściwościami NearAnchor lub Identifiers. W przypadku użycia z właściwością Identifiers wymagane jest, aby w tej samej sesji użytkownik wcześniej znajdował kotwice z już ustalonymi relacjami łączącymi z kotwicami, których identyfikatory są określone w tablicy Identifiers. |
Prawidłowe kombinacje właściwości LocateStrategy i AnchorLocateCriteria
Nie wszystkie kombinacje właściwości Strategy i AnchorLocateCriteria są obecnie dozwolone przez system. W poniższej tabeli przedstawiono dozwolone kombinacje:
| Właściwości | AnyStrategy | Relacja | VisualInformation |
|---|---|---|---|
| Identifiers | ✓ | ✓ | ✓ |
| NearAnchor | √ (wartość domyślna to Relacja) | ✓ | |
| NearDevice | ✓ | ✓ |
Następne kroki
Zobacz How to create and locate anchors using Azure Spatial Anchors (Jak tworzyć i lokalizować kotwice przy użyciu usługi Azure Spatial Anchors), aby uzyskać więcej przykładów przy użyciu klasy AnchorLocateCriteria.