MediaStreamTrack: sự kiện ended
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Sự kiện ended của giao diện MediaStreamTrack được kích hoạt khi việc phát lại hoặc phát trực tuyến đã dừng vì đã đạt đến cuối phương tiện hoặc vì không còn dữ liệu nào nữa.
Sự kiện này không thể hủy và không nổi bọt.
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("ended", (event) => { })
onended = (event) => { }
Loại sự kiện
Một Event chung.
Ghi chú sử dụng
Các sự kiện ended được kích hoạt khi nguồn của track luồng phương tiện vĩnh viễn ngừng gửi dữ liệu trên luồng. Có nhiều cách khác nhau để điều này xảy ra, bao gồm:
- Không còn dữ liệu nào để gửi.
- Người dùng đã thu hồi quyền cần thiết để gửi dữ liệu.
- Phần cứng tạo dữ liệu nguồn đã bị tháo ra hoặc đẩy ra.
- Một peer từ xa đã vĩnh viễn ngừng gửi dữ liệu.
- Trường hợp duy nhất track kết thúc nhưng sự kiện
endedkhông được kích hoạt là khi gọiMediaStreamTrack.stop.
Tạm dừng phương tiện không tạo ra sự kiện ended.
Ví dụ
Ví dụ này thiết lập một trình xử lý sự kiện cho sự kiện ended, thay đổi một biểu tượng trên màn hình để cho biết rằng track không còn hoạt động.
track.addEventListener("ended", () => {
let statusElem = document.getElementById("status-icon");
statusElem.src = "/images/stopped-icon.png";
});
Bạn cũng có thể thiết lập trình xử lý sự kiện bằng thuộc tính onended:
track.onended = () => {
let statusElem = document.getElementById("status-icon");
statusElem.src = "/images/stopped-icon.png";
};
Đặc tả kỹ thuật
| Specification |
|---|
| Media Capture and Streams # dom-mediastreamtrack-onended |