Principy třídy AnchorLocateCriteria

V tomto článku se dozvíte o různých možnostech, které můžete použít při dotazování ukotvení. Přejdeme přes AnchorLocateCriteria třídy, její možnosti a platné kombinace možností.

Kritéria pro vyhledání ukotvení

Třída AnchorLocateCriteria pomáhá dotazovat službu pro dříve vytvořené kotvy. Jeden AnchorLocateCriteria objekt může být použit na sledovací proces kdykoli. Každý AnchorLocateCriteria objekt musí obsahovat přesně jednu z následujících vlastností: Identifiers, NearAnchor nebo NearDevice. V případě potřeby je možné nastavit další vlastnosti, jako jsou strategie, BypassCache a RequestedCategories .

Vlastnosti

V sledovacím nástroji definujte přesně jednu z následujících vlastností:

Identifiers

Výchozí hodnota: prázdné pole řetězců

Pomocí identifikátorů můžete definovat seznam ID ukotvení pro kotvy, které chcete vyhledat. ID ukotvení se vám zpočátku vrátí po úspěšném vytvoření ukotvení. Se zadanými identifikátory omezuje AnchorLocateCriteria sadu požadovaných ukotvení na ukotvení s odpovídajícími ID ukotvení. Tato vlastnost je určena pomocí pole řetězců.

NearAnchor

Výchozí hodnota: nenastaví se

Pomocí nearAnchor můžete určit, že AnchorLocateCriteria omezuje sadu požadovaných ukotvení na ukotvení v požadované vzdálenosti od zvoleného ukotvení. Tuto vybranou ukotvení musíte zadat jako zdrojová ukotvení. Můžete také nastavit požadovanou vzdálenost od zdrojového ukotvení a maximální počet vrácených ukotvení pro další omezení hledání. Tato vlastnost je určena pomocí NearAnchorCriteria objektu.

NearDevice

Výchozí hodnota: nenastaví se

Pomocí funkce NearDevice můžete určit, že AnchorLocateCriteria omezuje sadu požadovaných ukotvení na ty, které jsou blízko fyzického umístění zařízení. Všechny povolené senzory se použijí k objevování ukotvení kolem vašeho zařízení. Pokud chcete mít nejlepší šanci najít kotvy, měli byste nakonfigurovat SensorCapabilities tak, aby relace měla přístup ke všem příslušným senzorům. Další informace o nastavení a použití této vlastnosti naleznete v tématu Přibližná relokalizace – Azure Spatial Anchors | Microsoft Docs a jak vytvářet a vyhledávat kotvy pomocí hrubé relokalizace v jazyce C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT. Tato vlastnost je určena pomocí NearDeviceCriteria objektu.

Další vlastnosti

BypassCache

Výchozí hodnota: false

Při vytvoření nebo nalezení ukotvení v relaci se také uloží do mezipaměti. Pokud je tato vlastnost nastavena na false, všechny následné dotazy ve stejné relaci vrátí hodnotu uloženou v mezipaměti. Není proveden žádný požadavek na službu ASA.

Požadované kategorieKategorie

Výchozí hodnota: Vlastnosti | Prostorové

Tato vlastnost slouží k určení dat vrácených z dotazu pomocí AnchorLocateCriteria. Výchozí hodnota vrátí vlastnosti i prostorová data. Tato hodnota by neměla být změněna, pokud jsou požadované vlastnosti a prostorová data. Tuto vlastnost lze zadat pomocí výčtu AnchorDataCategory.

AnchorDataCategory – hodnota výčtu	Vrácená data
Nic	Nevrátí se žádná data.
Vlastnosti	Vrátí se vlastnosti ukotvení, včetně AppProperties.
Spatial	Vrátí se prostorové informace o ukotvení.

Strategie

Výchozí hodnota: AnyStrategy

Strategie dále definuje, jak se mají kotvy nacházet. Vlastnost Strategy může být zadána pomocí funkce LocateStrategy výčtu.

LocateStrategy – hodnota výčtu	Popis
AnyStrategy	Tato strategie umožňuje systému používat kombinace strategií VisualInformation a Relationship k vyhledání ukotvení.
VisualInformation	Tato strategie se snaží najít kotvy tím, že porovnává vizuální informace z aktuálního okolí s informacemi o vizuální stopě ukotvení. Vizuální stopa ukotvení odkazuje na informace o vizuálu, které jsou aktuálně přidružené k ukotvení. Tyto vizuální informace se obvykle shromažďují, ale ne výhradně během vytváření ukotvení. V současné době je tato strategie povolena pouze ve spojení s vlastnostmi NearDevice nebo Identifiers.
Vztah	Tato strategie se pokouší najít ukotvení pomocí existujících propojených ukotvení. V současné době je tato strategie povolena pouze ve spojení s vlastnostmi NearAnchor nebo Identifiers. Při použití s identifikátory vlastnost je nutné, aby uživatel ve stejné relaci dříve nastavil ukotvení s již vytvořenými connectivními relacemi k ukotvením, jejichž ID jsou zadána v poli Identifikátory.

Platné kombinace vlastností LocateStrategy a AnchorLocateCriteria

Ne všechny kombinace vlastností Strategy a AnchorLocateCriteria jsou v současné době povoleny systémem. V následující tabulce jsou uvedeny povolené kombinace:

Vlastnost	AnyStrategy	Vztah	VisualInformation
Identifiers	✓	✓	✓
NearAnchor	– (výchozí hodnota je relace)	✓
NearDevice	✓		✓

Další kroky

Další příklady použití třídy AnchorLocateCriteria najdete v tématu Vytvoření a vyhledání ukotvení pomocí Azure Spatial Anchors .