From b47a155abe84e479dd4dde3fea13a807e0c4bb76 Mon Sep 17 00:00:00 2001 From: Byoungchan Lee Date: Mon, 23 Sep 2024 12:10:05 +0900 Subject: [PATCH] fix: Add details for createDTMFSender() method in RTCPeerConnection interface (#33955) * fix: Add details for createDTMFSender() method in RTCPeerConnection interface Fixes #33954 * Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: wbamberg * Update index.md * Not non-standard * Update index.md --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Co-authored-by: wbamberg Co-authored-by: Joshua Chen --- .../createdtmfsender/index.md | 69 +++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md diff --git a/files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md b/files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md new file mode 100644 index 000000000000000..dfc9ae6119233a8 --- /dev/null +++ b/files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md @@ -0,0 +1,69 @@ +--- +title: "RTCPeerConnection: createDTMFSender() method" +short-title: createDTMFSender() +slug: Web/API/RTCPeerConnection/createDTMFSender +page-type: web-api-instance-method +status: + - deprecated + - non-standard +browser-compat: api.RTCPeerConnection.createDTMFSender +--- + +{{APIRef("WebRTC")}}{{Deprecated_Header}}{{non-standard_header}} + +The **`createDTMFSender()`** method of the {{domxref("RTCPeerConnection")}} interface creates a new {{domxref("RTCDTMFSender")}} object associated with the specified {{domxref("MediaStreamTrack")}}, which can be used to send DTMF tones over the connection. + +This method is deprecated and should not be used. Instead, use the {{domxref("RTCRtpSender.dtmf")}} property to access the DTMF sender associated with a specific sender. + +## Syntax + +```js-nolint +createDTMFSender(track) +``` + +### Parameters + +- `track` + - : A {{domxref("MediaStreamTrack")}} object representing the track to associate with the new DTMF sender. + +### Return value + +A new {{domxref("RTCDTMFSender")}} object. + +## Examples + +This example creates a new DTMF sender associated with the specified track. + +```js +navigator.getUserMedia({ audio: true }, (stream) => { + const pc = new RTCPeerConnection(); + const track = stream.getAudioTracks()[0]; + const dtmfSender = pc.createDTMFSender(track); +}); +``` + +This could be rewritten using the {{domxref("RTCRtpSender.dtmf")}} property: + +```js +navigator.getUserMedia({ audio: true }, (stream) => { + const pc = new RTCPeerConnection(); + const track = stream.getAudioTracks()[0]; + const sender = pc.addTrack(track, stream); + const dtmfSender = sender.dtmf; +}); +``` + +## Specifications + +This feature is non-standard and not part of any specification. + +## Browser compatibility + +{{Compat}} + +## See also + +- [WebRTC](/en-US/docs/Web/API/WebRTC_API) +- {{domxref("RTCDTMFSender")}} +- {{domxref("RTCRtpSender")}} +- {{domxref("RTCPeerConnection")}}