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 值如何改变轨道的显示方式。

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