Add API to get number of queued DTMF transmission digits (#4645)

Author: Copilot

pjmedia/include/pjmedia/stream.h

@@ -453,6 +453,17 @@ pjmedia_stream_set_dtmf_event_callback(pjmedia_stream *stream,
                                        void *user_data);
 
 
+/**
+ * Get the number of queued DTMF digits for transmission.
+ *
+ * @param stream        The media stream.
+ *
+ * @return              Number of DTMF digits queued for transmission,
+ *                      or 0 if stream is NULL.
+ */
+PJ_DECL(unsigned) pjmedia_get_queued_dtmf_digits(pjmedia_stream *stream);
+
+
 /**
  * Send RTCP SDES for the media stream.
  *

pjmedia/src/pjmedia/stream.c

@@ -2841,6 +2841,26 @@ PJ_DEF(pj_status_t) pjmedia_stream_set_dtmf_event_callback(pjmedia_stream *strea
     return PJ_SUCCESS;
 }
 
+/*
+ * Get the number of queued DTMF digits for transmission.
+ */
+PJ_DEF(unsigned) pjmedia_get_queued_dtmf_digits(pjmedia_stream *stream)
+{
+    pjmedia_stream_common *c_strm = (pjmedia_stream_common *)stream;
+    unsigned count;
+
+    PJ_ASSERT_RETURN(stream, 0);
+
+    /* By convention, we use jitter buffer's mutex to access DTMF
+     * digits resources.
+     */
+    pj_mutex_lock(c_strm->jb_mutex);
+    count = stream->tx_dtmf_count;
+    pj_mutex_unlock(c_strm->jb_mutex);
+
+    return count;
+}
+
 /*
  * Send RTCP SDES.
  */

pjsip/include/pjsua-lib/pjsua.h

@@ -6546,6 +6546,18 @@ PJ_DECL(pj_status_t) pjsua_call_dial_dtmf2(pjsua_call_id call_id,
 PJ_DECL(pj_status_t) pjsua_call_send_dtmf(pjsua_call_id call_id, 
                                       const pjsua_call_send_dtmf_param *param);
 
+/**
+ * Get the number of queued DTMF digits for transmission in the call.
+ *
+ * @param call_id       Call identification.
+ * @param digits        On return, will contain the number of DTMF digits
+ *                      queued for transmission.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjsua_call_get_queued_dtmf_digits(pjsua_call_id call_id,
+                                                       unsigned *digits);
+
 /**
  * Send real-time text to remote via RTP stream. This only works if the call
  * has text media.

pjsip/src/pjsua-lib/pjsua_aud.c

@@ -172,6 +172,37 @@ PJ_DEF(pj_status_t) pjsua_call_dial_dtmf2( pjsua_call_id call_id,
     return status;
 }
 
+/*
+ * Get the number of queued DTMF digits for transmission in the call.
+ */
+PJ_DEF(pj_status_t) pjsua_call_get_queued_dtmf_digits(pjsua_call_id call_id,
+                                                      unsigned *digits)
+{
+    pjsua_call *call;
+    pjsip_dialog *dlg = NULL;
+    pj_status_t status;
+
+    PJ_ASSERT_RETURN(call_id>=0 && call_id<(int)pjsua_var.ua_cfg.max_calls &&
+                     digits, PJ_EINVAL);
+
+    status = acquire_call("pjsua_call_get_queued_dtmf_digits()", call_id, 
+                          &call, &dlg);
+    if (status != PJ_SUCCESS)
+        goto on_return;
+
+    if (!pjsua_call_has_media(call_id)) {
+        status = PJ_EINVALIDOP;
+        goto on_return;
+    }
+
+    *digits = pjmedia_get_queued_dtmf_digits(
+                call->media[call->audio_idx].strm.a.stream);
+
+on_return:
+    if (dlg) pjsip_dlg_dec_lock(dlg);
+    return status;
+}
+
 
 /*****************************************************************************
  *