MediaStreamTrack: свойство contentHint

Свойство contentHint интерфейса MediaStreamTrack — это строка, которая указывает на тип содержимого, которое содержит трек. Допустимые значения зависят от значения свойства MediaStreamTrack.kind.

Строка с одним из следующих значений:

""

Не задано ни одного contentHint.

"speech"

Трек должен обрабатываться как содержащий данные речи. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "audio".

"speech-recognition"

Трек должен обрабатываться как содержащий данные для целей распознавания речи машиной. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "audio".

"music"

Трек должен обрабатываться как содержащий музыку. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "audio".

"motion"

Трек должен обрабатываться как содержащий видео, где движение является важным. Например, видео с веб-камеры, фильмы или видеоигры. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "video".

"detail"

Трек должен обрабатываться как содержащий видео с важными деталями. Например, презентации или веб-страницы с текстовым содержимым, рисование или линейная графика. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "video".

"text"

Трек должен обрабатываться как содержащий видео с важными деталями, и часто могут встречаться значительные резкие края и области с одинаковым цветом. Например, презентации или веб-страницы с текстовым содержимым. При установке этого значения значение свойства MediaStreamTrack.kind должно быть "video".

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

function setVideoTrackContentHints(stream, hint) {
  const tracks = stream.getVideoTracks();
  tracks.forEach((track) => {
    if ("contentHint" in track) {
      track.contentHint = hint;
      if (track.contentHint !== hint) {
        console.error(`Invalid video track contentHint: "${hint}"`);
      }
    } else {
      console.error("MediaStreamTrack contentHint attribute not supported");
    }
  });
}