RTCDTMFSender
RTCDTMFSender
接口提供了一种在 DTMF 代码上发送 WebRTC RTCPeerConnection
的机制。您可以通过您希望发送 DTMF 的音频轨道的 RTCRtpSender.dtmf
属性访问连接的 RTCDTMFSender
。
WebRTC 的 DTMF 支持的主要目的是允许基于 WebRTC 的通信客户端连接到 公用交换电话网 (PSTN) 或其他传统电话服务,包括现有的语音 over IP (VoIP) 服务。出于这个原因,DTMF 不能用于两个基于 WebRTC 的设备之间,因为 WebRTC 没有提供接收 DTMF 代码的机制。
实例属性
RTCDTMFSender.canInsertDTMF
只读-
如果
RTCDTMFSender
能够发送 DTMF 音调,则该布尔值将为true
,否则为false
。 RTCDTMFSender.toneBuffer
只读-
一个包含当前排队等待传输的 DTMF 音调列表的字符串(已经播放的音调不再包含在字符串中)。有关音调缓冲区格式的详细信息,请参阅
toneBuffer
。
实例方法
RTCDTMFSender.insertDTMF()
-
给定一个描述一组 DTMF 代码的字符串,以及可选的音调持续时间和音调间隙,
insertDTMF()
开始发送指定的音调。调用insertDTMF()
将替换toneBuffer
中任何已挂起的音调。您可以通过指定一个空字符串 (""
) 作为要播放的音调集来中止发送排队的音调。
事件
使用 addEventListener()
或将事件监听器分配给此接口的 oneventname
属性来监听这些事件。
tonechange
-
当音调开始或停止播放时,将向
RTCDTMFSender
实例的事件处理程序发送tonechange
事件。
示例
有关完整示例,请参阅文章 使用 WebRTC 的 DTMF。
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # rtcdtmfsender |
浏览器兼容性
BCD 表格仅在浏览器中加载