AudioTrackList

Limited availability

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

Giao diện AudioTrackList được dùng để biểu diễn danh sách các rãnh âm thanh có trong một phần tử media HTML nhất định, trong đó mỗi rãnh được biểu diễn bởi một đối tượng AudioTrack riêng trong danh sách.

Lấy một thể hiện của đối tượng này bằng HTMLMediaElement.audioTracks. Có thể truy cập từng rãnh riêng lẻ bằng cú pháp mảng.

EventTarget AudioTrackList

Thuộc tính thể hiện

Giao diện này cũng kế thừa các thuộc tính từ giao diện cha của nó, EventTarget.

length Read only

Số lượng rãnh trong danh sách.

Phương thức thể hiện

Giao diện này cũng kế thừa các phương thức từ giao diện cha của nó, EventTarget.

getTrackById()

Trả về AudioTrack được tìm thấy trong AudioTrackListid khớp với chuỗi đã chỉ định. Nếu không tìm thấy kết quả khớp, null sẽ được trả về.

Sự kiện

addtrack

Được kích hoạt khi một rãnh âm thanh mới được thêm vào phần tử media.

change

Được kích hoạt khi một rãnh được bật hoặc tắt.

removetrack

Được kích hoạt khi một rãnh âm thanh bị xóa khỏi phần tử media.

Ghi chú sử dụng

Ngoài việc có thể truy cập trực tiếp các rãnh âm thanh có trên một phần tử media, AudioTrackList còn cho phép bạn thiết lập trình xử lý sự kiện cho các sự kiện addtrackremovetrack, để bạn có thể phát hiện khi các rãnh được thêm vào hoặc bị xóa khỏi luồng của phần tử media. Hãy xem các sự kiện addtrackremovetrack để biết chi tiết và ví dụ.

Ví dụ

Lấy danh sách rãnh âm thanh của phần tử media

Để lấy AudioTrackList của một phần tử media, hãy dùng thuộc tính audioTracks của nó.

js
const audioTracks = document.querySelector("video").audioTracks;

Theo dõi thay đổi số lượng rãnh

Trong ví dụ này, chúng ta có một ứng dụng hiển thị thông tin về số lượng kênh hiện có. Để giữ thông tin luôn cập nhật, trình xử lý cho các sự kiện addtrackremovetrack được thiết lập.

js
audioTracks.onaddtrack = updateTrackCount;
audioTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = audioTracks.length;
  drawTrackCountIndicator(trackCount);
}

Thông số kỹ thuật

Specification
HTML
# audiotracklist-and-videotracklist-objects

Khả năng tương thích với trình duyệt