A AnchorLocateCriteria osztály ismertetése

Ebben a cikkben megismerheti a horgonyok lekérdezéséhez használható különböző lehetőségeket. A AnchorLocateCriteria osztályt, annak lehetőségeit és érvényes kombinációit fogjuk megtenni.

Horgony megkeresésének feltételei

A AnchorLocateCriteria osztály segítségével lekérdezheti a korábban létrehozott horgonyok szolgáltatását. Egy AnchorLocateCriteria-objektum bármikor felhasználható egy figyelőre. Minden AnchorLocateCriteria objektumnak pontosan a következő tulajdonságok egyikét kell tartalmaznia: azonosítók, NearAnchorvagy NearDevice. Szükség esetén további tulajdonságok is megadhatók, például a stratégia, a BypassCacheés a RequestedCategories .

Tulajdonságok

Adja meg pontosan az alábbi tulajdonságok egyikét a figyelőben:

Azonosítók

Alapértelmezett érték: üres karakterlánc-tömb

Az azonosítók használatával megadhatja a megkeresni kívánt horgonyokhoz tartozó horgony-azonosítók listáját. A horgony-azonosítók kezdetben a sikeres horgony létrehozása után lesznek visszaadva. A megadott azonosítókkal a AnchorLocateCriteria korlátozza a kért horgonyok készletét a megfelelő szerkesztőpont-azonosítókkal rendelkező horgonyokra. Ez a tulajdonság karakterlánc-tömb használatával van megadva.

NearAnchor

Alapértelmezett érték: nincs beállítva

A NearAnchor segítségével megadhatja, hogy a AnchorLocateCriteria korlátozza a kért horgonyok készletét a kiválasztott horgonytól távol lévő kívánt távolságra. Ezt a kiválasztott horgonyt a forrás-horgonyként kell megadnia. A keresés további korlátozásához a forrás-és a visszaadott horgonyok maximális számát is beállíthatja. Ez a tulajdonság egy NearAnchorCriteria objektummal van megadva.

NearDevice

Alapértelmezett érték: nincs beállítva

A NearDevice segítségével megadhatja, hogy a AnchorLocateCriteria korlátozza a kért horgonyok készletét az eszköz fizikai helyére közel lévő értékekre. Az eszközön található horgonyok felderítéséhez az összes engedélyezett érzékelőt fogja használni a rendszer. Ahhoz, hogy a legjobb eséllyel megtalálják a horgonyokat, konfigurálnia kell a SensorCapabilities, hogy a munkamenet hozzáférjen az összes megfelelő érzékelőkhöz. A tulajdonság beállításával és használatával kapcsolatos további információkért lásd: durva újrahonosítás – Azure térbeli horgonyok | Microsoft docs , és hogyan hozhatók létre és találhatók az olyan horgonyok, amelyek a C#, az Objective-C, a Swift, a Java, a c++/NDKés a c++/WinRT használatával történő durva újrahonosítást használnak . Ez a tulajdonság egy NearDeviceCriteria objektummal van megadva.

További tulajdonságok

BypassCache

Alapértelmezett érték: false

Amikor létrehoztak egy horgonyt vagy megtaláltak egy munkamenetben, azt a gyorsítótárban is tárolja a rendszer. Ha ez a tulajdonság hamis értékre van állítva, akkor az ugyanabban a munkamenetben lévő minden további lekérdezés visszaadja a gyorsítótárazott értéket. Nem történt kérelem az ASA szolgáltatáshoz.

RequestedCategories

Alapértelmezett érték: Properties | Térbeli

Ezzel a tulajdonsággal határozható meg, hogy milyen adatok legyenek visszaadva egy lekérdezésből a AnchorLocateCriteria használatával. Az alapértelmezett érték mindkét tulajdonságot és térbeli értéket adja vissza, ez nem módosítható, ha a tulajdonságok és a térbeli adatok egyaránt szükségesek. Ez a tulajdonság a AnchorDataCategory Enum használatával adható meg.

AnchorDataCategory enumerálási értéke Visszaadott adatok
Nincsenek Nincs visszaadott érték
Tulajdonságok A horgony tulajdonságai, beleértve a AppProperties is, visszaadva.
Térbeli A rendszer a horgonyra vonatkozó térbeli adatokat adja vissza.

Stratégia

Alapértelmezett érték: AnyStrategy

A stratégia részletesebben határozza meg a horgonyok elhelyezkedését. A stratégia tulajdonságot LocateStrategy Enum használatával lehet megadni.

LocateStrategy enumerálási értéke Leírás
AnyStrategy Ez a stratégia lehetővé teszi, hogy a rendszerek a VisualInformation és a kapcsolati stratégiák kombinációit használják a horgonyok kereséséhez.
VisualInformation Ez a stratégia megkísérli megtalálni a horgonyokat az aktuális környezetből származó vizualizációs információk alapján a horgony vizualizációs lábnyomának megfelelő értékekkel. A horgony vizualizációs lábnyoma a horgonyhoz jelenleg kapcsolódó vizualizációs információkra utal. Ez a vizualizációs információ általában azonban nem gyűjti össze kizárólag a horgony létrehozásakor. Ez a stratégia jelenleg csak a NearDevice vagy az azonosítók tulajdonságaival együtt engedélyezett.
Kapcsolat Ez a stratégia a meglévő csatlakoztatott horgonyokhasználatával megkísérli megtalálni a horgonyokat. Ez a stratégia jelenleg csak a NearAnchor vagy az azonosítók tulajdonságaival együtt engedélyezett. Az azonosítók tulajdonság használata esetén szükség van arra, hogy ugyanabban a munkamenetben a felhasználónak előzőleg olyan horgony (ka) t kell megadnia, amelyen már létrejöttek az azonosítók tömbben megadott azonosítók.

A LocateStrategy és a AnchorLocateCriteria tulajdonságainak érvényes kombinációi

A rendszer jelenleg nem teszi lehetővé a stratégia és a AnchorLocateCriteria tulajdonságainak kombinációját. A következő táblázat a megengedett kombinációkat tartalmazza:

Tulajdonság AnyStrategy Kapcsolat VisualInformation
Azonosítók
NearAnchor ✓ (az alapértelmezett érték a kapcsolat)
NearDevice

Következő lépések

A AnchorLocateCriteria osztály használatával további példákat talál az Azure térbeli horgonyokat használó horgonyok létrehozásához és megkereséséhez .