RTCDTMFSender

Baseline 廣泛可用 *

此功能已經成熟,並可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 3 月⁩起,它已在各瀏覽器中推出。

* 此特性的某些部分可能存在不同級別的支援。

RTCDTMFSender 介面提供了一種在 WebRTC RTCPeerConnection 上傳輸 DTMF 碼的方法。您可以透過要傳送 DTMF 的音訊軌上的 RTCRtpSender.dtmf 屬性來訪問連線的 RTCDTMFSender

WebRTC 的 DTMF 支援的主要目的是允許基於 WebRTC 的通訊客戶端連線到 公共交換電話網 (PSTN) 或其他傳統電話服務,包括現有的 IP 語音 (VoIP) 服務。因此,DTMF 不能在兩個基於 WebRTC 的裝置之間使用,因為 WebRTC 沒有提供接收 DTMF 碼的機制。

EventTarget RTCDTMFSender

例項屬性

RTCDTMFSender.canInsertDTMF 只讀

一個布林值,如果 RTCDTMFSender 能夠傳送 DTMF 訊號音,則為 true,否則為 false

RTCDTMFSender.toneBuffer 只讀

一個字串,包含當前在佇列中等待傳輸的 DTMF 訊號音列表(已播放的訊號音不再包含在該字串中)。有關訊號音緩衝區的格式,請參閱 toneBuffer

例項方法

RTCDTMFSender.insertDTMF()

給定一個描述一組 DTMF 碼的字串,以及可選的訊號音持續時間和訊號音間隔,insertDTMF() 會開始傳送指定的訊號音。呼叫 insertDTMF() 會替換 toneBuffer 中所有已掛起的訊號音。您可以透過指定一個空字串("")作為要播放的訊號音集來中止傳送排隊的訊號音。

事件

使用 addEventListener() 監聽這些事件,或透過將事件監聽器分配給此介面的 oneventname 屬性。

tonechange

tonechange 事件傳送到 RTCDTMFSender 例項的事件處理程式,以指示訊號音已開始或已停止播放。

示例

有關完整示例,請參閱文章 使用 WebRTC 的 DTMF

規範

規範
WebRTC:瀏覽器中的即時通訊
# rtcdtmfsender

瀏覽器相容性

另見