Zrozumienie klasy AnchorLocateCriteriaUnderstanding the AnchorLocateCriteria class

W tym artykule opisano różne opcje, których można użyć podczas wykonywania zapytania o kotwicę.In this article you will learn the different options you can use when querying an anchor. Przejdziemy do klasy AnchorLocateCriteria, jej opcji i prawidłowych kombinacji opcji.We will go over the AnchorLocateCriteria class, its options and valid option combinations.

Kryteria lokalizowania kotwicyAnchor locate criteria

Klasa AnchorLocateCriteria ułatwia wykonywanie zapytań do usługi dla wcześniej utworzonych kotwic.The AnchorLocateCriteria class helps you query the service for previously created anchors. Jeden obiekt AnchorLocateCriteria może być używany dla każdego obserwatora w dowolnym momencie.One AnchorLocateCriteria object may be used per watcher at any time. Każdy obiekt AnchorLocateCriteria musi zawierać dokładnie jedną z następujących właściwości: Identifiers, NearAnchorlub NearDevice.Each AnchorLocateCriteria object must include exactly one of the following properties: Identifiers, NearAnchor, or NearDevice. W razie potrzeby można ustawić dodatkowe właściwości, takie jak strategia, BypassCachei RequestedCategories .Additional properties such as Strategy, BypassCache, and RequestedCategories can be set if desired.

WłaściwościProperties

Zdefiniuj dokładnie jedną z następujących właściwości w monitorze:Define exactly one of the following properties in your watcher:

IdentyfikatoryIdentifiers

Wartość domyślna: pusta tablica ciągówDefault Value: empty string array

Korzystając z identyfikatorów, można zdefiniować listę identyfikatorów zakotwiczenia dla kotwic, które chcesz zlokalizować.Using Identifiers, you can define a list of anchor IDs for anchors you would like to locate. Identyfikatory zakotwiczenia są początkowo zwracane po pomyślnym utworzeniu kotwicy.Anchor IDs are initially returned to you after successful anchor creation. W przypadku określonych identyfikatorów AnchorLocateCriteria ogranicza zestaw żądanych kotwic do kotwic ze zgodnymi identyfikatorami zakotwiczenia.With Identifiers specified, AnchorLocateCriteria restricts the set of requested anchors to anchors with matching anchor IDs. Ta właściwość jest określana przy użyciu tablicy ciągów.This property is specified using a string array.

NearAnchorNearAnchor

Wartość domyślna: nie ustawionoDefault Value: not set

Za pomocą NearAnchor można określić, że AnchorLocateCriteria ogranicza zestaw żądanych kotwic do kotwic w obrębie żądanej odległości od wybranej kotwicy.Using NearAnchor, you can specify that AnchorLocateCriteria restricts the set of requested anchors to anchors within a desired distance away from a chosen anchor. Musisz podać wybrane kotwicę jako kotwicę źródłową.You must provide this chosen anchor as the source anchor. Możesz również ustawić pożądaną odległość od kotwicy źródłowej i maksymalną liczbę zwracanych kotwic, aby dodatkowo ograniczyć wyszukiwanie.You may also set the desired distance away from the source anchor, and the maximum number of anchors returned, to further limit the search. Ta właściwość jest określana za pomocą obiektu NearAnchorCriteria.This property is specified using a NearAnchorCriteria object.

NearDeviceNearDevice

Wartość domyślna: nie ustawionoDefault Value: not set

Za pomocą NearDevice można określić, że AnchorLocateCriteria ogranicza zestaw żądanych kotwic do tych blisko fizycznej lokalizacji urządzenia.Using NearDevice, you can specify that AnchorLocateCriteria restricts the set of requested anchors to those close to the device’s physical location. Wszystkie włączone czujniki zostaną użyte w celu ułatwienia wykrycia zakotwiczenia na urządzeniu.Any enabled sensors will be used to help discover anchors around your device. Aby zapewnić najlepszą szansę znajdowania kotwic, należy skonfigurować SensorCapabilities, aby zapewnić sesji dostęp do wszystkich odpowiednich czujników.To have the best chance of finding anchors, you should configure SensorCapabilities to give the session access to all appropriate sensors. Aby uzyskać więcej informacji na temat konfigurowania i używania tej właściwości, zobacz niestandardowa relokalizacja — kotwice przestrzenne platformy Azure | Microsoft docs i sposób tworzenia i lokalizowania kotwic przy użyciu bardzo dużej lokalizacji w językach C#, obiektyw-C, SWIFT, Java, c++/NDKi c++/WinRT.For more information on setting up and using this property, see 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 za pomocą obiektu NearDeviceCriteria.This property is specified using a NearDeviceCriteria object.

Dodatkowe właściwościAdditional properties

BypassCacheBypassCache

Wartość domyślna: FAŁSZDefault Value: false

Gdy kotwica została utworzona lub znaleziona w sesji, jest również przechowywana w pamięci podręcznej.When an anchor has been created or found in a session, it is also stored in the cache. Gdy ta właściwość ma wartość false, wszystkie kolejne zapytania w tej samej sesji będą zwracały buforowaną wartość.With this property set to false, any subsequent query in the same session will return the cached value. Nie przeprowadzono żądania do usługi ASA.No request to the ASA service is made.

RequestedCategoriesRequestedCategories

Wartość domyślna: właściwości | PrzestrzennychDefault Value: Properties | Spatial

Ta właściwość służy do określania, jakie dane są zwracane z zapytania przy użyciu AnchorLocateCriteria.This property is used to determine what data is returned from a query using AnchorLocateCriteria. Wartość domyślna zwraca zarówno właściwości, jak i dane przestrzenne, dlatego nie powinna być zmieniana, jeśli właściwości i dane przestrzenne są wymagane.The default value returns both properties and spatial data, this should not be changed if properties and spatial data are both desired. Tę właściwość można określić za pomocą wyliczenia AnchorDataCategory.This property can be specified using the AnchorDataCategory enum.

Wartość wyliczenia AnchorDataCategoryAnchorDataCategory Enum Value Zwrócone daneReturned Data
BrakNone Nie zwrócono żadnych danychNo data is returned
WłaściwościProperties Są zwracane właściwości zakotwiczenia, w tym AppProperties.Anchor properties including AppProperties are returned.
PrzestrzenneSpatial Zwrócono informacje przestrzenne dotyczące kotwicy.Spatial information about an anchor is returned.

StrategiaStrategy

Wartość domyślna: AnyStrategyDefault Value: AnyStrategy

Strategia w dalszej postaci definiuje, jak powinny znajdować się kotwice.Strategy further defines how anchors should be located. Właściwość strategii można określić za pomocą wyliczenia LocateStrategy.The Strategy property may be specified using a LocateStrategy enum.

Wartość wyliczenia LocateStrategyLocateStrategy Enum Value OpisDescription
AnyStrategyAnyStrategy Ta strategia umożliwia systemowi używanie kombinacji VisualInformation i strategii relacji do znajdowania kotwic.This strategy permits the system to use combinations of VisualInformation and Relationship strategies to find anchors.
VisualInformationVisualInformation Ta strategia próbuje znaleźć kotwice poprzez dopasowanie informacji wizualnych z bieżącego otoczenia do elementów wizualizacji zakotwiczenia.This strategy attempts to find anchors by matching visual information from the current surroundings to those of the anchor’s visual footprint. Wizualizacja zakotwiczenia odwołuje się do informacji wizualnych aktualnie skojarzonych z zakotwiczeniem.An anchor’s visual footprint refers to the visual information currently associated with the anchor. Te informacje wizualne są zwykle, ale nie są zbierane wyłącznie podczas tworzenia kotwicy.This visual information is typically but not exclusively gathered during anchor creation. Obecnie ta strategia jest dozwolona tylko w połączeniu z właściwościami NearDevice lub identyfikatorami.Currently, this strategy is only permitted in conjunction with the NearDevice or Identifiers properties.
RelacjaRelationship Ta strategia próbuje znaleźć kotwice, wykorzystując istniejące połączone kotwice.This strategy attempts to find anchors by making use of existing connected anchors. Obecnie ta strategia jest dozwolona tylko w połączeniu z właściwościami NearAnchor lub identyfikatorami.Currently, this strategy is only permitted in conjunction with the NearAnchor or Identifiers properties. Gdy jest używany z właściwością identyfikatory, jest wymagane, aby w tej samej sesji użytkownik miał wcześniej zlokalizowane kotwice, które mają już ustanowione relacje łączące z kotwicami, których identyfikatory zostały określone w tablicy identyfikatorów.When used with the Identifiers property, it is required that, in the same session, the user should have previously located an anchor(s) with already established connective relationships to the anchors whose IDs are specified in the Identifiers array.

Prawidłowe kombinacje właściwości LocateStrategy i AnchorLocateCriteriaValid combinations of LocateStrategy and AnchorLocateCriteria properties

Nie wszystkie kombinacje strategii i właściwości AnchorLocateCriteria są obecnie dozwolone przez system.Not all combinations of Strategy and AnchorLocateCriteria properties are currently permitted by the system. W poniższej tabeli przedstawiono dozwolone kombinacje:The following table shows the allowed combinations:

WłaściwośćProperty AnyStrategyAnyStrategy RelacjaRelationship VisualInformationVisualInformation
IdentyfikatoryIdentifiers
NearAnchorNearAnchor ✓ (domyślnie jest to relacja)✓ (will default to Relationship)
NearDeviceNearDevice

Następne krokiNext steps

Zobacz jak utworzyć i zlokalizować kotwice przy użyciu kotwic przestrzennych platformy Azure , aby uzyskać więcej przykładów przy użyciu klasy AnchorLocateCriteria.See How to create and locate anchors using Azure Spatial Anchors for some more examples using the AnchorLocateCriteria class.