Förstå klassen AnchorLocateCriteria
I den här artikeln får du lära dig de olika alternativ som du kan använda när du kör frågor mot en fästpunkt. Vi går igenom klassen AnchorLocateCriteria, dess alternativ och giltiga alternativkombinationer.
Villkor för fästpunktslokalisering
Klassen AnchorLocateCriteria hjälper dig att fråga efter tidigare skapade fästpunkter i tjänsten. Ett AnchorLocateCriteria-objekt kan användas per bevakare när som helst. Varje AnchorLocateCriteria-objekt måste innehålla exakt en av följande egenskaper: Identifierare, NearAnchor eller NearDevice. Ytterligare egenskaper som Strategi, BypassCache och RequestedCategories kan anges om du vill.
Egenskaper
Definiera exakt en av följande egenskaper i din bevakare:
Identifiers
Standardvärde: tom strängmatris
Med identifierare kan du definiera en lista över fästpunkts-ID:er för fästpunkter som du vill hitta. Fästpunkts-ID:t returneras ursprungligen till dig efter att fästpunkt har skapats. Med Angivna identifierare begränsar AnchorLocateCriteria uppsättningen begärda fästpunkter till fästpunkter med matchande fästpunkts-ID: er. Den här egenskapen anges med hjälp av en strängmatris.
NearAnchor
Standardvärde: inte inställt
Med NearAnchor kan du ange att AnchorLocateCriteria begränsar uppsättningen begärda fästpunkter till fästpunkter inom ett önskat avstånd från ett valt fästpunkt. Du måste ange den valda fästpunkten som källankare. Du kan också ange det önskade avståndet bort från källankaret och det maximala antalet fästpunkter som returneras för att ytterligare begränsa sökningen. Den här egenskapen anges med hjälp av ett NearAnchorCriteria-objekt.
NearDevice
Standardvärde: inte inställt
Med Hjälp av NearDevice kan du ange att AnchorLocateCriteria begränsar uppsättningen begärda fästpunkter till dem som ligger nära enhetens fysiska plats. Alla aktiverade sensorer används för att identifiera fästpunkter runt din enhet. För att få bästa möjliga chans att hitta fästpunkter bör du konfigurera SensorCapabilities för att ge sessionen åtkomst till alla lämpliga sensorer. Mer information om hur du konfigurerar och använder den här egenskapen finns i Coarse Relocalization – Azure Spatial Anchors | Microsoft Docs och 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 hjälp av ett NearDeviceCriteria-objekt.
Ytterligare egenskaper
BypassCache
Standardvärde: false
När en fästpunkt har skapats eller hittats i en session lagras den också i cacheminnet. Med den här egenskapen inställd på false returnerar alla efterföljande frågor i samma session det cachelagrade värdet. Ingen begäran till ASA-tjänsten görs.
RequestedCategories
Standardvärde: Egenskaper | Rumsliga
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. Standardvärdet returnerar både egenskaper och rumsliga data. Detta bör inte ändras om både egenskaper och rumsliga data önskas. Den här egenskapen kan anges med anchorDataCategory-uppräkningen.
AnchorDataCategory Uppräkningsvärde | Returnerade data |
---|---|
None | Inga data returneras |
Egenskaper | Fästpunktsegenskaper inklusive AppProperties returneras. |
Rumslig | Rumslig information om en fästpunkt returneras. |
Strategi
Standardvärde: AnyStrategy
Strategin definierar ytterligare hur fästpunkter ska placeras. Egenskapen Strategi kan anges med en LocateStrategy-uppräkning.
LocateStrategy Uppräkningsvärde | Description |
---|---|
AnyStrategy | Med den här strategin kan systemet använda kombinationer av VisualInformation- och Relationsstrategier för att hitta fästpunkter. |
VisualInformation | Den här strategin försöker hitta fästpunkter genom att matcha visuell information från den aktuella omgivningen till fästpunktens visuella fotavtryck. Ett fästpunkts visuella fotavtryck refererar till den visuella information som för närvarande är associerad med fästpunkten. Den här visuella informationen samlas vanligtvis in men samlas inte enbart in när fästpunkt skapas. För närvarande är den här strategin endast tillåten tillsammans med egenskaperna NearDevice eller Identifierare. |
Relation | Den här strategin försöker hitta fästpunkter genom att använda befintliga anslutna fästpunkter. För närvarande är den här strategin endast tillåten tillsammans med egenskaperna NearAnchor eller Identifierare. När den används med egenskapen Identifierare krävs det att användaren i samma session tidigare har hittat en fästpunkt med redan etablerade anslutningsrelationer till fästpunkterna vars ID anges i matrisen Identifierare. |
Giltiga kombinationer av egenskaperna LocateStrategy och AnchorLocateCriteria
Alla kombinationer av egenskaperna Strategi och AnchorLocateCriteria tillåts för närvarande inte av systemet. I följande tabell visas de tillåtna kombinationerna:
Property | AnyStrategy | Relation | VisualInformation |
---|---|---|---|
Identifiers | ✓ | ✓ | ✓ |
NearAnchor | √ (kommer som standard att vara Relation) | ✓ | |
NearDevice | ✓ | ✓ |
Nästa steg
Se Skapa och hitta fästpunkter med Hjälp av Azure Spatial Anchors för några fler exempel med klassen AnchorLocateCriteria.