大网数据广告活动
Web 标准与前端开发

RTCDTMFSender:tonechange 事件

· 52CE 我爱测

`tonechange`** 事件会被 WebRTC API 发送给 RTCDTMFSender,以指示先前(通过调用 RTCDTMFSender.insertDTMF())排队等待发送的 DTMF 音调何时开始和结束。

WebRTC

tonechange 事件会被 WebRTC API 发送给 RTCDTMFSender,以指示先前(通过调用 RTCDTMFSender.insertDTMF())排队等待发送的 DTMF 音调何时开始和结束。

要确定哪个音调开始播放,或者音调是否停止播放,请检查事件的 RTCDTMFToneChangeEvent.tone 属性的值。

此事件不可取消,也不会冒泡。

语法

在像 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。

addEventListener("tonechange", (event) => {});

ontonechange = (event) => {};

事件类型

一个 RTCDTMFToneChangeEvent。继承自 Event。

RTCDTMFToneChangeEvent

事件属性

除了 Event 的属性外,此接口还提供以下属性:

  • RTCDTMFToneChangeEvent.tone
    • : 一个字符串,指定已开始播放的音调,或者如果上一个音调已完成播放,则为空字符串("")。

示例

此示例建立了一个处理 tonechange 事件的处理器,它会更新一个元素以在其内容中显示当前播放的音调,或者,如果所有音调都已播放,则显示字符串 "<none>"。

这可以使用 EventTarget.addEventListener 来完成:

dtmfSender.addEventListener(
  "tonechange",
  (ev) => {
    let tone = ev.tone;
    if (tone === "") {
      tone = "&lt;none&gt;";
    }

    document.getElementById("playingTone").innerText = tone;
  },
  false,
);

你还可以直接设置 ontonechange 事件处理器属性:

dtmfSender.ontonechange = (ev) => {
  let tone = ev.tone;
  if (tone === "") {
    tone = "&lt;none&gt;";
  }

  document.getElementById("playingTone").innerText = tone;
};

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。