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

Timestamp:

Oct 5, 2007 9:12:26 AM (17 years ago)

Author:

bennylp

Message:

Ticket #391: Added framework to send and receive arbitrary requests within call in PJSUA-LIB, with samples to send/receive DTMF with INFO in pjsua application

File:

• pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h (modified) (2 diffs)

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

@@ -546 +546 @@
 
     /**
+     * This is a general notification callback which is called whenever
+     * a transaction within the call has changed state. Application can
+     * implement this callback for example to monitor the state of 
+     * outgoing requests, or to answer unhandled incoming requests 
+     * (such as INFO) with a final response.
+     *
+     * @param call_id   Call identification.
+     * @param tsx       The transaction which has changed state.
+     * @param e         Transaction event that caused the state change.
+     */
+    void (*on_call_tsx_state)(pjsua_call_id call_id, 
+                              pjsip_transaction *tsx,
+                              pjsip_event *e);
+
+    /**
      * Notify application when media state in the call has changed.
      * Normal application would need to implement this callback, e.g.
@@ -2906 +2921 @@
                                                 pj_bool_t is_typing,
                                                 const pjsua_msg_data*msg_data);
+
+/**
+ * Send arbitrary request with the call. This is useful for example to send
+ * INFO request. Note that application should not use this function to send
+ * requests which would change the invite session's state, such as re-INVITE,
+ * UPDATE, PRACK, and BYE.
+ *
+ * @param call_id       Call identification.
+ * @param method        SIP method of the request.
+ * @param msg_data      Optional message body and/or list of headers to be 
+ *                      included in outgoing request.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjsua_call_send_request(pjsua_call_id call_id,
+                                             const pj_str_t *method,
+                                             const pjsua_msg_data *msg_data);
+
 
 /**