fix: Add details for createDTMFSender() method in RTCPeerConnection i…

…nterface (#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 <[email protected]> * Apply suggestions from code review Co-authored-by: wbamberg <[email protected]> * 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 <[email protected]> Co-authored-by: wbamberg <[email protected]> Co-authored-by: Joshua Chen <[email protected]>
mdn · Oct 2, 2024 · b47a155 · b47a155
1 parent 8db145a
commit b47a155
Showing 1 changed file with 69 additions and 0 deletions.
diff --git a/files/en-us/web/api/rtcpeerconnection/createdtmfsender/index.md 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")}}