MediaStream: getTrackById() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來,它已在瀏覽器中提供。

getTrackById()MediaStream 介面的一個方法,它返回一個 MediaStreamTrack 物件,該物件代表具有指定 ID 字串的軌道。如果不存在具有指定 ID 的軌道,此方法將返回 null

語法

js
getTrackById(id)

引數

id

一個標識要返回的軌道的字串。

返回值

如果找到一個 MediaStreamTrack.id 與指定的 id 字串匹配的軌道,則返回該 MediaStreamTrack 物件。否則,返回值是 null

示例

此示例透過將主音訊軌道的音量降低到 50% 並然後啟用解說音軌來啟用影片的解說音軌。

此示例假定兩個軌道的 ID 是已知的(例如,從先前呼叫 MediaStreamTrack.id 獲得的)。在實際應用中,您可能需要在首次獲取流時儲存這些 ID,因為它們是在瀏覽器中隨機生成的。

js
const primaryAudioTrack = stream.getTrackById(
  "69f8520f-d94e-43f0-8a7c-77b1774f3b8f",
);
const commentaryTrack = stream.getTrackById(
  "b5410643-2549-491e-b0f7-f08a4ebe54b8",
);

primaryAudioTrack.applyConstraints({ volume: 0.5 });
commentaryTrack.enabled = true;

規範

規範
媒體捕獲和流
# dom-mediastream-gettrackbyid

瀏覽器相容性

另見