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

Timestamp:

Oct 12, 2007 12:14:27 PM (17 years ago)

Author:

bennylp

Message:

Ticket #399: Initial implementation of tool to perform NAT type detection/classification

File:

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

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

@@ -40 +40 @@
 /* Include all PJSIP-SIMPLE headers */
 #include <pjsip_simple.h>
+
+/* Include all PJNATH headers */
+#include <pjnath.h>
 
 /* Include all PJLIB-UTIL headers. */
@@ -1311 +1314 @@
 
 /**
+ * This is a utility function to detect NAT type in front of this
+ * endpoint. Once invoked successfully, this function will complete 
+ * asynchronously and report the result in the callback.
+ *
+ * @param srv_port      Optional STUN server and port, in "SERVER[:PORT]"
+ *                      format. If this option is NULL, the function will use
+ *                      the STUN server that has been set in the pjsua
+ *                      configuration.
+ * @param user_data     User data to be returned back in the callback.
+ * @param cb            Optional callback to report the detection result.
+ *
+ * @return              PJ_SUCCESS if detection is started successfully.
+ */
+PJ_DECL(pj_status_t) pjsua_detect_nat_type(void *user_data,
+                                           pj_stun_nat_detect_cb *cb);
+
+
+/**
  * This is a utility function to verify that valid SIP url is given. If the
  * URL is valid, PJ_SUCCESS will be returned.