VideoTrack
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Giao diện VideoTrack đại diện cho một video track đơn lẻ từ phần tử <video>.
Cách sử dụng phổ biến nhất để truy cập đối tượng VideoTrack là bật/tắt thuộc tính selected của nó để làm cho nó trở thành video track hoạt động của phần tử <video>.
Thuộc tính phiên bản
selected-
Giá trị Boolean kiểm soát xem video track có đang hoạt động hay không. Chỉ có một video track duy nhất có thể hoạt động tại bất kỳ thời điểm nào, vì vậy việc đặt thuộc tính này thành
truecho một track trong khi track khác đang hoạt động sẽ làm cho track kia không hoạt động. idRead only-
Chuỗi xác định duy nhất track trong media. ID này có thể được dùng để xác định vị trí một track cụ thể trong danh sách video track bằng cách gọi
VideoTrackList.getTrackById(). ID cũng có thể được dùng làm phần fragment của URL nếu media hỗ trợ tìm kiếm theo media fragment theo Media Fragments URI specification. kindRead only-
Chuỗi chỉ định danh mục mà track thuộc về. Ví dụ, video track chính sẽ có
kindlà"main". labelRead only-
Chuỗi cung cấp nhãn có thể đọc được cho track. Ví dụ, một track có
kindlà"sign"có thể cólabellà"A sign-language interpretation". Chuỗi này rỗng nếu không có nhãn nào được cung cấp. languageRead only-
Chuỗi chỉ định ngôn ngữ chính của video track, hoặc chuỗi rỗng nếu không rõ. Ngôn ngữ được chỉ định dưới dạng BCP 47 language tag như
"en-US"hoặc"pt-BR". sourceBufferRead only-
SourceBufferđã tạo ra track. Trả về null nếu track không được tạo bởiSourceBufferhoặcSourceBufferđã bị xóa khỏi thuộc tínhMediaSource.sourceBufferscủa nguồn media cha.
Ghi chú sử dụng
Để lấy VideoTrack cho một phần tử media nhất định, hãy sử dụng thuộc tính videoTracks của phần tử, trả về đối tượng VideoTrackList từ đó bạn có thể lấy các track riêng lẻ có trong media:
const el = document.querySelector("video");
const tracks = el.videoTracks;
Sau đó bạn có thể truy cập các track riêng lẻ của media bằng cú pháp mảng hoặc các hàm như forEach().
Ví dụ đầu tiên này lấy video track đầu tiên trên media:
const firstTrack = tracks[0];
Ví dụ tiếp theo quét qua tất cả các video track của media, kích hoạt video track đầu tiên có ngôn ngữ ưa thích của người dùng (lấy từ biến userLanguage).
for (const track of tracks) {
if (track.language === userLanguage) {
track.selected = true;
break;
}
}
language được chỉ định dưới dạng BCP 47 language tag hợp lệ, ví dụ "en-US" cho tiếng Anh Mỹ.
Thông số kỹ thuật
| Specification |
|---|
| HTML> # videotrack> |