Az AnchorLocateCriteria osztály ismertetése
Ebben a cikkben megismerheti a horgony lekérdezése során használható különböző beállításokat. Átmegyünk az AnchorLocateCriteria osztályon, annak beállításain és érvényes kombinációin.
Horgonykeresési feltételek
Az AnchorLocateCriteria osztály segítségével lekérdezheti a szolgáltatást a korábban létrehozott horgonyokhoz. Figyelőnként bármikor használhat egy AnchorLocateCriteria objektumot. Minden AnchorLocateCriteria objektumnak pontosan az alábbi tulajdonságok egyikét kell tartalmaznia: Azonosítók, NearAnchor vagy NearDevice. Igény szerint további tulajdonságok is beállíthatók, például a Stratégia, a BypassCache és a RequestedCategories .
Properties
Definiálja pontosan az alábbi tulajdonságok egyikét a figyelőben:
Identifiers
Alapértelmezett érték: üres sztringtömb
Azonosítók használatával meghatározhatja a megkeresni kívánt horgonyazonosítók listáját. A horgonyazonosítók a sikeres horgonylétrehozás után eleinte visszakerülnek Önhöz. Az azonosítók megadása esetén az AnchorLocateCriteria a kért horgonyok készletét az egyező horgonyazonosítókkal rendelkező horgonyokra korlátozza. Ez a tulajdonság egy sztringtömb használatával van megadva.
NearAnchor
Alapértelmezett érték: nincs beállítva
A NearAnchor használatával megadhatja, hogy az AnchorLocateCriteria a kért horgonyok készletét a kiválasztott horgonytól a kívánt távolságon belülre korlátozza. Ezt a kiválasztott horgonyt forráshorgonyként kell megadnia. A keresés további korlátozásához beállíthatja a forráshorgonytól és a visszaadott horgonyok maximális számától való távolságot is. Ez a tulajdonság egy NearAnchorCriteria objektummal van megadva.
NearDevice
Alapértelmezett érték: nincs beállítva
A NearDevice használatával megadhatja, hogy az AnchorLocateCriteria a kért horgonyokat az eszköz fizikai helyéhez közelire korlátozza. Az engedélyezett érzékelők segítenek az eszköz körüli horgonyok felderítésében. A horgonyok megtalálásának legjobb esélye érdekében konfigurálja a SensorCapa képességeket, hogy hozzáférést biztosítson a munkamenethez az összes megfelelő érzékelőhöz. A tulajdonság beállításával és használatával kapcsolatos további információkért lásd: Durva áthelyezés – Azure Spatial Anchors | A Microsoft Docs és a horgonyok létrehozása és megkeresése durva áthelyezésselC#, Objective-C, Swift, Java, C++/NDK, C++/WinRT nyelven. Ez a tulajdonság egy NearDeviceCriteria objektummal van megadva.
További tulajdonságok
BypassCache
Alapértelmezett érték: hamis
Amikor egy munkamenetben létrehozott vagy talált horgonyt, az is a gyorsítótárban lesz tárolva. Ha ez a tulajdonság hamis értékre van állítva, az ugyanabban a munkamenetben lévő későbbi lekérdezések a gyorsítótárazott értéket fogják visszaadni. Nincs kérés az ASA szolgáltatáshoz.
RequestedCategories
Alapértelmezett érték: Tulajdonságok | Térbeli
Ez a tulajdonság határozza meg, hogy a rendszer milyen adatokat ad vissza egy lekérdezésből az AnchorLocateCriteria használatával. Az alapértelmezett érték a tulajdonságokat és a térbeli adatokat is visszaadja, ez nem módosítható, ha a tulajdonságok és a térbeli adatok is szükségesek. Ez a tulajdonság az AnchorDataCategory enumerálással adható meg.
| AnchorDataCategory Enum érték | Visszaadott adatok |
|---|---|
| None | Nincs visszaadott adat |
| Properties | A rendszer visszaadja a horgonytulajdonságokat, beleértve az AppProperties tulajdonságot is. |
| Spatial | A rendszer térbeli információkat ad vissza egy horgonyról. |
Stratégia
Alapértelmezett érték: AnyStrategy
A stratégia továbbá meghatározza a horgonyok elhelyezését. A Strategy tulajdonság egy LocateStrategy enum használatával adható meg.
| LocateStrategy Enum Value | Leírás |
|---|---|
| AnyStrategy | Ez a stratégia lehetővé teszi a rendszer számára, hogy VisualInformation és Kapcsolat stratégiák kombinációit használja a horgonyok megtalálásához. |
| VisualInformation | Ez a stratégia úgy próbálja megtalálni a horgonyokat, hogy a jelenlegi környezet vizuális információit a horgony vizuális lábnyomának megfelelővel egyezteti. A horgonyok vizuális lábnyoma a horgonyhoz jelenleg társított vizualizációs információkra utal. Ezek a vizualizációs információk általában, de nem kizárólag a horgony létrehozásakor gyűjtenek. Ez a stratégia jelenleg csak a NearDevice vagy az Identifiers tulajdonsággal együtt engedélyezett. |
| Kapcsolat | Ez a stratégia a meglévő csatlakoztatott horgonyok használatával próbál horgonyokat keresni. Ez a stratégia jelenleg csak a NearAnchor vagy az Identifiers tulajdonsággal együtt engedélyezett. Az Azonosítók tulajdonság használatakor szükséges, hogy ugyanabban a munkamenetben a felhasználó korábban egy olyan horgonyt (horgonyt) helyezzen el, amelynek azonosítóit az Azonosítók tömbben adhatók meg. |
A LocateStrategy és az AnchorLocateCriteria tulajdonságok érvényes kombinációi
A rendszer jelenleg nem engedélyezi a Stratégia és az AnchorLocateCriteria tulajdonságok összes kombinációját. Az alábbi táblázat az engedélyezett kombinációkat mutatja be:
| Property | AnyStrategy | Kapcsolat | VisualInformation |
|---|---|---|---|
| Identifiers | ✓ | ✓ | ✓ |
| NearAnchor | ✓ (alapértelmezés szerint Kapcsolat) | ✓ | |
| NearDevice | ✓ | ✓ |
Következő lépések
Az AnchorLocateCriteria osztályt használó további példákért tekintse meg a horgonyok Azure Spatial Anchors használatával történő létrehozását és megkeresését.