Liblinphone
5.3.0
|
Macros | |
#define | linphone_proxy_config_expires linphone_proxy_config_set_expires |
#define | linphone_proxy_config_enableregister linphone_proxy_config_enable_register |
#define | linphone_proxy_config_get_addr linphone_proxy_config_get_server_addr |
Typedefs | |
typedef struct _LinphoneProxyConfig | LinphoneProxyConfig |
Represents an account configuration to be used by LinphoneCore. More... | |
typedef enum _LinphoneRegistrationState | LinphoneRegistrationState |
Describes proxy registration states. More... | |
Enumerations | |
enum | _LinphoneRegistrationState { LinphoneRegistrationNone = 0, LinphoneRegistrationProgress = 1, LinphoneRegistrationOk = 2, LinphoneRegistrationCleared = 3, LinphoneRegistrationFailed = 4, LinphoneRegistrationRefreshing = 5 } |
Describes proxy registration states. More... | |
Functions | |
LinphoneStatus | linphone_core_set_primary_contact (LinphoneCore *core, const char *contact) |
Sets the local "from" identity. More... | |
const char * | linphone_core_get_primary_contact (LinphoneCore *core) |
Returns the default identity when no proxy configuration is used. More... | |
const char * | linphone_core_get_identity (LinphoneCore *core) |
Gets the default identity SIP address. More... | |
void | linphone_core_set_guess_hostname (LinphoneCore *core, bool_t enable) |
Tells LinphoneCore to guess local hostname automatically in primary contact. More... | |
bool_t | linphone_core_get_guess_hostname (LinphoneCore *core) |
Returns TRUE if hostname part of primary contact is guessed automatically. More... | |
LinphoneAddress * | linphone_core_create_primary_contact_parsed (LinphoneCore *core) |
Same as linphone_core_get_primary_contact() but the result is a LinphoneAddress object instead of const char *. More... | |
LinphoneProxyConfig * | linphone_core_create_proxy_config (LinphoneCore *core) |
Create a proxy config with default values from Linphone core. More... | |
LinphoneStatus | linphone_core_add_proxy_config (LinphoneCore *core, LinphoneProxyConfig *config) |
Add a proxy configuration. More... | |
void | linphone_core_clear_proxy_config (LinphoneCore *core) |
Erase all proxies from config. More... | |
void | linphone_core_remove_proxy_config (LinphoneCore *core, LinphoneProxyConfig *config) |
Removes a proxy configuration. More... | |
const bctbx_list_t * | linphone_core_get_proxy_config_list (const LinphoneCore *core) |
Returns an unmodifiable list of entered proxy configurations. More... | |
LinphoneProxyConfig * | linphone_core_get_proxy_config_by_idkey (LinphoneCore *core, const char *idkey) |
Search for a LinphoneProxyConfig by it's idkey. More... | |
LinphoneProxyConfig * | linphone_core_get_default_proxy_config (const LinphoneCore *core) |
Returns the default proxy configuration, that is the one used to determine the current identity. More... | |
void | linphone_core_set_default_proxy_config (LinphoneCore *core, LinphoneProxyConfig *config) |
Sets the default proxy. More... | |
void | linphone_core_refresh_registers (LinphoneCore *core) |
force registration refresh to be initiated upon next iterate More... | |
MS2_DEPRECATED LinphoneAddress * | linphone_core_get_primary_contact_parsed (LinphoneCore *core) |
Same as linphone_core_get_primary_contact() but the result is a LinphoneAddress object instead of const char *. More... | |
const char * | linphone_registration_state_to_string (LinphoneRegistrationState state) |
Human readable version of the LinphoneRegistrationState. More... | |
LinphoneProxyConfig * | linphone_proxy_config_ref (LinphoneProxyConfig *proxy_config) |
Acquire a reference to the proxy config. More... | |
void | linphone_proxy_config_unref (LinphoneProxyConfig *proxy_config) |
Release reference to the proxy config. More... | |
void * | linphone_proxy_config_get_user_data (const LinphoneProxyConfig *proxy_config) |
Retrieve the user pointer associated with the proxy config. More... | |
void | linphone_proxy_config_set_user_data (LinphoneProxyConfig *proxy_config, void *user_data) |
Assign a user pointer to the proxy config. More... | |
LinphoneStatus | linphone_proxy_config_set_server_addr (LinphoneProxyConfig *proxy_config, const char *server_address) |
Sets the proxy address. More... | |
LinphoneStatus | linphone_proxy_config_set_identity_address (LinphoneProxyConfig *proxy_config, LinphoneAddress *identity) |
Sets the user identity as a SIP address. More... | |
LinphoneStatus | linphone_proxy_config_set_routes (LinphoneProxyConfig *proxy_config, const bctbx_list_t *routes) |
Sets a list of SIP route. More... | |
void | linphone_proxy_config_set_expires (LinphoneProxyConfig *proxy_config, int expires) |
Sets the registration expiration time in seconds. More... | |
void | linphone_proxy_config_enable_register (LinphoneProxyConfig *proxy_config, bool_t enable) |
Indicates either or not, REGISTRATION must be issued for this LinphoneProxyConfig. More... | |
void | linphone_proxy_config_edit (LinphoneProxyConfig *proxy_config) |
Starts editing a proxy configuration. More... | |
LinphoneStatus | linphone_proxy_config_done (LinphoneProxyConfig *proxy_config) |
Commits modification made to the proxy configuration. More... | |
void | linphone_proxy_config_enable_publish (LinphoneProxyConfig *proxy_config, bool_t enable) |
Indicates either or not, PUBLISH must be issued for this LinphoneProxyConfig. More... | |
void | linphone_proxy_config_set_publish_expires (LinphoneProxyConfig *proxy_config, int expires) |
Set the publish expiration time in second. More... | |
int | linphone_proxy_config_get_publish_expires (const LinphoneProxyConfig *proxy_config) |
get the publish expiration time in second. More... | |
void | linphone_proxy_config_set_dial_escape_plus (LinphoneProxyConfig *proxy_config, bool_t enable) |
Sets whether liblinphone should replace "+" by international calling prefix in dialed numbers (passed to linphone_core_invite() ). More... | |
void | linphone_proxy_config_set_dial_prefix (LinphoneProxyConfig *proxy_config, const char *prefix) |
Sets a dialing prefix to be automatically prepended when inviting a number with linphone_core_invite(); This dialing prefix shall usually be the country code of the country where the user is living, without "+". More... | |
void | linphone_proxy_config_enable_quality_reporting (LinphoneProxyConfig *proxy_config, bool_t enable) |
Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035. More... | |
bool_t | linphone_proxy_config_quality_reporting_enabled (LinphoneProxyConfig *proxy_config) |
Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035. More... | |
void | linphone_proxy_config_set_quality_reporting_collector (LinphoneProxyConfig *proxy_config, const char *collector) |
Set the route of the collector end-point when using quality reporting. More... | |
const char * | linphone_proxy_config_get_quality_reporting_collector (const LinphoneProxyConfig *proxy_config) |
Get the route of the collector end-point when using quality reporting. More... | |
void | linphone_proxy_config_set_quality_reporting_interval (LinphoneProxyConfig *proxy_config, int interval) |
Set the interval between 2 interval reports sending when using quality reporting. More... | |
int | linphone_proxy_config_get_quality_reporting_interval (LinphoneProxyConfig *proxy_config) |
Get the interval between interval reports when using quality reporting. More... | |
LinphoneRegistrationState | linphone_proxy_config_get_state (const LinphoneProxyConfig *proxy_config) |
Get the registration state of the given proxy config. More... | |
const char * | linphone_proxy_config_get_domain (const LinphoneProxyConfig *proxy_config) |
Get the domain name of the given proxy config. More... | |
const char * | linphone_proxy_config_get_realm (const LinphoneProxyConfig *proxy_config) |
Get the realm of the given proxy config. More... | |
void | linphone_proxy_config_set_realm (LinphoneProxyConfig *proxy_config, const char *realm) |
Set the realm of the given proxy config. More... | |
const bctbx_list_t * | linphone_proxy_config_get_routes (const LinphoneProxyConfig *proxy_config) |
Gets the list of the routes set for this proxy config. More... | |
const LinphoneAddress * | linphone_proxy_config_get_identity_address (const LinphoneProxyConfig *proxy_config) |
Gets the identity addres of the proxy config. More... | |
bool_t | linphone_proxy_config_publish_enabled (const LinphoneProxyConfig *proxy_config) |
Gets if the PUBLISH is enabled. More... | |
const char * | linphone_proxy_config_get_server_addr (const LinphoneProxyConfig *proxy_config) |
Gets the proxy config proxy address. More... | |
int | linphone_proxy_config_get_expires (const LinphoneProxyConfig *proxy_config) |
Gets the proxy config expires. More... | |
bool_t | linphone_proxy_config_register_enabled (const LinphoneProxyConfig *proxy_config) |
Returns whether the proxy config is enabled or not. More... | |
void | linphone_proxy_config_refresh_register (LinphoneProxyConfig *proxy_config) |
Refresh a proxy registration. More... | |
void | linphone_proxy_config_pause_register (LinphoneProxyConfig *proxy_config) |
Prevent a proxy config from refreshing its registration. More... | |
const LinphoneAddress * | linphone_proxy_config_get_contact (const LinphoneProxyConfig *proxy_config) |
Return the contact address of the proxy config. More... | |
const char * | linphone_proxy_config_get_contact_parameters (const LinphoneProxyConfig *proxy_config) |
Returns the contact parameters. More... | |
void | linphone_proxy_config_set_contact_parameters (LinphoneProxyConfig *proxy_config, const char *contact_params) |
Set optional contact parameters that will be added to the contact information sent in the registration. More... | |
void | linphone_proxy_config_set_contact_uri_parameters (LinphoneProxyConfig *proxy_config, const char *contact_uri_params) |
Set optional contact parameters that will be added to the contact information sent in the registration, inside the URI. More... | |
const char * | linphone_proxy_config_get_contact_uri_parameters (const LinphoneProxyConfig *proxy_config) |
Returns the contact URI parameters. More... | |
LinphoneCore * | linphone_proxy_config_get_core (const LinphoneProxyConfig *proxy_config) |
Get the LinphoneCore object to which is associated the LinphoneProxyConfig. More... | |
bool_t | linphone_proxy_config_get_dial_escape_plus (const LinphoneProxyConfig *proxy_config) |
Returns whether or not the + should be replaced by 00. More... | |
const char * | linphone_proxy_config_get_dial_prefix (const LinphoneProxyConfig *proxy_config) |
Gets the prefix set for this proxy config. More... | |
LinphoneReason | linphone_proxy_config_get_error (const LinphoneProxyConfig *proxy_config) |
Get the reason why registration failed when the proxy config state is LinphoneRegistrationFailed. More... | |
const LinphoneErrorInfo * | linphone_proxy_config_get_error_info (const LinphoneProxyConfig *proxy_config) |
Get detailed information why registration failed when the proxy config state is LinphoneRegistrationFailed. More... | |
const char * | linphone_proxy_config_get_transport (const LinphoneProxyConfig *proxy_config) |
Get the transport from either service route, route or addr. More... | |
void | linphone_proxy_config_set_sip_setup (LinphoneProxyConfig *proxy_config, const char *type) |
SipSetupContext * | linphone_proxy_config_get_sip_setup_context (LinphoneProxyConfig *proxy_config) |
SipSetup * | linphone_proxy_config_get_sip_setup (LinphoneProxyConfig *proxy_config) |
char * | linphone_proxy_config_normalize_phone_number (LinphoneProxyConfig *proxy_config, const char *username) |
Normalize a human readable phone number into a basic string. More... | |
LinphoneAddress * | linphone_proxy_config_normalize_sip_uri (LinphoneProxyConfig *proxy_config, const char *username) |
Normalize a human readable sip uri into a fully qualified LinphoneAddress. More... | |
void | linphone_proxy_config_set_privacy (LinphoneProxyConfig *proxy_config, LinphonePrivacyMask privacy) |
Set default privacy policy for all calls routed through this proxy. More... | |
LinphonePrivacyMask | linphone_proxy_config_get_privacy (const LinphoneProxyConfig *proxy_config) |
Get default privacy policy for all calls routed through this proxy. More... | |
void | linphone_proxy_config_set_file_transfer_server (LinphoneProxyConfig *proxy_config, const char *server_url) |
Set the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml Url may be like: "https://file.linphone.org/upload.php". More... | |
const char * | linphone_proxy_config_get_file_transfer_server (const LinphoneProxyConfig *proxy_config) |
Get the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml Url may be like: "https://file.linphone.org/upload.php". More... | |
bool_t | linphone_proxy_config_avpf_enabled (LinphoneProxyConfig *proxy_config) |
Indicates whether AVPF/SAVPF is being used for calls using this proxy config. More... | |
void | linphone_proxy_config_set_avpf_rr_interval (LinphoneProxyConfig *proxy_config, uint8_t interval) |
Set the interval between regular RTCP reports when using AVPF/SAVPF. More... | |
uint8_t | linphone_proxy_config_get_avpf_rr_interval (const LinphoneProxyConfig *proxy_config) |
Get the interval between regular RTCP reports when using AVPF/SAVPF. More... | |
LinphoneAVPFMode | linphone_proxy_config_get_avpf_mode (const LinphoneProxyConfig *proxy_config) |
Get enablement status of RTCP feedback (also known as AVPF profile). More... | |
void | linphone_proxy_config_set_avpf_mode (LinphoneProxyConfig *proxy_config, LinphoneAVPFMode mode) |
Enable the use of RTCP feedback (also known as AVPF profile). More... | |
const char * | linphone_proxy_config_get_custom_header (LinphoneProxyConfig *proxy_config, const char *header_name) |
Obtain the value of a header sent by the server in last answer to REGISTER. More... | |
void | linphone_proxy_config_set_custom_header (LinphoneProxyConfig *proxy_config, const char *header_name, const char *header_value) |
Set the value of a custom header sent to the server in REGISTERs request. More... | |
const LinphoneAuthInfo * | linphone_proxy_config_find_auth_info (const LinphoneProxyConfig *proxy_config) |
Find authentication info matching proxy config, if any, similarly to linphone_core_find_auth_info. More... | |
const char * | linphone_proxy_config_get_ref_key (const LinphoneProxyConfig *proxy_config) |
Get the persistent reference key associated to the proxy config. More... | |
void | linphone_proxy_config_set_ref_key (LinphoneProxyConfig *proxy_config, const char *refkey) |
Associate a persistent reference key to the proxy config. More... | |
LinphoneProxyConfig * | linphone_proxy_config_get_dependency (LinphoneProxyConfig *proxy_config) |
Get the dependency of a LinphoneProxyConfig. More... | |
void | linphone_proxy_config_set_dependency (LinphoneProxyConfig *proxy_config, LinphoneProxyConfig *depends_on) |
Mark this proxy configuration as being dependent on the given one. More... | |
const char * | linphone_proxy_config_get_idkey (LinphoneProxyConfig *proxy_config) |
Get the idkey property of a LinphoneProxyConfig. More... | |
void | linphone_proxy_config_set_idkey (LinphoneProxyConfig *proxy_config, const char *idkey) |
Set the idkey property on the given proxy configuration. More... | |
LinphoneNatPolicy * | linphone_proxy_config_get_nat_policy (const LinphoneProxyConfig *proxy_config) |
Get The policy that is used to pass through NATs/firewalls when using this proxy config. More... | |
void | linphone_proxy_config_set_nat_policy (LinphoneProxyConfig *proxy_config, LinphoneNatPolicy *policy) |
Set the policy to use to pass through NATs/firewalls when using this proxy config. More... | |
void | linphone_proxy_config_set_conference_factory_uri (LinphoneProxyConfig *proxy_config, const char *uri) |
Set the conference factory uri. More... | |
const char * | linphone_proxy_config_get_conference_factory_uri (const LinphoneProxyConfig *proxy_config) |
Get the conference factory uri. More... | |
void | linphone_proxy_config_set_push_notification_allowed (LinphoneProxyConfig *proxy_config, bool_t allow) |
Indicates whether to add to the contact parameters the push notification information. More... | |
bool_t | linphone_proxy_config_is_push_notification_allowed (const LinphoneProxyConfig *proxy_config) |
Indicates whether to add to the contact parameters the push notification information. More... | |
bool_t | linphone_proxy_config_is_remote_push_notification_allowed (const LinphoneProxyConfig *proxy_config) |
Indicates whether to add to the contact parameters the remote push notification information (IOS only). More... | |
void | linphone_proxy_config_set_remote_push_notification_allowed (LinphoneProxyConfig *proxy_config, bool_t allow) |
Indicates whether to add to the contact parameters the remote push notification information (IOS only). More... | |
bool_t | linphone_proxy_config_is_push_notification_available (const LinphoneProxyConfig *proxy_config) |
Gets whether push notifications are available or not (Android & iOS only). More... | |
int | linphone_proxy_config_get_unread_chat_message_count (const LinphoneProxyConfig *proxy_config) |
Return the unread chat message count for a given proxy config. More... | |
void | linphone_proxy_config_set_push_notification_config (LinphoneProxyConfig *cfg, LinphonePushNotificationConfig *push_cfg) |
Sets the push notification configuration. More... | |
LinphonePushNotificationConfig * | linphone_proxy_config_get_push_notification_config (const LinphoneProxyConfig *cfg) |
Retrieves the push notification configuration. More... | |
MS2_DEPRECATED LinphoneStatus | linphone_proxy_config_set_route (LinphoneProxyConfig *proxy_config, const char *route) |
Sets a SIP route. More... | |
MS2_DEPRECATED const char * | linphone_proxy_config_get_route (const LinphoneProxyConfig *proxy_config) |
MS2_DEPRECATED const char * | linphone_proxy_config_get_identity (const LinphoneProxyConfig *cfg) |
typedef struct _LinphoneProxyConfig LinphoneProxyConfig |
Represents an account configuration to be used by LinphoneCore.
In addition to the LinphoneAuthInfo that stores the credentials, you need to configure a LinphoneProxyConfig as well to be able to connect to a proxy server.
A minimal proxy config consists of an identity address (sip:usern) and the proxy server address, ame@ domai n.tl d
If any, it will be stored inside the default configuration file, so it will survive the destruction of the LinphoneCore and be available at the next start.
The account set with linphone_core_set_default_proxy_config() will be used as default for outgoing calls & chat messages unless specified otherwise.
typedef enum _LinphoneRegistrationState LinphoneRegistrationState |
Describes proxy registration states.
It is notified via the registration_state_changed() callback in LinphoneCoreCbs.
Describes proxy registration states.
It is notified via the registration_state_changed() callback in LinphoneCoreCbs.
LinphoneStatus linphone_core_add_proxy_config | ( | LinphoneCore * | core, |
LinphoneProxyConfig * | config | ||
) |
Add a proxy configuration.
This will start registration on the proxy, if registration is enabled.
core | LinphoneCore object |
config | the LinphoneProxyConfig to add |
void linphone_core_clear_proxy_config | ( | LinphoneCore * | core | ) |
Erase all proxies from config.
core | LinphoneCore object |
LinphoneAddress* linphone_core_create_primary_contact_parsed | ( | LinphoneCore * | core | ) |
Same as linphone_core_get_primary_contact() but the result is a LinphoneAddress object instead of const char *.
core | the LinphoneCore |
LinphoneProxyConfig* linphone_core_create_proxy_config | ( | LinphoneCore * | core | ) |
Create a proxy config with default values from Linphone core.
core | LinphoneCore object |
LinphoneProxyConfig* linphone_core_get_default_proxy_config | ( | const LinphoneCore * | core | ) |
Returns the default proxy configuration, that is the one used to determine the current identity.
core | LinphoneCore object |
bool_t linphone_core_get_guess_hostname | ( | LinphoneCore * | core | ) |
Returns TRUE if hostname part of primary contact is guessed automatically.
core | the LinphoneCore |
const char * linphone_core_get_identity | ( | LinphoneCore * | core | ) |
Gets the default identity SIP address.
This is an helper function. If no default proxy is set, this will return the primary contact ( see linphone_core_get_primary_contact() ). If a default proxy is set it returns the registered identity on the proxy.
core | LinphoneCore object |
const char* linphone_core_get_primary_contact | ( | LinphoneCore * | core | ) |
Returns the default identity when no proxy configuration is used.
core | the Core |
MS2_DEPRECATED LinphoneAddress* linphone_core_get_primary_contact_parsed | ( | LinphoneCore * | core | ) |
Same as linphone_core_get_primary_contact() but the result is a LinphoneAddress object instead of const char *.
core | the LinphoneCore |
LinphoneProxyConfig* linphone_core_get_proxy_config_by_idkey | ( | LinphoneCore * | core, |
const char * | idkey | ||
) |
Search for a LinphoneProxyConfig by it's idkey.
core | the LinphoneCore object |
idkey | An arbitrary idkey string associated to a proxy configuration |
const bctbx_list_t* linphone_core_get_proxy_config_list | ( | const LinphoneCore * | core | ) |
Returns an unmodifiable list of entered proxy configurations.
core | The LinphoneCore object |
void linphone_core_refresh_registers | ( | LinphoneCore * | core | ) |
force registration refresh to be initiated upon next iterate
core | The LinphoneCore object |
void linphone_core_remove_proxy_config | ( | LinphoneCore * | core, |
LinphoneProxyConfig * | config | ||
) |
Removes a proxy configuration.
LinphoneCore will then automatically unregister and place the proxy configuration on a deleted list. For that reason, a removed proxy does NOT need to be freed.
core | LinphoneCore object |
config | the LinphoneProxyConfig to remove |
void linphone_core_set_default_proxy_config | ( | LinphoneCore * | core, |
LinphoneProxyConfig * | config | ||
) |
Sets the default proxy.
This default proxy must be part of the list of already entered LinphoneProxyConfig. Toggling it as default will make LinphoneCore use the identity associated with the proxy configuration in all incoming and outgoing calls.
core | LinphoneCore object |
config | The proxy configuration to use as the default one. |
void linphone_core_set_guess_hostname | ( | LinphoneCore * | core, |
bool_t | enable | ||
) |
Tells LinphoneCore to guess local hostname automatically in primary contact.
core | the LinphoneCore |
enable | whether to enable the guess hostname feature or not |
LinphoneStatus linphone_core_set_primary_contact | ( | LinphoneCore * | core, |
const char * | contact | ||
) |
Sets the local "from" identity.
This data is used in absence of any proxy configuration or when no default proxy configuration is set. See LinphoneProxyConfig
core | the Core |
contact | the contact to set |
bool_t linphone_proxy_config_avpf_enabled | ( | LinphoneProxyConfig * | proxy_config | ) |
Indicates whether AVPF/SAVPF is being used for calls using this proxy config.
proxy_config | LinphoneProxyConfig object. |
LinphoneStatus linphone_proxy_config_done | ( | LinphoneProxyConfig * | proxy_config | ) |
Commits modification made to the proxy configuration.
proxy_config | LinphoneProxyConfig object. |
void linphone_proxy_config_edit | ( | LinphoneProxyConfig * | proxy_config | ) |
Starts editing a proxy configuration.
Because proxy configuration must be consistent, applications MUST call linphone_proxy_config_edit() before doing any attempts to modify proxy configuration (such as identity, proxy address and so on). Once the modifications are done, then the application must call linphone_proxy_config_done() to commit the changes.
proxy_config | LinphoneProxyConfig object. |
void linphone_proxy_config_enable_publish | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | enable | ||
) |
Indicates either or not, PUBLISH must be issued for this LinphoneProxyConfig.
In case this LinphoneProxyConfig has been added to LinphoneCore, follows the linphone_proxy_config_edit() rule.
proxy_config | LinphoneProxyConfig object. |
enable | if TRUE, publish will be engaged |
void linphone_proxy_config_enable_quality_reporting | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | enable | ||
) |
Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035.
proxy_config | LinphoneProxyConfig object. |
enable | True to store quality statistics and send them to the collector, false to disable it. |
void linphone_proxy_config_enable_register | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | enable | ||
) |
Indicates either or not, REGISTRATION must be issued for this LinphoneProxyConfig.
In case this LinphoneProxyConfig has been added to LinphoneCore, follows the linphone_proxy_config_edit() rule.
proxy_config | LinphoneProxyConfig object. |
enable | if true, registration will be engaged |
const LinphoneAuthInfo* linphone_proxy_config_find_auth_info | ( | const LinphoneProxyConfig * | proxy_config | ) |
Find authentication info matching proxy config, if any, similarly to linphone_core_find_auth_info.
proxy_config | LinphoneProxyConfig object. |
LinphoneAVPFMode linphone_proxy_config_get_avpf_mode | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get enablement status of RTCP feedback (also known as AVPF profile).
proxy_config | LinphoneProxyConfig object. |
uint8_t linphone_proxy_config_get_avpf_rr_interval | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the interval between regular RTCP reports when using AVPF/SAVPF.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_conference_factory_uri | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the conference factory uri.
proxy_config | A LinphoneProxyConfig object |
const LinphoneAddress* linphone_proxy_config_get_contact | ( | const LinphoneProxyConfig * | proxy_config | ) |
Return the contact address of the proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_contact_parameters | ( | const LinphoneProxyConfig * | proxy_config | ) |
Returns the contact parameters.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_contact_uri_parameters | ( | const LinphoneProxyConfig * | proxy_config | ) |
Returns the contact URI parameters.
proxy_config | LinphoneProxyConfig object. |
LinphoneCore* linphone_proxy_config_get_core | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the LinphoneCore object to which is associated the LinphoneProxyConfig.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_custom_header | ( | LinphoneProxyConfig * | proxy_config, |
const char * | header_name | ||
) |
Obtain the value of a header sent by the server in last answer to REGISTER.
proxy_config | LinphoneProxyConfig object. |
header_name | the header name for which to fetch corresponding value |
LinphoneProxyConfig* linphone_proxy_config_get_dependency | ( | LinphoneProxyConfig * | proxy_config | ) |
Get the dependency of a LinphoneProxyConfig.
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_get_dial_escape_plus | ( | const LinphoneProxyConfig * | proxy_config | ) |
Returns whether or not the + should be replaced by 00.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_dial_prefix | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets the prefix set for this proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_domain | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the domain name of the given proxy config.
proxy_config | LinphoneProxyConfig object. |
LinphoneReason linphone_proxy_config_get_error | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the reason why registration failed when the proxy config state is LinphoneRegistrationFailed.
proxy_config | LinphoneProxyConfig object. |
const LinphoneErrorInfo* linphone_proxy_config_get_error_info | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get detailed information why registration failed when the proxy config state is LinphoneRegistrationFailed.
proxy_config | LinphoneProxyConfig object. |
int linphone_proxy_config_get_expires | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets the proxy config expires.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_file_transfer_server | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml Url may be like: "https://file.linphone.org/upload.php".
proxy_config | LinphoneProxyConfig object. |
MS2_DEPRECATED const char* linphone_proxy_config_get_identity | ( | const LinphoneProxyConfig * | cfg | ) |
const LinphoneAddress* linphone_proxy_config_get_identity_address | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets the identity addres of the proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_idkey | ( | LinphoneProxyConfig * | proxy_config | ) |
Get the idkey property of a LinphoneProxyConfig.
proxy_config | LinphoneProxyConfig object. |
LinphoneNatPolicy* linphone_proxy_config_get_nat_policy | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get The policy that is used to pass through NATs/firewalls when using this proxy config.
If it is set to NULL, the default NAT policy from the core will be used instead.
proxy_config | LinphoneProxyConfig object |
LinphonePrivacyMask linphone_proxy_config_get_privacy | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get default privacy policy for all calls routed through this proxy.
proxy_config | LinphoneProxyConfig object. |
int linphone_proxy_config_get_publish_expires | ( | const LinphoneProxyConfig * | proxy_config | ) |
get the publish expiration time in second.
Default value is the registration expiration value.
proxy_config | LinphoneProxyConfig object. |
LinphonePushNotificationConfig* linphone_proxy_config_get_push_notification_config | ( | const LinphoneProxyConfig * | cfg | ) |
Retrieves the push notification configuration.
cfg | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_quality_reporting_collector | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the route of the collector end-point when using quality reporting.
This SIP address should be used on server-side to process packets directly before discarding packets. Collector address should be a non existing account and will not receive any messages. If NULL, reports will be send to the proxy domain.
proxy_config | LinphoneProxyConfig object. |
int linphone_proxy_config_get_quality_reporting_interval | ( | LinphoneProxyConfig * | proxy_config | ) |
Get the interval between interval reports when using quality reporting.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_realm | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the realm of the given proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_ref_key | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the persistent reference key associated to the proxy config.
The reference key can be for example an id to an external database. It is stored in the config file, thus can survive to process exits/restarts.
proxy_config | LinphoneProxyConfig object. |
MS2_DEPRECATED const char* linphone_proxy_config_get_route | ( | const LinphoneProxyConfig * | proxy_config | ) |
const bctbx_list_t* linphone_proxy_config_get_routes | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets the list of the routes set for this proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_server_addr | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets the proxy config proxy address.
proxy_config | LinphoneProxyConfig object. |
LinphoneRegistrationState linphone_proxy_config_get_state | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the registration state of the given proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_proxy_config_get_transport | ( | const LinphoneProxyConfig * | proxy_config | ) |
Get the transport from either service route, route or addr.
proxy_config | LinphoneProxyConfig object. |
int linphone_proxy_config_get_unread_chat_message_count | ( | const LinphoneProxyConfig * | proxy_config | ) |
Return the unread chat message count for a given proxy config.
proxy_config | LinphoneProxyConfig object. |
void* linphone_proxy_config_get_user_data | ( | const LinphoneProxyConfig * | proxy_config | ) |
Retrieve the user pointer associated with the proxy config.
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_is_push_notification_allowed | ( | const LinphoneProxyConfig * | proxy_config | ) |
Indicates whether to add to the contact parameters the push notification information.
For IOS, it indicates to VOIP push notification.
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_is_push_notification_available | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets whether push notifications are available or not (Android & iOS only).
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_is_remote_push_notification_allowed | ( | const LinphoneProxyConfig * | proxy_config | ) |
Indicates whether to add to the contact parameters the remote push notification information (IOS only).
Default value is FALSE.
proxy_config | LinphoneProxyConfig object. |
char* linphone_proxy_config_normalize_phone_number | ( | LinphoneProxyConfig * | proxy_config, |
const char * | username | ||
) |
Normalize a human readable phone number into a basic string.
888-444-222 becomes 888444222 or +33888444222 depending on the LinphoneProxyConfig object. This function will always generate a normalized username if input is a phone number.
proxy_config | LinphoneProxyConfig object containing country code and/or escape symbol. If NULL passed, will use default configuration. |
username | the string to parse |
LinphoneAddress* linphone_proxy_config_normalize_sip_uri | ( | LinphoneProxyConfig * | proxy_config, |
const char * | username | ||
) |
Normalize a human readable sip uri into a fully qualified LinphoneAddress.
A sip address should look like DisplayName <sip:username@domain:port> . Basically this function performs the following tasks
The result is a syntactically correct SIP address.
proxy_config | LinphoneProxyConfig object containing country code, escape symbol and/or domain name. Can be NULL if domain is already provided. |
username | the string to parse |
void linphone_proxy_config_pause_register | ( | LinphoneProxyConfig * | proxy_config | ) |
Prevent a proxy config from refreshing its registration.
This is useful to let registrations to expire naturally (or) when the application wants to keep control on when refreshes are sent. However, linphone_core_set_network_reachable(lc,TRUE) will always request the proxy configs to refresh their registrations. The refreshing operations can be resumed with linphone_proxy_config_refresh_register().
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_publish_enabled | ( | const LinphoneProxyConfig * | proxy_config | ) |
Gets if the PUBLISH is enabled.
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_quality_reporting_enabled | ( | LinphoneProxyConfig * | proxy_config | ) |
Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035.
proxy_config | LinphoneProxyConfig object. |
LinphoneProxyConfig* linphone_proxy_config_ref | ( | LinphoneProxyConfig * | proxy_config | ) |
Acquire a reference to the proxy config.
proxy_config | LinphoneProxyConfig object. |
void linphone_proxy_config_refresh_register | ( | LinphoneProxyConfig * | proxy_config | ) |
Refresh a proxy registration.
This is useful if for example you resuming from suspend, thus IP address may have changed.
proxy_config | LinphoneProxyConfig object. |
bool_t linphone_proxy_config_register_enabled | ( | const LinphoneProxyConfig * | proxy_config | ) |
Returns whether the proxy config is enabled or not.
proxy_config | LinphoneProxyConfig object. |
void linphone_proxy_config_set_avpf_mode | ( | LinphoneProxyConfig * | proxy_config, |
LinphoneAVPFMode | mode | ||
) |
Enable the use of RTCP feedback (also known as AVPF profile).
proxy_config | LinphoneProxyConfig object. |
mode | the enablement mode, which can be LinphoneAVPFDefault (use LinphoneCore's mode), LinphoneAVPFEnabled (avpf is enabled), or LinphoneAVPFDisabled (disabled). |
void linphone_proxy_config_set_avpf_rr_interval | ( | LinphoneProxyConfig * | proxy_config, |
uint8_t | interval | ||
) |
Set the interval between regular RTCP reports when using AVPF/SAVPF.
proxy_config | LinphoneProxyConfig object. |
interval | The interval in seconds (between 0 and 5 seconds). |
void linphone_proxy_config_set_conference_factory_uri | ( | LinphoneProxyConfig * | proxy_config, |
const char * | uri | ||
) |
Set the conference factory uri.
proxy_config | A LinphoneProxyConfig object |
uri | The uri of the conference factory. |
void linphone_proxy_config_set_contact_parameters | ( | LinphoneProxyConfig * | proxy_config, |
const char * | contact_params | ||
) |
Set optional contact parameters that will be added to the contact information sent in the registration.
proxy_config | LinphoneProxyConfig object. |
contact_params | a string contaning the additional parameters in text form, like "myparam=something;myparam2=something_else" |
The main use case for this function is provide the proxy additional information regarding the user agent, like for example unique identifier or apple push id. As an example, the contact address in the SIP register sent will look like <sip:joe@1:50421>;apple-push-id=43143-DFE23F-2323-FA2232. 5.12 8.128 .93
void linphone_proxy_config_set_contact_uri_parameters | ( | LinphoneProxyConfig * | proxy_config, |
const char * | contact_uri_params | ||
) |
Set optional contact parameters that will be added to the contact information sent in the registration, inside the URI.
proxy_config | LinphoneProxyConfig object. |
contact_uri_params | a string containing the additional parameters in text form, like "myparam=something;myparam2=something_else" |
The main use case for this function is provide the proxy additional information regarding the user agent, like for example unique identifier or apple push id. As an example, the contact address in the SIP register sent will look like <sip:joe@1:50421;apple-push-id=43143-DFE23F-2323-FA2232>. 5.12 8.128 .93
void linphone_proxy_config_set_custom_header | ( | LinphoneProxyConfig * | proxy_config, |
const char * | header_name, | ||
const char * | header_value | ||
) |
Set the value of a custom header sent to the server in REGISTERs request.
proxy_config | LinphoneProxyConfig object. |
header_name | the header name |
header_value | the header's value |
void linphone_proxy_config_set_dependency | ( | LinphoneProxyConfig * | proxy_config, |
LinphoneProxyConfig * | depends_on | ||
) |
Mark this proxy configuration as being dependent on the given one.
The dependency must refer to a proxy config previously added to the core and which idkey property is defined.
The proxy configuration marked as dependent will wait for successful registration on its dependency before triggering its own.
Once registered, both proxy configurations will share the same contact address (the 'dependency' one).
This mecanism must be enabled before the proxy configuration is added to the core
proxy_config | LinphoneProxyConfig object. |
depends_on | The LinphoneProxyConfig this one shall be depend on. |
void linphone_proxy_config_set_dial_escape_plus | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | enable | ||
) |
Sets whether liblinphone should replace "+" by international calling prefix in dialed numbers (passed to linphone_core_invite() ).
proxy_config | LinphoneProxyConfig object. |
enable | TRUE to replace + by the international prefix, FALSE otherwise. |
void linphone_proxy_config_set_dial_prefix | ( | LinphoneProxyConfig * | proxy_config, |
const char * | prefix | ||
) |
Sets a dialing prefix to be automatically prepended when inviting a number with linphone_core_invite(); This dialing prefix shall usually be the country code of the country where the user is living, without "+".
proxy_config | LinphoneProxyConfig object. |
prefix | the prefix to set (withouth the +) |
void linphone_proxy_config_set_expires | ( | LinphoneProxyConfig * | proxy_config, |
int | expires | ||
) |
Sets the registration expiration time in seconds.
proxy_config | LinphoneProxyConfig object. |
expires | the expiration time to set |
void linphone_proxy_config_set_file_transfer_server | ( | LinphoneProxyConfig * | proxy_config, |
const char * | server_url | ||
) |
Set the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml Url may be like: "https://file.linphone.org/upload.php".
proxy_config | LinphoneProxyConfig object. |
server_url | URL of the file server. |
LinphoneStatus linphone_proxy_config_set_identity_address | ( | LinphoneProxyConfig * | proxy_config, |
LinphoneAddress * | identity | ||
) |
Sets the user identity as a SIP address.
This identity is normally formed with display name, username and domain, such as: Alice <sip:alice> The REGISTER messages will have from and to set to this identity. @exa mple. net
proxy_config | LinphoneProxyConfig object. |
identity | the LinphoneAddress of the identity to set |
void linphone_proxy_config_set_idkey | ( | LinphoneProxyConfig * | proxy_config, |
const char * | idkey | ||
) |
Set the idkey property on the given proxy configuration.
This property can the be referenced by another proxy config 'depends_on' to create a dependency relation between them.
proxy_config | LinphoneProxyConfig object. |
idkey | The idkey string to associate to the given LinphoneProxyConfig. |
void linphone_proxy_config_set_nat_policy | ( | LinphoneProxyConfig * | proxy_config, |
LinphoneNatPolicy * | policy | ||
) |
Set the policy to use to pass through NATs/firewalls when using this proxy config.
If it is set to NULL, the default NAT policy from the core will be used instead.
proxy_config | LinphoneProxyConfig object |
policy | LinphoneNatPolicy object. |
void linphone_proxy_config_set_privacy | ( | LinphoneProxyConfig * | proxy_config, |
LinphonePrivacyMask | privacy | ||
) |
Set default privacy policy for all calls routed through this proxy.
proxy_config | LinphoneProxyConfig object. |
privacy | LinphonePrivacy to configure privacy |
void linphone_proxy_config_set_publish_expires | ( | LinphoneProxyConfig * | proxy_config, |
int | expires | ||
) |
Set the publish expiration time in second.
proxy_config | LinphoneProxyConfig object. |
expires | in second |
void linphone_proxy_config_set_push_notification_allowed | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | allow | ||
) |
Indicates whether to add to the contact parameters the push notification information.
For IOS, it indicates to VOIP push notification.
proxy_config | LinphoneProxyConfig object. |
allow | TRUE to allow push notification information, FALSE otherwise. |
void linphone_proxy_config_set_push_notification_config | ( | LinphoneProxyConfig * | cfg, |
LinphonePushNotificationConfig * | push_cfg | ||
) |
Sets the push notification configuration.
cfg | LinphoneProxyConfig object. |
push_cfg | LinphonePushNotificationConfig to set. |
void linphone_proxy_config_set_quality_reporting_collector | ( | LinphoneProxyConfig * | proxy_config, |
const char * | collector | ||
) |
Set the route of the collector end-point when using quality reporting.
This SIP address should be used on server-side to process packets directly before discarding packets. Collector address should be a non existing account and will not receive any messages. If NULL, reports will be send to the proxy domain.
proxy_config | LinphoneProxyConfig object. |
collector | route of the collector end-point, if NULL PUBLISH will be sent to the proxy domain. |
void linphone_proxy_config_set_quality_reporting_interval | ( | LinphoneProxyConfig * | proxy_config, |
int | interval | ||
) |
Set the interval between 2 interval reports sending when using quality reporting.
If call exceed interval size, an interval report will be sent to the collector. On call termination, a session report will be sent for the remaining period. Value must be 0 (disabled) or positive.
proxy_config | LinphoneProxyConfig object. |
interval | The interval in seconds, 0 means interval reports are disabled. |
void linphone_proxy_config_set_realm | ( | LinphoneProxyConfig * | proxy_config, |
const char * | realm | ||
) |
Set the realm of the given proxy config.
proxy_config | LinphoneProxyConfig object. |
realm | New realm value. |
void linphone_proxy_config_set_ref_key | ( | LinphoneProxyConfig * | proxy_config, |
const char * | refkey | ||
) |
Associate a persistent reference key to the proxy config.
The reference key can be for example an id to an external database. It is stored in the config file, thus can survive to process exits/restarts.
proxy_config | LinphoneProxyConfig object. |
refkey | The reference key string to associate to the proxy config. |
void linphone_proxy_config_set_remote_push_notification_allowed | ( | LinphoneProxyConfig * | proxy_config, |
bool_t | allow | ||
) |
Indicates whether to add to the contact parameters the remote push notification information (IOS only).
proxy_config | LinphoneProxyConfig object. |
allow | TRUE to allow remote push notification information, FALSE otherwise. |
MS2_DEPRECATED LinphoneStatus linphone_proxy_config_set_route | ( | LinphoneProxyConfig * | proxy_config, |
const char * | route | ||
) |
Sets a SIP route.
When a route is set, all outgoing calls will go to the route's destination if this proxy is the default one (see linphone_core_set_default_proxy_config() ).
proxy_config | LinphoneProxyConfig object. |
route | the SIP route to set |
LinphoneStatus linphone_proxy_config_set_routes | ( | LinphoneProxyConfig * | proxy_config, |
const bctbx_list_t * | routes | ||
) |
Sets a list of SIP route.
When a route is set, all outgoing calls will go to the route's destination if this proxy is the default one (see linphone_core_set_default_proxy_config() ).
proxy_config | the LinphoneProxyConfig |
routes | A of routes |
LinphoneStatus linphone_proxy_config_set_server_addr | ( | LinphoneProxyConfig * | proxy_config, |
const char * | server_address | ||
) |
Sets the proxy address.
Examples of valid sip proxy address are:
proxy_config | LinphoneProxyConfig object. |
server_address | the proxy address to set. |
void linphone_proxy_config_set_user_data | ( | LinphoneProxyConfig * | proxy_config, |
void * | user_data | ||
) |
Assign a user pointer to the proxy config.
proxy_config | LinphoneProxyConfig object. |
user_data | The user pointer to associate with the proxy config. |
void linphone_proxy_config_unref | ( | LinphoneProxyConfig * | proxy_config | ) |
Release reference to the proxy config.
proxy_config | LinphoneProxyConfig object. |
const char* linphone_registration_state_to_string | ( | LinphoneRegistrationState | state | ) |
Human readable version of the LinphoneRegistrationState.
state | LinphoneRegistrationState the value for which we want a string representation |