MediaStreamTrack: contentHint プロパティ

値

以下のいずれかの値を持つ文字列です。

""

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 値を受け取り、各トラックにヒントを適用します。完全な例はこちらを参照してください。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 属性に対応していません");
    }
  });
}

仕様書

ブラウザーの互換性