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.
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.
lengthRead 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 trongAudioTrackListcóidkhớp với chuỗi đã chỉ định. Nếu không tìm thấy kết quả khớp,nullsẽ đượ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 addtrack và removetrack, để 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 addtrack và removetrack để 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ó.
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 addtrack và removetrack được thiết lập.
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> |