Changeset 3908 for pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h

Timestamp:

Dec 13, 2011 4:59:15 AM (13 years ago)

Author:

nanang

Message:

Close #1424: Added new pjsua callback: on_call_rx_offer().

File:

• pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h (modified) (1 diff)

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

@@ -810 +810 @@
                              pjsua_call_id new_call_id);
 
+
+    /**
+     * Notify application when call has received new offer from remote
+     * (i.e. re-INVITE/UPDATE with SDP is received). Application can
+     * decide to accept/reject the offer by setting the code (default
+     * is 200). If the offer is accepted, application can update the 
+     * call setting to be applied in the answer. When this callback is
+     * not defined, the default behavior is to accept the offer using
+     * current call setting.
+     *
+     * @param call_id   The call index.
+     * @param offer     The new offer received.
+     * @param reserved  Reserved param, currently not used.
+     * @param code      Status code to be returned for answering the
+     *                  offer. On input, it contains status code 200.
+     *                  Currently, valid values are only 200 and 488.
+     * @param opt       The current call setting, application can update
+     *                  this setting for answering the offer.
+     */
+    void (*on_call_rx_offer)(pjsua_call_id call_id,
+                             const pjmedia_sdp_session *offer,
+                             void *reserved,
+                             pjsip_status_code *code,
+                             pjsua_call_setting *opt);
 
     /**