RTCDTMFSender: toneBuffer 屬性

Baseline 已廣泛支援

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

RTCDTMFSender 介面的 toneBuffer 屬性返回一個字串,其中包含當前排隊等待透過 RTCPeerConnection 傳送到遠端對等端的 DTMF 音調列表。要將音調放入緩衝區,請呼叫 insertDTMF()

音調在播放時會從字串中移除,因此只列出即將播放的音調。

一個列出要播放的音調的字串。如果字串為空,則沒有待處理的音調。

異常

InvalidCharacterError DOMException

如果字元不是 DTMF 音調字元(0-9A-D#,),則丟擲此異常。

音調緩衝區格式

音調緩衝區是一個字串,可以包含 DTMF 標準允許的任意字元組合。

DTMF 音調字元

數字 0-9

這些字元代表電話鍵盤上的數字鍵。

字母 A-D

這些字元代表“A”到“D”鍵,它們是 DTMF 標準的一部分,但未包含在大多數電話上。它們被解釋為數字。小寫字母“a”-“d”會自動轉換為大寫。

井號(“#”)和星號(“*”)

這些對應於電話鍵盤底部一排上帶有類似標籤的鍵。

逗號(“,”)

此字元指示撥號過程在傳送緩衝區中的下一個字元之前暫停兩秒鐘。

注意:所有其他字元都無法識別,並且會導致 insertDTMF() 丟擲 InvalidCharacterError DOMException

使用音調緩衝區字串

例如,如果您正在編寫程式碼透過傳送 DTMF 程式碼來控制語音郵件系統,您可能會使用一個字串,例如 "*,1,5555"。在這個例子中,我們將傳送 "*" 來請求訪問 VM 系統,然後,暫停後,傳送 "1" 來開始播放語音郵件訊息,然後暫停後,撥打 "5555" 作為 PIN 碼來開啟訊息。

將音調緩衝區設定為空字串("")會取消任何待處理的 DTMF 程式碼。

示例

待定

規範

規範
WebRTC:瀏覽器中的即時通訊
# dom-RTCDTMFSender-tonebuffer

瀏覽器相容性

另見