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

Timestamp:

Oct 26, 2009 11:21:37 AM (15 years ago)

Author:

bennylp

Message:

Implement ticket #982: Support for SIP Message Summary/Message? Waiting Indication (MWI, RFC 3842)

• PJSIP-SIMPLE:
  • implement MWI
• PJSUA-LIB:
  • added "mwi_enabled" flag in account config
  • added "on_mwi_info" callback
• pjsua app:
  • added "--mwi" option to enable MWI on account
  • added simple callback to log the NOTIFY message
• other:
  • added SIPp scenario files to simulate UAS side
• build:
  • added MWI support on VS6, VS2005, MMP, and Makefile

File:

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

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

@@ -377 +377 @@
                                        pjsua_logging_config *dst,
                                        const pjsua_logging_config *src);
+
+
+/**
+ * Structure to be passed on MWI callback.
+ */
+typedef struct pjsua_mwi_info
+{
+    pjsip_evsub     *evsub;     /**< Event subscription session, for
+                                     reference.                         */
+    pjsip_rx_data   *rdata;     /**< The received NOTIFY request.       */
+} pjsua_mwi_info;
 
 
@@ -822 +833 @@
                                             const pjsip_event *e);
 
+    /**
+     * This callback is called when a NOTIFY request for message summary / 
+     * message waiting indication is received.
+     *
+     * @param acc_id    The account ID.
+     * @param mwi_info  Structure containing details of the event,
+     *                  including the received NOTIFY request in the
+     *                  \a rdata field.
+     */
+    void (*on_mwi_info)(pjsua_acc_id acc_id, pjsua_mwi_info *mwi_info);
+
 } pjsua_callback;
 
@@ -1859 +1881 @@
      */
     pj_str_t        reg_uri;
+
+    /**
+     * Enable message summary and message waiting indication subscription
+     * (RFC 3842) for this account.
+     *
+     * Default: no
+     */
+    pj_bool_t       mwi_enabled;
 
     /**