AccessibilityNode
класс в UnityEngine.Accessibility
Выполнено в:UnityEngine.AccessibilityModule
Описание
Узел в AccessibilityHierarchy, представляющий визуальный элемент, например, элемент UI или элемент, являющийся частью вашей игры, который должен быть доступен для программы для чтения экрана.
Узлы доступности представляют собой структуры данных, которые позволяют экранным читателям фокусировать, объявлять и выполнять действия пользователя на них. Они представляют визуальные элементы в приложении, но существуют и функционируют независимо от соответствующих визуальных элементов. Изменения в визуальном представлении элемента, такие как его видимость, порядок слоев или координаты экрана, не влияют на представляющий его узел доступности.
Чтобы создать узел доступности, вызовите AccessibilityHierarchy.AddNode в иерархии, в которую вы хотите добавить узел. При вызове этого метода вы можете по желанию указать метку узла и родителя в иерархии. Этот метод возвращает созданный узел. Используйте его для установки различных атрибутов и определения идентичности и функциональных возможностей узла.
Когда активен экранный читатель, пользователи могут перемещаться и взаимодействовать с приложением с помощью определенных жестов или команд, которые легче выполнить и предотвратить случайные действия. Для этой цели на мобильных платформах стандартные жесты, такие как нажатие или перемещение пальцем, не работают или выполняют различные действия, когда экранный читатель включен. Жесты и команды экранного читателя могут различаться в зависимости от платформы, но они вызывают одни и те же события доступности. Примеры жестов и команд на различных платформах см. в разделе Мероприятия на этой странице. Подписывайтесь на эти события, чтобы обнаруживать действия пользователя и соответствующим образом реагировать на них.
Эти APIs в настоящее время поддерживаются на следующих платформах:
- RuntimePlatform.Android — начиная с Android 8.0 (API уровень 26)
- RuntimePlatform.IPhonePlayer
- RuntimePlatform.OSXPlayer
- RuntimePlatform.WindowsPlayer
Дополнительные ресурсы:
- Доступность мобильных приложений
- Пример проекта с использованием доступности APIs
- TalkBack жесты на Android
- VoiceOver жесты на iPhone
- Команды Диктора на Windows
- VoiceOver команды на Mac
Свойства
| Свойство | Описание |
|---|---|
| allowsDirectInteraction | Разрешает ли узел доступности прямое сенсорное взаимодействие при активном экранном читателе. |
| children | Дочерние узлы в иерархии доступности. |
| frame | Ограничивающий прямоугольник узла доступности в координатах экрана. |
| frameGetter | Делегат, который рассчитывает рамку узла доступности, автоматически поддерживая ее в текущем состоянии. |
| hint | Дополнительные указания или контекст для взаимодействия с узлом доступности. |
| id | Уникальный идентификатор узла доступности. |
| isActive | Обнаруживается ли узел доступности для программ чтения экрана. Значение по умолчанию — true. |
| isFocused | Находится ли узел доступности в настоящее время в фокусе программы чтения экрана. |
| label | Краткое описание узла доступности. |
| parent | Родительский узел в иерархии доступности. |
| role | Тип элемента пользовательского интерфейса, который представляет узел доступности. |
| state | Состояние визуального элемента, представленного узлом доступности. |
| value | Значение визуального элемента, который представляет узел доступности. |
Открытые методы
| Метод | Описание |
|---|---|
| GetHashCode | Хеш, используемый для сравнений. |
| ToString | Предоставляет строку отладки. |
Мероприятия
| Мероприятие | Описание |
|---|---|
| decremented | Событие, вызванное, когда пользователь выполняет действие "декремент", когда фокус находится на узле доступности. |
| dismissed | Событие, вызванное, когда пользователь выполняет действие «отмена», когда фокус находится на узле доступности. |
| focusChanged | Событие, вызванное в основном потоке, когда узел доступности получает или теряет фокус экранного чтения. |
| incremented | Событие, вызванное, когда пользователь выполняет действие "приращения", когда фокус находится на узле доступности. |
| invoked | Событие, вызванное, когда пользователь выполняет действие «активировать», когда фокус находится на узле доступности. |
| scrolled | Событие, вызванное, когда пользователь выполняет действие "прокрутки", когда фокус находится на узле доступности. |
| selected | Используйте AccessibilityNode.invoked вместо этого. |