Changeset 1806

Timestamp:

Feb 20, 2008 8:56:15 AM (16 years ago)

Author:

bennylp

Message:

Ticket #489: New PJSUA callbacks to notify application when media stream is created and destroyed

Location:

pjproject/trunk/pjsip

Files:

• include/pjsua-lib/pjsua.h (modified) (1 diff)
• src/pjsua-lib/pjsua_media.c (modified) (2 diffs)

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

@@ -603 +603 @@
     void (*on_call_media_state)(pjsua_call_id call_id);
 
+ 
+    /** 
+     * Notify application when media session is created and before it is
+     * registered to the conference bridge. Application may return different
+     * media port if it has added media processing port to the stream. This
+     * media port then will be added to the conference bridge instead.
+     *
+     * @param call_id       Call identification.
+     * @param sess          Media session for the call.
+     * @param stream_idx    Stream index in the media session.
+     * @param p_port        On input, it specifies the media port of the
+     *                      stream. Application may modify this pointer to
+     *                      point to different media port to be registered
+     *                      to the conference bridge.
+     *
+     * \par Python:
+     * Not applicable. 
+     */
+    void (*on_stream_created)(pjsua_call_id call_id, 
+                              pjmedia_session *sess,
+                              unsigned stream_idx, 
+                              pjmedia_port **p_port);
+
+    /** 
+     * Notify application when media session has been unregistered from the
+     * conference bridge and about to be destroyed.
+     *
+     * @param call_id       Call identification.
+     * @param sess          Media session for the call.
+     * @param stream_idx    Stream index in the media session.
+     *
+     * \par Python:
+     * Not applicable. 
+     */
+    void (*on_stream_destroyed)(pjsua_call_id call_id,
+                                pjmedia_session *sess, 
+                                unsigned stream_idx);
+
     /**
      * Notify application upon incoming DTMF digits.

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

@@ -887 +887 @@
 
     if (call->session) {
+        if (pjsua_var.ua_cfg.cb.on_stream_destroyed) {
+            pjsua_var.ua_cfg.cb.on_stream_destroyed(call_id, call->session, 0);
+        }
+
         pjmedia_session_destroy(call->session);
         call->session = NULL;
@@ -1058 +1062 @@
         pjmedia_session_get_port(call->session, 0, &media_port);
 
+        /* Notify application about stream creation.
+         * Note: application may modify media_port to point to different
+         * media port
+         */
+        if (pjsua_var.ua_cfg.cb.on_stream_created) {
+            pjsua_var.ua_cfg.cb.on_stream_created(call_id, call->session,
+                                                  0, &media_port);
+        }
 
         /*