VideoEncoder: метод isConfigSupported() static

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в посвященных веб-воркерах.

Статический метод isConfigSupported() интерфейса VideoEncoder проверяет, можно ли успешно настроить VideoEncoder с заданной конфигурацией.

Синтаксис

VideoEncoder.isConfigSupported(config)

Параметры

config: Объект словаря, принимаемый VideoEncoder.configure

Возвращаемое значение

A Promise, который разрешается объектом, содержащим следующие члены:

supported: Логическое значение, равное true, если заданная конфигурация поддерживается кодером.
config: Копия заданной конфигурации со всеми полями, распознанными кодером.

Исключения

TypeError: Выбрасывается, если предоставленный config недействителен; то есть, если он не содержит необходимых значений (например, пустое поле codec) или содержит недопустимые значения (например, отрицательное значение width)

Примеры

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

const codecs = [
  "avc1.420034",
  "hvc1.1.6.L123.00",
  "vp8",
  "vp09.00.10.08",
  "av01.0.04M.08",
];
const accelerations = ["prefer-hardware", "prefer-software"];

const configs = [];
for (const codec of codecs) {
  for (const acceleration of accelerations) {
    configs.push({
      codec,
      hardwareAcceleration: acceleration,
      width: 1280,
      height: 720,
      bitrate: 2_000_000,
      bitrateMode: "constant",
      framerate: 30,
      not_supported_field: 123,
    });
  }
}

for (const config of configs) {
  const support = await VideoEncoder.isConfigSupported(config);
  console.log(
    `VideoEncoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

Спецификации

Спецификация
WebCodecs # dom-videoencoder-isconfigsupported

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`isConfigSupported_static`	94	94	130	80	16.4	94	Нет	66	16.4	17.0	94

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VideoEncoder/isConfigSupported_static