MediaStreamTrack: Eigenschaft contentHint

Ein String mit einem der folgenden Werte:

""

Es wurde kein contentHint gesetzt.

"speech"

Der Track sollte als Sprachdaten enthalten angesehen werden. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "audio" sein.

"speech-recognition"

Der Track sollte so behandelt werden, als ob er Daten für maschinelle Spracherkennung enthält. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "audio" sein.

"music"

Der Track sollte als Musik enthalten angesehen werden. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "audio" sein.

"motion"

Der Track sollte so behandelt werden, als ob er Video enthält, bei dem Bewegung wichtig ist. Zum Beispiel Webcam-Videos, Filme oder Videospiele. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "video" sein.

"detail"

Der Track sollte so behandelt werden, als ob Video-Details besonders wichtig sind. Zum Beispiel Präsentationen oder Webseiten mit Textinhalten, Gemälden oder Strichzeichnungen. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "video" sein.

"text"

Der Track sollte so behandelt werden, als ob Video-Details besonders wichtig sind und dass häufig scharfe Kanten und Bereiche mit gleichmäßiger Farbe vorkommen können. Zum Beispiel Präsentationen oder Webseiten mit Textinhalten. Wenn Sie diesen Wert setzen, muss der Wert von MediaStreamTrack.kind "video" sein.

Diese Funktion nimmt einen Stream und einen contentHint-Wert und wendet den Hinweis auf jeden Track an. Sehen Sie sich das vollständige Beispiel hier an, das zeigt, wie unterschiedliche contentHint-Werte beeinflussen, wie die Tracks angezeigt werden.

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