Förstå klassen AnchorLocateCriteriaUnderstanding the AnchorLocateCriteria class

I den här artikeln får du lära dig de olika alternativen som du kan använda när du frågar efter ett ankare.In this article you will learn the different options you can use when querying an anchor. Vi kommer att gå över AnchorLocateCriteria-klassen, dess alternativ och giltiga alternativ kombinationer.We will go over the AnchorLocateCriteria class, its options and valid option combinations.

Fäst Sök villkorAnchor locate criteria

Klassen AnchorLocateCriteria hjälper dig att fråga tjänsten för tidigare skapade ankare.The AnchorLocateCriteria class helps you query the service for previously created anchors. Ett AnchorLocateCriteria-objekt kan användas per övervakare när som helst.One AnchorLocateCriteria object may be used per watcher at any time. Varje AnchorLocateCriteria-objekt måste innehålla exakt en av följande egenskaper: identifierare, NearAnchoreller NearDevice.Each AnchorLocateCriteria object must include exactly one of the following properties: Identifiers, NearAnchor, or NearDevice. Ytterligare egenskaper som strategi, BypassCacheoch RequestedCategories kan anges om du vill.Additional properties such as Strategy, BypassCache, and RequestedCategories can be set if desired.

EgenskaperProperties

Definiera exakt en av följande egenskaper i din Övervakare:Define exactly one of the following properties in your watcher:

IdentifierareIdentifiers

Standardvärde: tom sträng mat risDefault Value: empty string array

Med hjälp av identifierare kan du definiera en lista med ankar-ID: n för ankare som du vill hitta.Using Identifiers, you can define a list of anchor IDs for anchors you would like to locate. Anchor-ID: n returneras ursprungligen till dig efter att du har skapat ankaret.Anchor IDs are initially returned to you after successful anchor creation. Med identifierade identifierare begränsar AnchorLocateCriteria uppsättningen med begärda ankare till ankare med matchande ankar-ID.With Identifiers specified, AnchorLocateCriteria restricts the set of requested anchors to anchors with matching anchor IDs. Den här egenskapen anges med en sträng mat ris.This property is specified using a string array.

NearAnchorNearAnchor

Standardvärde: inte angivetDefault Value: not set

Med NearAnchor kan du ange att AnchorLocateCriteria begränsar uppsättningen av begärda ankare till ankare inom ett önskat avstånd från en vald fäst punkt.Using NearAnchor, you can specify that AnchorLocateCriteria restricts the set of requested anchors to anchors within a desired distance away from a chosen anchor. Du måste ange det här valda ankaret som käll ankare.You must provide this chosen anchor as the source anchor. Du kan också ange det önskade avståndet från käll fäst punkten och det maximala antalet ankare som returneras för att ytterligare begränsa sökningen.You may also set the desired distance away from the source anchor, and the maximum number of anchors returned, to further limit the search. Den här egenskapen anges med ett NearAnchorCriteria-objekt.This property is specified using a NearAnchorCriteria object.

NearDeviceNearDevice

Standardvärde: inte angivetDefault Value: not set

Med NearDevice kan du ange att AnchorLocateCriteria begränsar uppsättningen av begärda ankare till de nära enhetens fysiska plats.Using NearDevice, you can specify that AnchorLocateCriteria restricts the set of requested anchors to those close to the device’s physical location. Alla aktiverade sensorer kommer att användas för att identifiera ankare runt enheten.Any enabled sensors will be used to help discover anchors around your device. Om du vill ha bästa möjliga möjlighet att hitta ankare bör du konfigurera SensorCapabilities för att ge sessionen åtkomst till alla lämpliga sensorer.To have the best chance of finding anchors, you should configure SensorCapabilities to give the session access to all appropriate sensors. Mer information om hur du konfigurerar och använder den här egenskapen finns i grov omlokalisering – Azure spatiala ankare | Microsoft docs och hur du skapar och hittar ankare med grov omlokalisering i C#, mål-C, Swift, Java, c++/NDK, 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. Den här egenskapen anges med ett NearDeviceCriteria-objekt.This property is specified using a NearDeviceCriteria object.

Ytterligare egenskaperAdditional properties

BypassCacheBypassCache

Standardvärde: falsktDefault Value: false

När ett ankare har skapats eller hittats i en session lagras det också i cacheminnet.When an anchor has been created or found in a session, it is also stored in the cache. När den här egenskapen har angetts till False kommer alla efterföljande frågor i samma session att returnera det cachelagrade värdet.With this property set to false, any subsequent query in the same session will return the cached value. Ingen begäran till ASA-tjänsten har gjorts.No request to the ASA service is made.

RequestedCategoriesRequestedCategories

Standardvärde: egenskaper | GeospatialDefault Value: Properties | Spatial

Den här egenskapen används för att avgöra vilka data som returneras från en fråga med hjälp av AnchorLocateCriteria.This property is used to determine what data is returned from a query using AnchorLocateCriteria. Standardvärdet returnerar både egenskaper och spatialdata. Detta bör inte ändras om både egenskaper och spatialdata är önskade.The default value returns both properties and spatial data, this should not be changed if properties and spatial data are both desired. Den här egenskapen kan anges med AnchorDataCategory-uppräkningen.This property can be specified using the AnchorDataCategory enum.

AnchorDataCategory Enum-värdeAnchorDataCategory Enum Value Returnerade dataReturned Data
IngetNone Inga data returnerasNo data is returned
EgenskaperProperties Fäst punkts egenskaper, inklusive AppProperties, returneras.Anchor properties including AppProperties are returned.
SpatialSpatial Spatial information om ett ankare returneras.Spatial information about an anchor is returned.

StrategiStrategy

Standardvärde: AnyStrategyDefault Value: AnyStrategy

Strategin definierar ytterligare hur ankare ska placeras.Strategy further defines how anchors should be located. Strategi egenskapen kan anges med en LocateStrategy-uppräkning.The Strategy property may be specified using a LocateStrategy enum.

LocateStrategy Enum-värdeLocateStrategy Enum Value BeskrivningDescription
AnyStrategyAnyStrategy Den här strategin gör det möjligt för systemet att använda kombinationer av VisualInformation och Relations strategier för att hitta ankare.This strategy permits the system to use combinations of VisualInformation and Relationship strategies to find anchors.
VisualInformationVisualInformation Den här strategin försöker hitta ankare genom att matcha visuell information från den aktuella omgivningen till dem i ankarets visuella objekt.This strategy attempts to find anchors by matching visual information from the current surroundings to those of the anchor’s visual footprint. Ett Ankares visuella objekt syftar på den visuella information som för närvarande är kopplad till ankaret.An anchor’s visual footprint refers to the visual information currently associated with the anchor. Den här visuella informationen är vanligt vis men inte exklusivt insamlad under skapandet av ankare.This visual information is typically but not exclusively gathered during anchor creation. För närvarande tillåts denna strategi bara tillsammans med egenskaperna NearDevice eller Identifiers.Currently, this strategy is only permitted in conjunction with the NearDevice or Identifiers properties.
RelationRelationship Den här strategin försöker hitta ankare genom att använda befintliga anslutna ankare.This strategy attempts to find anchors by making use of existing connected anchors. För närvarande tillåts denna strategi bara tillsammans med egenskaperna NearAnchor eller Identifiers.Currently, this strategy is only permitted in conjunction with the NearAnchor or Identifiers properties. När det används med egenskapen identifierare, krävs det att användaren i samma session redan har hittat en eller flera ankare med redan upprättat kopplings relationer till de ankare vars ID: n har angetts i matrisen för identifierare.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.

Giltiga kombinationer av egenskaper för LocateStrategy och AnchorLocateCriteriaValid combinations of LocateStrategy and AnchorLocateCriteria properties

Alla kombinationer av strategi-och AnchorLocateCriteria egenskaper tillåts för närvarande inte av systemet.Not all combinations of Strategy and AnchorLocateCriteria properties are currently permitted by the system. I följande tabell visas tillåtna kombinationer:The following table shows the allowed combinations:

EgenskapProperty AnyStrategyAnyStrategy RelationRelationship VisualInformationVisualInformation
IdentifierareIdentifiers
NearAnchorNearAnchor ✓ (är som standard relationen)✓ (will default to Relationship)
NearDeviceNearDevice

Nästa stegNext steps

Se hur du skapar och lokaliserar ankare med hjälp av Azures spatiala ankare för några fler exempel som använder klassen AnchorLocateCriteria.See How to create and locate anchors using Azure Spatial Anchors for some more examples using the AnchorLocateCriteria class.