RTCDTMFSender: tonechange 事件

当 RTCDTMFSender 通过 WebRTC API 发送先前排队等待发送的 DTMF 音调（通过调用 RTCDTMFSender.insertDTMF()）开始和结束时，会向其发送 tonechange 事件。

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

此事件不可取消，也不冒泡。

语法

在 addEventListener() 等方法中使用事件名称，或者设置事件处理程序属性。

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

ontonechange = (event) => {};

事件类型

一个 RTCDTMFToneChangeEvent。继承自 Event。

Event RTCDTMFToneChangeEvent

事件属性

除了 Event 的属性之外，此接口还提供以下内容

RTCDTMFToneChangeEvent.tone 只读

指定已开始播放的音调的字符串，或者如果前一个音调已停止播放，则为一个空字符串 ("")。

示例

此示例为 tonechange 事件建立一个处理程序，该处理程序会更新一个元素，在其内容中显示当前播放的音调，或者如果所有音调都已播放，则显示字符串 "<none>".

这可以使用 addEventListener() 来完成

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

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

您也可以直接设置 ontonechange 事件处理程序属性

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

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

规范

规范
WebRTC：浏览器中的实时通信
# event-RTCDTMFSender-tonechange

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。