RTCDTMFSender: toneBuffer-Eigenschaft

Die toneBuffer-Eigenschaft der Schnittstelle RTCDTMFSender gibt eine Zeichenfolge zurück, die eine Liste der DTMF-Töne enthält, die derzeit in der Warteschlange stehen, um an den Remote-Peer über die RTCPeerConnection gesendet zu werden. Um Töne in den Puffer einzufügen, rufen Sie insertDTMF() auf.

Töne werden aus der Zeichenfolge entfernt, sobald sie gespielt werden, so dass nur die bevorstehenden Töne aufgelistet sind.

Wert

Eine Zeichenfolge, die die zu spielenden Töne auflistet. Wenn die Zeichenfolge leer ist, stehen keine Töne an.

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn ein Zeichen kein DTMF-Tonzeichen (0-9, A-D, # oder ,) ist.

Format des Tonebuffers

Der Tonebuffer ist eine Zeichenfolge, die eine beliebige Kombination der vom DTMF-Standard erlaubten Zeichen enthalten kann.

DTMF-Tonzeichen

Die Ziffern 0-9

Diese Zeichen repräsentieren die Ziffertasten auf einer Telefon-Tastatur.

Die Buchstaben A-D

Diese Zeichen repräsentieren die Tasten "A" bis "D", die Teil des DTMF-Standards sind, aber auf den meisten Telefonen nicht enthalten sind. Diese werden nicht als Ziffern interpretiert. Kleinbuchstaben "a"-"d" werden automatisch in Großbuchstaben umgewandelt.

Das Rautezeichen ("#") und der Stern ("*")

Diese entsprechen den ähnlich beschrifteten Tasten, die typischerweise in der unteren Reihe der Telefon-Tastatur zu finden sind.

Das Komma (",")

Dieses Zeichen veranlasst den Wählvorgang, zwei Sekunden Pause zu machen, bevor das nächste Zeichen im Puffer gesendet wird.

Hinweis: Alle anderen Zeichen werden nicht erkannt und führen dazu, dass insertDTMF() einen InvalidCharacterError DOMException auslöst.

Verwendung von Tonebuffer-Zeichenfolgen

Zum Beispiel, wenn Sie Code schreiben, um ein Voicemail-System durch Senden von DTMF-Codes zu steuern, könnten Sie eine Zeichenfolge wie "*,1,5555" verwenden. In diesem Beispiel würden wir "*" senden, um Zugriff auf das Voicemail-System anzufordern, dann nach einer Pause eine "1", um mit der Wiedergabe von Voicemail-Nachrichten zu beginnen, und dann nach einer Pause "5555" als PIN-Nummer wählen, um die Nachrichten zu öffnen.

Das Setzen des Tonebuffers auf eine leere Zeichenfolge ("") hebt alle anstehenden DTMF-Codes auf.

Beispiel

tbd

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-RTCDTMFSender-tonebuffer

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch