XRInputSource: свойство profiles

Только для чтения XRInputSource свойство profiles возвращает массив строк, каждая из которых описывает профиль конфигурации для источника ввода. Строки профилей перечислены в порядке убывания специфичности, при этом наиболее специфичный профиль перечисляется первым.

Массив строк, каждая из которых описывает один профиль конфигурации для устройства ввода, представленного объектом XRInputSource. Каждый профиль ввода задаёт предпочтительное визуальное представление и поведение источника ввода.

Имя профиля ввода — это строка, описывающая визуальное представление и поведение, которое может использовать источник ввода. Каждая строка:

• Не содержит пробелов; вместо этого слова разделены дефисами ("-")
• Если платформа это поддерживает, могут быть предоставлены идентификаторы поставщика и продукта USB, но полагаться на них нельзя
• Не однозначно идентифицирует конкретное устройство; вместо этого оно идентифицирует конфигурацию, которую устройство способно использовать
• Не предоставляет информацию о ручке устройства, если применимо

Регистр профилей WebXR ввода WebXR Input Profiles Registry используется разработчиками устройств и браузеров, чтобы обеспечить, что данное устройство будет сообщать те же самые строки профиля независимо от используемого браузера или другого пользовательского агента.

Следующие имена профилей ввода являются общими и могут использоваться в качестве резервных вариантов, которые описывают устройства самым общим образом.

• generic-button
• generic-hand-select-grasp
• generic-hand-select
• generic-hand
• generic-touchpad
• generic-touchscreen
• generic-trigger-squeeze-thumbstick
• generic-trigger-squeeze-touchpad-thumbstick
• generic-trigger-squeeze-touchpad
• generic-trigger-squeeze
• generic-trigger-thumbstick
• generic-trigger-touchpad-thumbstick
• generic-trigger-touchpad
• generic-trigger

Список в profiles упорядочен в обратном порядке специфичности; то есть, самое точное описание идёт первым, а наименее точное — последним. Первая запись в списке обычно указывает на точную модель контроллера или модель, с которой контроллер совместим.

Например, запись 0 в profiles для контроллера Oculus Touch — oculus-touch. Следующая запись — generic-trigger-squeeze-thumbstick, указывающая на общее устройство с триггером, контролем сжатия и джойстиком. Хотя контроллер Oculus Touch на самом деле имеет сенсорную панель, а не джойстик, общее описание является "достаточно точным", чтобы детали в профиле, соответствующем имени, позволили интерпретировать контроллер полезно.

inputSource.profiles;
// ['oculus-touch', 'generic-trigger-squeeze-thumbstick']

• WebXR Device API
• Входы и источники ввода