mirrors/linphone-iphone
1
0
Fork 1
mirror of https://gitlab.linphone.org/BC/public/linphone-iphone.git synced 2026-02-01 02:39:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

add documentation to public methods.

Browse source
This commit is contained in:
Simon Morlat 2017-05-10 18:01:51 +02:00
parent f902451723
commit 989da9f7e5
3 changed files with 22 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
coreapi/private.h
View file

@ -415,8 +415,6 @@ void linphone_call_notify_info_message_received(LinphoneCall *call, const Linpho
LinphoneCall * linphone_call_new_outgoing(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, const LinphoneCallParams *params, LinphoneProxyConfig *cfg);
LinphoneCall * linphone_call_new_incoming(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, SalOp *op);
void _linphone_call_set_new_params(LinphoneCall *call, const LinphoneCallParams *params);
LINPHONE_PUBLIC void linphone_call_set_params(LinphoneCall *call, const LinphoneCallParams *params);
LINPHONE_PUBLIC const LinphoneCallParams * linphone_call_get_params(LinphoneCall *call);
void linphone_call_set_state(LinphoneCall *call, LinphoneCallState cstate, const char *message);
void linphone_call_set_contact_op(LinphoneCall* call);
void linphone_call_set_compatible_incoming_call_parameters(LinphoneCall *call, SalMediaDescription *md);

20
include/linphone/call.h
View file

@ -873,6 +873,26 @@ LINPHONE_PUBLIC void linphone_call_remove_callbacks(LinphoneCall *call, Linphone
*/
LINPHONE_PUBLIC LinphoneCallCbs *linphone_call_get_current_callbacks(const LinphoneCall *call);
/**
* Set call parameters - advanced and not recommended feature - use with caution.
* Local call parameters applicable to an outgoing or incoming shall usually be passed to linphone_core_invite_address_with_params() or
* linphone_call_accept_with_params().
* However, in some cases it might be desirable from a software design standpoint to modify local parameters outside of the application layer, typically
* in the purpose of implementing a custom logic including special headers in INVITE or 200Ok requests, driven by a call_state_changed listener method.
* This function accepts to assign a new LinphoneCallParams only in LinphoneCallOutgoingInit and LinphoneCallIncomingReceived states.
* @param call the LinphoneCall object
**/
LINPHONE_PUBLIC void linphone_call_set_params(LinphoneCall *call, const LinphoneCallParams *params);
/**
* Returns local parameters associated with the call.
* This is typically the parameters passed at call initiation to linphone_core_invite_address_with_params() or linphone_call_accept_with_params(), or some default
* parameters if no LinphoneCallParams was explicitely passed during call initiation.
* @param call the LinphoneCall object
* @return the call's local parameters.
**/
LINPHONE_PUBLIC const LinphoneCallParams * linphone_call_get_params(LinphoneCall *call);
/**
* @}
*/

2
include/linphone/core.h
View file

@ -5189,6 +5189,7 @@ LINPHONE_PUBLIC LinphonePresenceService * linphone_core_create_presence_service(
/**
* Notifies the upper layer that a presence status has been received by calling the appropriate
* callback if one has been set.
* This method is for advanced usage, where customization of the liblinphone's internal behavior is required.
* @param[in] lc the #LinphoneCore object.
* @param[in] lf the #LinphoneFriend whose presence information has been received.
*/
@ -5198,6 +5199,7 @@ LINPHONE_PUBLIC void linphone_core_notify_notify_presence_received(LinphoneCore
/**
* Notifies the upper layer that a presence model change has been received for the uri or
* telephone number given as a parameter, by calling the appropriate callback if one has been set.
* This method is for advanced usage, where customization of the liblinphone's internal behavior is required.
* @param[in] lc the #LinphoneCore object.
* @param[in] lf the #LinphoneFriend whose presence information has been received.
* @param[in] uri_or_tel telephone number or sip uri