AudioTrackList: sự kiện addtrack

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sự kiện addtrack được kích hoạt khi một rãnh được thêm vào một AudioTrackList.

Cú pháp

Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt một thuộc tính trình xử lý sự kiện.

addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

Thuộc tính sự kiện

TrackEvent dựa trên Event, vì vậy các thuộc tính của Event cũng khả dụng trên các đối tượng TrackEvent.

track Read only: Đối tượng rãnh DOM mà sự kiện tham chiếu tới. Nếu khác null, đây luôn là một đối tượng thuộc một trong các kiểu rãnh media sau: AudioTrack, VideoTrack hoặc TextTrack).

Sự kiện addtrack được gọi bất cứ khi nào một rãnh mới được thêm vào phần tử media mà các rãnh âm thanh của phần tử đó được biểu diễn bởi đối tượng AudioTrackList. Điều này xảy ra khi các rãnh được thêm vào phần tử tại thời điểm media lần đầu được gắn vào phần tử; một sự kiện addtrack sẽ xảy ra cho mỗi rãnh âm thanh trong tài nguyên media.

Sự kiện này không thể bị hủy và không nổi bọt.

Trường hợp sử dụng

Bạn có thể dùng sự kiện này để phản ứng khi một rãnh âm thanh mới trở nên khả dụng. Ví dụ, bạn có thể muốn cập nhật các thành phần giao diện để cho phép người dùng chọn rãnh âm thanh mới.

Ví dụ

Sử dụng addEventListener():

const videoElement = document.querySelector("video");

videoElement.audioTracks.addEventListener("addtrack", (event) => {
  console.log(`Audio track: ${event.track.label} added`);
});

Sử dụng thuộc tính trình xử lý sự kiện onaddtrack:

const videoElement = document.querySelector("video");

videoElement.audioTracks.onaddtrack = (event) => {
  console.log(`Audio track: ${event.track.label} added`);
};