Основные сведения о классе AnchorLocateCriteria
В этой статье вы узнаете о различных параметрах, которые можно использовать при запросе привязки. Мы рассмотрим класс AnchorLocateCriteria, его параметры и их допустимые сочетания.
Критерии поиска привязки
Класс AnchorLocateCriteria позволяет запрашивать в службе привязки, созданные ранее. Один объект AnchorLocateCriteria может использоваться для наблюдателя в любое время. Каждый объект AnchorLocateCriteria должен содержать только одно из следующих свойств: Identifiers, NearAnchor или NearDevice. При необходимости можно задать дополнительные свойства, такие как Strategy, BypassCache и RequestedCategories.
Свойства
Определите в наблюдателе только одно из следующих свойств:
Identifiers
Значение по умолчанию: пустой массив строк
С помощью свойства Identifiers можно определить список идентификаторов для привязок, которые вы хотите найти. Идентификаторы привязок изначально возвращаются после успешного создания привязок. Когда указаны идентификаторы, AnchorLocateCriteria позволяет запрашиваться только привязки с совпадающими идентификаторами привязок. Это свойство указывается с помощью массива строк.
NearAnchor
Значение по умолчанию: не задано
С помощью свойства NearAnchor можно указать, что AnchorLocateCriteria должен запрашивать привязки только в пределах определенного расстояния от выбранной привязки. Выбранную привязку необходимо указать как исходную. Вы также можете указать желаемое расстояние от исходной привязки и максимальное число возвращаемых привязок, чтобы дополнительно ограничить поиск. Это свойство определяется с помощью объекта NearAnchorCriteria.
NearDevice
Значение по умолчанию: не задано
С помощью свойства NearDevice можно указать, что AnchorLocateCriteria должен запрашивать только привязки, близкие к физическому местонахождению устройства. Все включенные датчики будут использоваться для обнаружения привязок рядом с вашим устройством. Чтобы улучшить поиск привязок, необходимо настроить SensorCapabilities так, чтобы обеспечить сеансу доступ ко всем соответствующим датчикам. Дополнительные сведения о настройке и использовании этого свойства см. в статьях Грубая локализация. Пространственные привязки Azure | Документация Майкрософт и Создание и обнаружение привязок с помощью грубой локализации в C#, Objective-C, Swift, Java, C++/NDK и C++/WinRT. Это свойство определяется с помощью объекта NearDeviceCriteria.
Дополнительные свойства
BypassCache
Значение по умолчанию: false
Созданная или обнаруженная в сеансе привязка также сохраняется в кэше. Если этому свойству присвоено значение false, все последующие запросы в том же сеансе будут возвращать кэшированное значение. Запрос в службу ASA не отправляется.
RequestedCategories
Значение по умолчанию: Properties | Spatial
Это свойство используется для определения того, какие данные возвращаются из запроса, с помощью AnchorLocateCriteria. Значение по умолчанию возвращает и свойства, и пространственные данные, но не следует его изменять, если вам нужны и свойства, и пространственные данные. Это свойство можно указать с помощью перечисления AnchorDataCategory.
| Значение перечисления AnchorDataCategory | Возвращаемые данные |
|---|---|
| None | Никакие данные не возвращаются |
| Свойства | Возвращаются свойства привязки, включая AppProperties. |
| Отслеживание | Возвращаются пространственные сведения о привязке. |
Стратегия
Значение по умолчанию: AnyStrategy
Свойство Strategy определяет, как должны располагаться привязки. Свойство Strategy можно указать, используя перечисление LocateStrategy.
| Значение перечисления LocateStrategy | Description |
|---|---|
| AnyStrategy | Эта стратегия позволяет системе использовать комбинации стратегий VisualInformation и Relationship для поиска привязок. |
| VisualInformation | Эта стратегия ищет привязки, сопоставляя визуальные сведения из текущего окружения с визуальными элементами привязок. Визуальный элемент привязки — это визуальная информация, которая связана с привязкой в текущий момент. Обычно эта визуальная информация не собирается во время создания привязки. Сейчас эту стратегия можно использовать только со свойствами NearDevice и Identifiers. |
| Отношение | Эта стратегия ищет привязки, используя уже существующие подключенные привязки. Сейчас эту стратегия можно использовать только со свойствами NearAnchor и Identifiers. При использовании со свойством Identifiers необходимо, чтобы в том же сеансе пользователь заранее разместил привязку или привязки с уже установленными связями с привязками, идентификаторы которых указаны в массиве Identifiers. |
Допустимые сочетания свойств LocateStrategy и AnchorLocateCriteria
Не все сочетания свойств Strategy и AnchorLocateCriteria допускаются системой в данный момент. В следующей таблице показаны допустимые комбинации:
| Свойство | AnyStrategy | Отношение | VisualInformation |
|---|---|---|---|
| Identifiers | ✓ | ✓ | ✓ |
| NearAnchor | ✓ (по умолчанию используется связь) | ✓ | |
| NearDevice | ✓ | ✓ |
Следующие шаги
Дополнительные примеры использования класса AnchorLocateCriteria см. в статье Создание и поиск привязок с помощью пространственных привязок Azure.