MediaStreamTrack: sự kiện mute
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2018.
Sự kiện mute được gửi đến một MediaStreamTrack khi nguồn của track tạm thời không thể cung cấp dữ liệu phương tiện.
Khi track một lần nữa có thể tạo ra đầu ra phương tiện, một sự kiện unmute được gửi.
Trong thời gian giữa sự kiện mute và sự kiện unmute, giá trị của thuộc tính muted của track là true.
Note:
Điều kiện mà hầu hết mọi người nghĩ là "tắt tiếng" (tức là trạng thái tắt tiếng track do người dùng chuyển đổi) thực tế được quản lý bằng thuộc tính MediaStreamTrack.enabled, không có sự kiện nào cho thuộc tính này.
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("mute", (event) => { })
onmute = (event) => { }
Loại sự kiện
Một Event chung.
Ví dụ
Trong ví dụ này, các trình xử lý sự kiện được thiết lập cho các sự kiện mute và unmute để phát hiện khi phương tiện không chảy từ nguồn cho MediaStreamTrack được tham chiếu bởi musicTrack.
musicTrack.addEventListener("mute", (event) => {
const widget = document.getElementById("timeline-widget");
widget.style.backgroundColor = "#aaaaaa";
});
musicTrack.addEventListener("unmute", (event) => {
document.getElementById("timeline-widget").style.backgroundColor = "white";
});
Với các trình xử lý sự kiện này được thiết lập, khi track musicTrack vào trạng thái muted của nó, phần tử có ID timeline-widget sẽ được thay đổi màu nền thành #aaaaaa. Khi track thoát khỏi trạng thái tắt tiếng—được phát hiện bằng sự kiện unmute đến—màu nền được khôi phục thành màu trắng.
Bạn cũng có thể sử dụng thuộc tính trình xử lý sự kiện onmute để thiết lập một trình xử lý cho sự kiện này; tương tự, trình xử lý sự kiện onunmute khả dụng để thiết lập một trình xử lý cho sự kiện unmute. Ví dụ sau đây minh họa điều này:
musicTrack.onmute = (event) => {
document.getElementById("timeline-widget").style.backgroundColor = "#aaaaaa";
};
musicTrack.onunmute = (event) => {
document.getElementById("timeline-widget").style.backgroundColor = "white";
};
Tắt tiếng các track thông qua receivers
Ví dụ sau đây cho thấy cách tắt tiếng các track bằng receivers.
// Peer 1 (Sender)
const transceivers = peer.getTransceivers();
const audioTrack = transceivers[0];
audioTrack.direction = "recvonly";
const videoTrack = transceivers[1];
videoTrack.direction = "recvonly";
// Peer 2 (Receiver)
audioTrack.addEventListener("mute", (event) => {
// Làm gì đó trong UI
});
videoTrack.addEventListener("mute", (event) => {
// Làm gì đó trong UI
});
transceivers là một mảng các RTCRtpTransceiver nơi bạn có thể tìm thấy track âm thanh hoặc video được gửi và nhận. Để biết thêm thông tin, xem bài viết direction.
Đặc tả kỹ thuật
| Specification |
|---|
| Media Capture and Streams # dom-mediastreamtrack-onmute |