Changeset 2259

Timestamp:

Sep 2, 2008 11:25:07 AM (16 years ago)

Author:

bennylp

Message:

Ticket #608: Added API to retrieve media transport and session from pjsua call

Location:

pjproject/trunk/pjsip

Files:

• include/pjsua-lib/pjsua.h (modified) (1 diff)
• src/pjsua-lib/pjsua_call.c (modified) (1 diff)

pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h

@@ -2936 +2936 @@
 
 /**
+ * Retrieve the media session associated with this call. Note that the media
+ * session may not be available depending on the current call's media status
+ * (the pjsua_call_media_status information in pjsua_call_info). Application
+ * may use the media session to retrieve more detailed information about the
+ * call's media.
+ *
+ * @param call_id       Call identification.
+ *
+ * @return              Call media session.
+ */
+PJ_DECL(pjmedia_session*) pjsua_call_get_media_session(pjsua_call_id call_id);
+
+
+/**
+ * Retrieve the media transport instance that is used for this call. 
+ * Application may use the media transport to query more detailed information
+ * about the media transport.
+ *
+ * @param cid           Call identification (the call_id).
+ *
+ * @return              Call media transport.
+ */
+PJ_DECL(pjmedia_transport*) pjsua_call_get_media_transport(pjsua_call_id cid);
+
+
+/**
  * Get the conference port identification associated with the call.
  *

pjproject/trunk/pjsip/src/pjsua-lib/pjsua_call.c

@@ -1022 +1022 @@
                      PJ_EINVAL);
     return pjsua_var.calls[call_id].session != NULL;
+}
+
+
+/*
+ * Retrieve the media session associated with this call.
+ */
+PJ_DEF(pjmedia_session*) pjsua_call_get_media_session(pjsua_call_id call_id)
+{
+    PJ_ASSERT_RETURN(call_id>=0 && call_id<(int)pjsua_var.ua_cfg.max_calls, 
+                     NULL);
+    return pjsua_var.calls[call_id].session;
+}
+
+
+/*
+ * Retrieve the media transport instance that is used for this call.
+ */
+PJ_DEF(pjmedia_transport*) pjsua_call_get_media_transport(pjsua_call_id cid)
+{
+    PJ_ASSERT_RETURN(cid>=0 && cid<(int)pjsua_var.ua_cfg.max_calls, 
+                     NULL);
+    return pjsua_var.calls[cid].med_tp;
 }