RTCDTMFSender: tonechange event
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
Sự kiện tonechange được gửi đến một RTCDTMFSender bởi WebRTC API để cho biết khi nào các âm thanh DTMF đã được thêm vào hàng đợi để gửi trước đó (bằng cách gọi RTCDTMFSender.insertDTMF()) bắt đầu và kết thúc.
Để xác định âm thanh nào bắt đầu phát, hoặc nếu một âm thanh dừng phát, hãy kiểm tra giá trị của thuộc tính tone của sự kiện.
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 thuộc tính xử lý sự kiện.
addEventListener("tonechange", (event) => { })
ontonechange = (event) => { }
Kiểu sự kiện
Một RTCDTMFToneChangeEvent. Kế thừa từ Event.
Thuộc tính sự kiện
Ngoài các thuộc tính của Event, giao diện này cung cấp thêm:
RTCDTMFToneChangeEvent.toneRead only-
Một chuỗi chỉ định âm thanh đã bắt đầu phát, hoặc một chuỗi rỗng (
"") nếu âm thanh trước đó đã dừng phát.
Ví dụ
Ví dụ này thiết lập một trình xử lý cho sự kiện tonechange cập nhật một phần tử để hiển thị âm thanh đang phát trong nội dung của nó, hoặc nếu tất cả các âm thanh đã phát, chuỗi "<none>".
Điều này có thể được thực hiện bằng addEventListener():
dtmfSender.addEventListener("tonechange", (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
});
Bạn cũng có thể chỉ đặt thuộc tính xử lý sự kiện ontonechange trực tiếp:
dtmfSender.ontonechange = (ev) => {
let tone = ev.tone;
if (tone === "") {
tone = "<none>";
}
document.getElementById("playingTone").innerText = tone;
};
Thông số kỹ thuật
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # event-RTCDTMFSender-tonechange |