Ignore:
Timestamp:
May 13, 2016 10:56:48 AM (5 years ago)
Author:
ming
Message:

Fixed #1918: Add API to update STUN servers and option to retry STUN for media on failure

File:
1 edited

Legend:

Unmodified
Added
Removed
  • pjproject/trunk/pjsip/include/pjsua-lib/pjsua.h

    r5283 r5297  
    15821582     * start if it fails to resolve or contact any of the STUN servers. 
    15831583     * 
     1584     * This setting will also determine what happens if STUN servers are 
     1585     * unavailable during runtime (if set to PJ_FALSE, calls will 
     1586     * directly fail, otherwise (if PJ_TRUE) call medias will 
     1587     * fallback to proceed as though not using STUN servers. 
     1588     * 
    15841589     * Default: PJ_TRUE 
    15851590     */ 
     
    20832088 */ 
    20842089PJ_DECL(pj_status_t) pjsua_get_nat_type(pj_stun_nat_type *type); 
     2090 
     2091 
     2092/** 
     2093 * Update the STUN servers list. The #pjsua_init() must have been called 
     2094 * before calling this function. 
     2095 * 
     2096 * @param count         Number of STUN server entries. 
     2097 * @param srv           Array of STUN server entries to try. Please see 
     2098 *                      the \a stun_srv field in the #pjsua_config  
     2099 *                      documentation about the format of this entry. 
     2100 * @param wait          Specify non-zero to make the function block until 
     2101 *                      it gets the result. In this case, the function 
     2102 *                      will block while the resolution is being done, 
     2103 *                      and the callback will be called before this function 
     2104 *                      returns. 
     2105 * 
     2106 * @return              If \a wait parameter is non-zero, this will return 
     2107 *                      PJ_SUCCESS if one usable STUN server is found. 
     2108 *                      Otherwise it will always return PJ_SUCCESS, and 
     2109 *                      application will be notified about the result in 
     2110 *                      the callback #on_stun_resolution_complete. 
     2111 */ 
     2112PJ_DECL(pj_status_t) pjsua_update_stun_servers(unsigned count, pj_str_t srv[], 
     2113                                               pj_bool_t wait); 
    20852114 
    20862115 
     
    27232752     * this setting has no effect. 
    27242753     */ 
    2725     PJSUA_STUN_USE_DISABLED 
     2754    PJSUA_STUN_USE_DISABLED, 
     2755     
     2756    /** 
     2757     * Retry other STUN servers if the STUN server selected during 
     2758     * startup (#pjsua_init()) or after calling #pjsua_update_stun_servers() 
     2759     * is unavailable during runtime. This setting is valid only for 
     2760     * account's media STUN setting and if the call is using UDP media 
     2761     * transport. 
     2762     */ 
     2763    PJSUA_STUN_RETRY_ON_FAILURE 
    27262764 
    27272765} pjsua_stun_use; 
Note: See TracChangeset for help on using the changeset viewer.