Grundlegende Informationen zur AnchorLocateCriteria-Klasse

In diesem Artikel erfahren Sie mehr über die verschiedenen Optionen, die Sie beim Abfragen eines Ankers verwenden können. Dabei werden die AnchorLocateCriteria-Klasse, die entsprechenden Optionen sowie gültige Optionskombinationen behandelt.

Suchkriterien für Anker

Die AnchorLocateCriteria-Klasse unterstützt Sie beim Abfragen des Diensts nach zuvor erstellten Ankern. Ein AnchorLocateCriteria-Objekt kann jederzeit über einen Watcher verwendet werden. Jedes AnchorLocateCriteria-Objekt muss genau eine der folgenden Eigenschaften enthalten: Identifiers, NearAnchor oder NearDevice. Bei Bedarf können auch zusätzliche Eigenschaften wie Strategy, BypassCache und RequestedCategories festgelegt werden.

Eigenschaften

Definieren Sie genau eine der folgenden Eigenschaften in Ihrem Watcher:

Bezeichner

Standardwert: Leeres Zeichenfolgenarray

Mithilfe von „Identifiers“ können Sie eine Liste von Anker-IDs für Anker definieren, die Sie suchen möchten. Anker-IDs werden anfänglich nach der erfolgreichen Ankererstellung zurückgegeben. Wenn „Identifiers“ festgelegt ist, schränkt „AnchorLocateCriteria“ die angeforderten Anker auf die Anker mit übereinstimmenden Anker-IDs ein. Diese Eigenschaft wird mithilfe eines Zeichenfolgenarrays angegeben.

NearAnchor

Standardwert: Nicht festgelegt

Mithilfe von „NearAnchor“ können Sie festlegen, dass „AnchorLocateCriteria“ die angeforderten Anker auf die Anker beschränkt, die sich innerhalb einer gewünschten Entfernung von einem ausgewählten Anker befinden. Sie müssen diesen ausgewählten Anker als Quellanker bereitstellen. Sie können auch die gewünschte Entfernung vom Quellanker und die maximale Anzahl der zurückgegebenen Anker festlegen, um die Suche weiter einzuschränken. Diese Eigenschaft wird mithilfe eines NearAnchorCriteria-Objekts angegeben.

NearDevice

Standardwert: Nicht festgelegt

Mithilfe von „NearDevice“ können Sie angeben, dass „AnchorLocateCriteria“ die angeforderten Anker auf die Anker beschränkt, die sich in der Nähe des physischen Standorts des Geräts befinden. Alle aktivierten Sensoren werden verwendet, um Anker in der Nähe Ihres Geräts zu ermitteln. Sie sollten „SensorCapabilities“ so konfigurieren, dass die Sitzung auf alle geeigneten Sensoren zugreifen kann, um die besten Bedingungen für die Suche nach Ankern zu schaffen. Weitere Informationen zum Einrichten und Verwenden dieser Eigenschaft in C#, Objective-C, Swift, Java, C++/NDK und C++/WinRT finden Sie unter Ungefähre Standortbestimmung und Erstellen von und Suchen nach Ankern mithilfe der ungefähren Standortbestimmung. Diese Eigenschaft wird mithilfe eines NearDeviceCriteria-Objekts angegeben.

Zusätzliche Eigenschaften

BypassCache

Standardwert: „false“

Wenn ein Anker erstellt oder in einer Sitzung gefunden wurde, wird er ebenfalls im Cache gespeichert. Wenn diese Eigenschaft auf „false“ festgelegt ist, wird bei jeder nachfolgenden Abfrage in derselben Sitzung der zwischengespeicherte Wert zurückgegeben. Es erfolgt keine Anforderung an den ASA-Dienst.

RequestedCategories

Standardwert: Properties | Spatial

Diese Eigenschaft wird verwendet, um zu bestimmen, welche Daten von einer Abfrage mithilfe von „AnchorLocateCriteria“ zurückgegeben werden. Der Standardwert gibt sowohl Eigenschaften als auch räumliche Daten zurück. Dieser Wert sollte nicht geändert werden, wenn sowohl Eigenschaften als auch räumliche Daten zurückgegeben werden sollen. Diese Eigenschaft kann mithilfe der AnchorDataCategory-Enumeration angegeben werden.

AnchorDataCategory-Enumerationswert	Zurückgegebene Daten
None	Es werden keine Daten zurückgegeben.
Eigenschaften	Es werden Ankereigenschaften einschließlich „AppProperties“ zurückgegeben.
Spatial	Es werden räumliche Informationen zu einem Anker zurückgegeben.

Strategie

Standardwert: „AnyStrategy“

„Strategy“ definiert, wie nach Ankern gesucht werden soll. Die Eigenschaft „Strategy“ kann mithilfe einer LocateStrategy-Enumeration angegeben werden.

LocateStrategy-Enumerationswert	Beschreibung
AnyStrategy	Diese Strategie ermöglicht dem System die Verwendung von Kombinationen der VisualInformation- und Relationship-Strategien für die Suche nach Ankern.
VisualInformation	Bei dieser Strategie wird versucht, nach Ankern zu suchen, indem visuelle Informationen aus der aktuellen Umgebung mit den Informationen zum visuellen Speicherbedarf des Ankers abgeglichen werden. Der visuelle Speicherbedarf eines Ankers bezieht sich auf die visuellen Informationen, die dem Anker derzeit zugeordnet sind. Diese visuellen Informationen werden normalerweise bei der Ankererstellung gesammelt, allerdings nicht ausschließlich bei diesem Vorgang. Diese Strategie ist zurzeit nur in Verbindung mit den Eigenschaften „NearDevice“ und „Identifiers“ zulässig.
Beziehung	Bei dieser Strategie werden Anker gesucht, indem vorhandene verbundene Anker verwendet werden. Diese Strategie ist zurzeit nur in Verbindung mit den Eigenschaften „NearAnchor“ und „Identifiers“ zulässig. Bei Verwendung mit der Identifiers-Eigenschaft ist es erforderlich, dass der Benutzer in derselben Sitzung bereits einen oder mehrere Anker mit bereits eingerichteten Verbindungsbeziehungen zu den Ankern gefunden hat, deren IDs im Identifiers-Array angegeben sind.

Gültige Kombinationen der Eigenschaften „LocateStrategy“ und „AnchorLocateCriteria“

Nicht alle Kombinationen der Eigenschaften „Strategy“ und „AnchorLocateCriteria“ werden derzeit vom System zugelassen. In der folgenden Tabelle sind die zulässigen Kombinationen aufgeführt:

Eigenschaft	AnyStrategy	Beziehung	VisualInformation
Bezeichner	✓	✓	✓
NearAnchor	✓ (wird standardmäßig auf „Relationship“ festgelegt)	✓
NearDevice	✓		✓

Nächste Schritte

Weitere Beispiele zur Verwendung der AnchorLocateCriteria-Klasse finden Sie unter Erstellen von und Suchen nach Ankern mit Azure Spatial Anchors.