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 attribute not supported");
    }
  });
}

規範

瀏覽器相容性