XRInputSourceArray

Интерфейс XRInputSourceArray представляет собой динамический список источников ввода WebXR и используется в качестве возвращаемого значения свойства XRSession inputSources. Каждый элемент — это XRInputSource, представляющий одно устройство ввода, подключенное к системе WebXR.

Помимо доступа к источникам ввода в списке с помощью стандартной нотации массивов (т. е. с помощью индексов в квадратных скобках), доступны методы, позволяющие использовать итераторы, а также метод forEach().

Следующие свойства доступны для объектов XRInputSourceArray.

length Только для чтения Экспериментальная

Число объектов XRInputSource в списке.

Следующие методы доступны для объектов XRInputSourceArray. Также можно использовать возможности типа Symbol.

entries() Экспериментальная

Возвращает iterator, который можно использовать для просмотра списка пар ключ-значение в списке. Каждый возвращаемый элемент представляет собой массив, в котором первое значение — индекс, а второе — XRInputSource по этому индексу.

forEach() Экспериментальная

Проходит по каждому элементу в списке в порядке от первого ко второму.

keys() Экспериментальная

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

values() Экспериментальная

Возвращает iterator, который можно использовать для обхода всех значений в списке. Каждый элемент — отдельный объект XRInputSource.

Помимо этих методов, можно использовать нотацию массивов для доступа к элементам списка по индексу. Например, фрагмент кода ниже вызывает функцию handleInput(), передавая в неё первый элемент в списке источников ввода, если список не пустой.

let sources = xrSession.inputSources;
if (sources.length > 0) {
  handleInput(sources[0]);
}