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

Timestamp:

Aug 25, 2007 1:36:15 PM (17 years ago)

Author:

bennylp

Message:

Implement ticket #336: custom presence status in NOTIFY/PUBLISH, supporting subset of RPID elements

File:

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

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

@@ -1919 +1919 @@
 
     /**
+     * Presence online status text.
+     */
+    pj_str_t            online_status_text;
+
+    /**
+     * Extended RPID online status information.
+     */
+    pjrpid_element      rpid;
+
+    /**
      * Buffer that is used internally to store the status text.
      */
@@ -2081 +2091 @@
  * Modify account's presence status to be advertised to remote/presence
  * subscribers. This would trigger the sending of outgoing NOTIFY request
- * if there are server side presence subscription for this account.
+ * if there are server side presence subscription for this account, and/or
+ * outgoing PUBLISH if presence publication is enabled for this account.
+ *
+ * @see pjsua_acc_set_online_status2()
  *
  * @param acc_id        The account ID.
@@ -2096 +2109 @@
                                                  pj_bool_t is_online);
 
+/**
+ * Modify account's presence status to be advertised to remote/presence
+ * subscribers. This would trigger the sending of outgoing NOTIFY request
+ * if there are server side presence subscription for this account, and/or
+ * outgoing PUBLISH if presence publication is enabled for this account.
+ *
+ * @see pjsua_acc_set_online_status()
+ *
+ * @param acc_id        The account ID.
+ * @param is_online     True of false.
+ * @param pr            Extended information in subset of RPID format
+ *                      which allows setting custom presence text.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjsua_acc_set_online_status2(pjsua_acc_id acc_id,
+                                                  pj_bool_t is_online,
+                                                  const pjrpid_element *pr);
 
 /**
@@ -2989 +3020 @@
 
     /**
+     * Extended RPID information about the person.
+     */
+    pjrpid_element      rpid;
+
+    /**
      * Internal buffer.
      */
-    char                buf_[256];
+    char                buf_[512];
 
 } pjsua_buddy_info;