VideoDecoder: метод configure()

Метод configure() интерфейса VideoDecoder добавляет в очередь сообщение управления, чтобы настроить видеодекодер для декодирования фрагментов.

config

Объект, содержащий следующие члены:

codec

Строка, содержащая допустимую строку кодека. Подробности о построении строки кодека см. в "параметре кодеков".

description Необязательно

ArrayBuffer, TypedArray или DataView, содержащий последовательность байтов, специфичных для кодека, обычно называемую extradata.

codedWidth Необязательно

Целое число, представляющее ширину VideoFrame в пикселях, включая любые невидимые отступы, до любых корректировок соотношения.

codedHeight Необязательно

Целое число, представляющее высоту VideoFrame в пикселях, включая любые невидимые отступы, до любых корректировок соотношения.

displayAspectWidth Необязательно

Целое число, представляющее горизонтальную размерность VideoFrame в пикселях при отображении.

displayAspectHeight Необязательно

Целое число, представляющее вертикальную размерность VideoFrame в пикселях при отображении.

colorSpace Необязательно

Объект, представляющий VideoColorSpace, содержащий следующие члены:

primaries

Строка, представляющая цветовой диапазон видеообразца. Одна из:

• "bt709"
• "bt470bg"
• "smpte170m"

transfer

Строка, представляющая характеристики передачи. Одна из:

• "bt709"
• "smpte170m"
• "iec61966-2-1"

matrix

Строка, представляющая коэффициент матрицы. Одна из:

• "rgb"
• "bt709"
• "bt470bg"
• "smpte170m"

hardwareAcceleration Необязательно

Подсказка о методе аппаратного ускорения. Одна из:

• "no-preference"
• "prefer-hardware"
• "prefer-software"

optimizeForLatency Необязательно

Булево значение. Если true , это подсказка о том, что выбранный декодер должен быть оптимизирован для минимизации количества EncodedVideoChunk объектов, которые должны быть декодированы до вывода VideoFrame.

Ничего (undefined).

TypeError

Выбрасывается, если предоставленный config недопустим.

InvalidStateError DOMException

Выбрасывается, если состояние state равно "closed".

NotSupportedError DOMException

Выбрасывается, если предоставленный config допустим, но пользовательский агент не может предоставить кодек, который может декодировать этот профиль.

В следующем примере создается новый VideoDecoder и настраивается он с кодеком "vp8", шириной codedWidth 640 пикселей и высотой codedHeight 480 пикселей.

const init = {
  output: handleFrame,
  error: (e) => {
    console.log(e.message);
  },
};

const config = {
  codec: "vp8",
  codedWidth: 640,
  codedHeight: 480,
};

let decoder = new VideoDecoder(init);
decoder.configure(config);