linPhoneSDK 最新版移植教程，代码示例

/* linphone Copyright (C) 2000 - 2010 Simon MORLAT (simon.morlat@linphone.org) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef LINPHONECORE_H #define LINPHONECORE_H #include "ortp/ortp.h" #include "ortp/payloadtype.h" #include "mediastreamer2/mscommon.h" #include "mediastreamer2/msvideo.h" #include "mediastreamer2/mediastream.h" #include "mediastreamer2/bitratecontrol.h" #include "linphone/defs.h" #include "linphone/types.h" #include "linphone/callbacks.h" #include "linphone/sipsetup.h" #include "linphone/account_creator.h" #include "linphone/account_creator_service.h" #include "linphone/address.h" #include "linphone/auth_info.h" #include "linphone/buffer.h" #include "linphone/call.h" #include "linphone/call_log.h" #include "linphone/call_params.h" #include "linphone/call_stats.h" #include "linphone/chat.h" #include "linphone/conference.h" #include "linphone/content.h" #include "linphone/dictionary.h" #include "linphone/error_info.h" #include "linphone/event.h" #include "linphone/factory.h" #include "linphone/friend.h" #include "linphone/friendlist.h" #include "linphone/im_encryption_engine.h" #include "linphone/im_notif_policy.h" #include "linphone/info_message.h" #include "linphone/lpconfig.h" #include "linphone/misc.h" #include "linphone/nat_policy.h" #include "linphone/payload_type.h" #include "linphone/player.h" #include "linphone/presence.h" #include "linphone/proxy_config.h" #include "linphone/ringtoneplayer.h" #include "linphone/vcard.h" #include "linphone/video_definition.h" #include "linphone/xmlrpc.h" #include "linphone/headers.h" #ifdef __cplusplus extern "C" { #endif /** * Safely down-cast a belle_sip_object_t into LinphoneCore * @ingroup initializing */ #define LINPHONE_CORE(object) BELLE_SIP_CAST(object, LinphoneCore) /** * Create a #LinphoneAddress object by parsing the user supplied address, given as a string. * @param[in] lc #LinphoneCore object * @param[in] address String containing the user supplied address * @return The create #LinphoneAddress object * @ingroup linphone_address */ LINPHONE_PUBLIC LinphoneAddress * linphone_core_create_address(LinphoneCore *lc, const char *address); /** * @addtogroup misc * @{ */ /** * Create an independent media file player. * This player support WAVE and MATROSKA formats. * @param lc A LinphoneCore object * @param sound_card_name Playback sound card. If NULL, the ringer sound card set in LinphoneCore will be used * @param video_display_name Video display. If NULL, the video display set in LinphoneCore will be used * @param window_id Id of the drawing window. Depend of video out * @return A pointer on the new instance. NULL if faild. */ LINPHONE_PUBLIC LinphonePlayer *linphone_core_create_local_player(LinphoneCore *lc, const char *sound_card_name, const char *video_display_name, void *window_id); /** * Creates an empty info message. * @param lc the LinphoneCore * @return a new LinphoneInfoMessage. * * The info message can later be filled with information using linphone_info_message_add_header() or linphone_info_message_set_content(), * and finally sent with linphone_core_send_info_message(). **/ LINPHONE_PUBLIC LinphoneInfoMessage *linphone_core_create_info_message(LinphoneCore*lc); /** * Checks if a new version of the application is available. * @param lc LinphoneCore object * @param current_version The current version of the application */ LINPHONE_PUBLIC void linphone_core_check_for_update(LinphoneCore *lc, const char *current_version); /** * @} */ /** * Get the remote address of the current call. * @param[in] lc LinphoneCore object. * @return The remote address of the current call or NULL if there is no current call. * @ingroup call_control */ LINPHONE_PUBLIC const LinphoneAddress * linphone_core_get_current_call_remote_address(LinphoneCore *lc); /** * @addtogroup initializing * @{ **/ /** * Callback prototype * @deprecated * @donotwrap */ typedef void (*ShowInterfaceCb)(LinphoneCore *lc); /** * Callback prototype * @deprecated * @donotwrap */ typedef void (*DisplayStatusCb)(LinphoneCore *lc, const char *message); /** * Callback prototype * @deprecated * @donotwrap */ typedef void (*DisplayMessageCb)(LinphoneCore *lc, const char *message); /** * Callback prototype * @deprecated * @donotwrap */ typedef void (*DisplayUrlCb)(LinphoneCore *lc, const char *message, const char *url); /** * Callback prototype */ typedef void (*LinphoneCoreCbFunc)(LinphoneCore *lc,void * user_data); /** * This structure holds all callbacks that the application should implement. * None is mandatory. * @donotwrap **/ typedef struct _LinphoneCoreVTable{ LinphoneCoreGlobalStateChangedCb global_state_changed; /**<Notifies global state changes*/ LinphoneCoreRegistrationStateChangedCb registration_state_changed;/**<Notifies registration state changes*/ LinphoneCoreCallStateChangedCb call_state_changed;/**<Notifies call state changes*/ LinphoneCoreNotifyPresenceReceivedCb notify_presence_received; /**< Notify received presence events*/ LinphoneCoreNotifyPresenceReceivedForUriOrTelCb notify_presence_received_for_uri_or_tel; /**< Notify received presence events*/ LinphoneCoreNewSubscriptionRequestedCb new_subscription_requested; /**< Notify about pending presence subscription request */ LINPHONE_DEPRECATED LinphoneCoreAuthInfoRequestedCb auth_info_requested; /**< @deprecated Use authentication_requested instead. Ask the application some authentication information */ LinphoneCoreAuthenticationRequestedCb authentication_requested; /**< Ask the application some authentication information */ LinphoneCoreCallLogUpdatedCb call_log_updated; /**< Notifies that call log list has been updated */ LinphoneCoreMessageReceivedCb message_received; /**< a message is received, can be text or external body*/ LinphoneCoreCbsMessageReceivedUnableDecryptCb message_received_unable_decrypt; /**< an encrypted message is received but we can't decrypt it*/ LinphoneCoreIsComposingReceivedCb is_composing_received; /**< An is-composing notification has been received */ LinphoneCoreDtmfReceivedCb dtmf_received; /**< A dtmf has been received received */ LinphoneCoreReferReceivedCb refer_received; /**< An out of call refer was received */ LinphoneCoreCallEncryptionChangedCb call_encryption_changed; /**<Notifies on change in the encryption of call streams */ LinphoneCoreTransferStateChangedCb transfer_state_changed; /**<Notifies when a transfer is in progress */ LinphoneCoreBuddyInfoUpdatedCb buddy_info_updated; /**< a LinphoneFriend's BuddyInfo has changed*/ LinphoneCoreCallStatsUpdatedCb call_stats_updated; /**<Notifies on refreshing of call's statistics. */ LinphoneCoreInfoReceivedCb info_received; /**<Notifies an incoming informational message received.*/ LinphoneCoreSubscriptionStateChangedCb subscription_state_changed; /**<Notifies subscription state change */ LinphoneCoreNotifyReceivedCb notify_received; /**< Notifies a an event notification, see linphone_core_subscribe() */ LinphoneCorePublishStateChangedCb publish_state_changed;/**Notifies publish state change (only from #LinphoneEvent api)*/ LinphoneCoreConfiguringStatusCb configuring_status; /** Notifies configuring status changes */ LINPHONE_DEPRECATED DisplayStatusCb display_status; /**< @deprecated Callback that notifies various events with human readable