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

规范

浏览器兼容性