Liblinphone 3.9.1中文--Modules--Managing call logs

Managing call logs     管理通话记录

宏

    #define linphone_call_log_get_from(cl)  linphone_call_log_get_from_address(cl)

    #define linphone_call_log_get_to(cl)  linphone_call_log_get_to_address(cl)

    #define linphone_call_log_set_user_pointer(cl,ud) linphone_call_log_set_user_data(cl,ud)

    #define linphone_call_log_get_user_pointer(cl)  linphone_call_log_get_user_data(cl)

自定义

        typedef enum _LinphoneCallDir LinphoneCallDir

        typedef enum _LinphoneCallStatus LinphoneCallStatus

        typedef struct _LinphoneCallLog  LinphoneCallLog

枚举类型

       enum  _LinphoneCallDir{

                 LinphoneCallOutgoing,

                 LinphoneCallIncoming

                }

 

      enum  _LinphoneCallStatus{

                LinphoneCallSuccess,

                LinphoneCallAborted,

                LinphoneCallMissed,

                LinphoneCallDeclined,

              }

函数

const char *	linphone_call_log_get_call_id (const LinphoneCallLog*cl)
LinphoneCallDir	linphone_call_log_get_dir (LinphoneCallLog *cl)
int	linphone_call_log_get_duration (LinphoneCallLog *cl)
LinphoneAddress *	linphone_call_log_get_from_address (LinphoneCallLog*cl)
const rtp_stats_t *	linphone_call_log_get_local_stats (constLinphoneCallLog *cl)
float	linphone_call_log_get_quality (LinphoneCallLog *cl)
const char *	linphone_call_log_get_ref_key (const LinphoneCallLog*cl)
LinphoneAddress *	linphone_call_log_get_remote_address (LinphoneCallLog*cl)
const rtp_stats_t *	linphone_call_log_get_remote_stats (constLinphoneCallLog *cl)
time_t	linphone_call_log_get_start_date (LinphoneCallLog *cl)
LinphoneCallStatus	linphone_call_log_get_status (LinphoneCallLog *cl)
LinphoneAddress *	linphone_call_log_get_to_address (LinphoneCallLog *cl)
void	linphone_call_log_set_ref_key (LinphoneCallLog *cl, const char *refkey)
bool_t	linphone_call_log_video_enabled (LinphoneCallLog *cl)
char *	linphone_call_log_to_str (LinphoneCallLog *cl)
bool_t	linphone_call_log_was_conference (LinphoneCallLog *cl)
void *	linphone_call_log_get_user_data (const LinphoneCallLog*cl)
void	linphone_call_log_set_user_data (LinphoneCallLog *cl, void *ud)
LinphoneCallLog *	linphone_call_log_ref (LinphoneCallLog *cl)
void	linphone_call_log_unref (LinphoneCallLog *cl)
void	linphone_call_log_destroy (LinphoneCallLog *cl)
const bctbx_list_t *	linphone_core_get_call_logs (LinphoneCore *lc)
bctbx_list_t *	linphone_core_get_call_history_for_address(LinphoneCore *lc, const LinphoneAddress *addr)
LinphoneCallLog *	linphone_core_get_last_outgoing_call_log (LinphoneCore*lc)
LinphoneCallLog *	linphone_core_find_call_log_from_call_id (LinphoneCore*lc, const char *call_id)
void	linphone_core_clear_call_logs (LinphoneCore *lc)
int	linphone_core_get_missed_calls_count (LinphoneCore *lc)
void	linphone_core_reset_missed_calls_count (LinphoneCore*lc)
void	linphone_core_remove_call_log (LinphoneCore *lc,LinphoneCallLog *call_log)

详细描述

宏定义文档

     #define linphone_call_log_get_from(cl)  linphone_call_log_get_from_address(cl)

     已弃用：

               用linphone_call_log_get_from_address()代替

    #define linphone_call_log_get_to(cl)  linphone_call_log_get_to_address(cl)

    已弃用：

               用linphone_call_log_get_to_address()代替

    #define linphone_call_log_get_user_pointer(cl)  linphone_call_log_get_user_data(cl)

    已弃用：

               用linphone_call_log_get_user_data()代替

    #define linphone_call_log_set_user_pointer(cl,ud)  linphone_call_log_set_user_data(cl,ud)

    已弃用：

               用linphone_call_log_set_user_data()代替

自定义文档

        typedef enum _LinphoneCallDir LinphoneCallDir

         

         typedef struct _LinphoneCallLog LinphoneCallLog

         结构体 代表一个通过记录

    

         typedef enum _LinphoneCallStatus LinphoneCallStatus

         枚举 代表通话的状态

枚举类型文档

        enum _LinphoneCallDir

        代表一个通话的方向

        枚举成员

                  LinphoneCallOutgoing   传出通话

                  LinphoneCallIncoming   传入通话

        enum _LinphoneCallStatus

        枚举代表通话的状态

        枚举成员

                   LinphoneCallSuccess   通话成功

                   LinphoneCallAborted   通话中止

                   LinphoneCallMissed    错过通话（没有答复）

                   LinphoneCallDeclined   通话被拒绝，在本地或者远程端.

函数文档

       void linphone_call_log_destroy(LinphoneCallLog* cl)

       销毁一个LinphoneCallLog对象

       参数

               cl LinphoneCallLog对象

       已弃用：

                 用linphone_call_log_unref()代替

       char* linphone_call_log_get_call_id(const LinphoneCallLog* cl)

       获取通话id

       参数

              [in] cl LinphoneCallLog对象

       返回

              通话id的字符串形式

       LinphoneCallDir linphone_call_log_get_dir(LinphoneCallLog* cl)

       获取通话的方向

       参数

               [in] cl LinphoneCallLog 对象

       返回

                通话的方向

     

       int linphone_call_log_get_duration(LinphoneCallLog* cl)

       获取通话时长（从接通算起）

        参数

                [in] cl LinphoneCallLog对象

        返回

                通话的时长 以秒为单位

       LinphoneAddress* linphone_caoll_log_get_from_address(LinphoneCallLog* cl)

       获取通话的源地址（即from）

       参数

                [in] cl LinphoneCallLog对象

       返回

                源地址（即from）

       const rtp_stats_t* linphone_call_log_get_local_stats(const LinphoneCallLog* cl)

       获取关于该通话在本地计算的RTP统计数据

       参数

                [in]  cl  LinphoneCallLog对象

       返回

                RTP统计数据

       

       float linphone_call_log_get_quality(LinphoneCallLog* cl)

       获取通话的整体质量指示

       参数

                [in] cl LinphoneCallLog对象

       返回

                质量指标

       const char* linphone_call_log_get_ref_key(const LinphoneCallLog* cl)

       获取与指定通话记录相关联的持久性引用键

       引用键可用是例如一个外部数据库的id.它保存在配置文件中，因此可以在退出/重启中存活

       参数

               [in] cl LinphoneCallLog对象

       返回

                已经关联到指定通话记录的引用键的字符串形式，如果没有相关联的引用键返回NULL

       LinphoneAddress* linphone_call_log_get_remote_address(LinphoneCallLog* cl)

       获取远程地址（是from还是to，取决于通话的方向）

       参数

               [in]  cl LinphoneCallLog对象

       返回

                通话的远端地址

        const rtp_stats_t* linphone_call_log_get_remote_stats(const LinphoneCallLog* cl)

        获取由远端计算的RTP统计数据，并由RTCP发回来

        注意：

               还没实现.

        参数

               [in] cl LinphoneCallLog 对象

        返回

               RTP统计数据 

        time_t linphone_call_log_get_start_date(LinphoneCallLog* cl)

        获取通话的开始时间

        参数

                [in] cl LinphoneCallLog 对象

        返回

                通话的开始时间

        LinphoneCallStatus linphone_call_log_get_status(LinphoneCallLog* cl)

        获取通话的状态

        参数

                [in] cl LinphoneCallLog对象

        返回

                通话的状态

 

         LinphoneAddress* linphone_call_log_get_to_address(LinphoneCallLog* cl)

         获取通话的目的地址（即为to）

         参数

                 [in] cl LinphoneCallLog对象

         返回

                 通话的目标地址（即to）

         void* linphone_call_log_get_user_data(const LinphoneCallLog* cl)

         获取与通话相关的用户数据指针

         参数

                  [in] cl  LinphoneCallLog 对象

         返回

                  与通话记录相关的用户指针

         LinphoneCallLog* linphone_call_log_ref(LinphoneCallLog* cl)

         获取指定通话记录的引用

         参数

                   [in] cl  LinphoneCallLog对象

         返回

                   一样的LinphoneCallLog对象

         void linphone_call_log_set_ref_key(LinphoneCallLog* cl, const char* refkey)

         设置cl的持久性引用键

         引用键可以是例如一个外部数据库的id.它保存到配置文件，因此可以在退出/重启中存活

         参数

                 [in] cl LinphoneCallLog 对象

                 [in] refkey 与通话记录有关的引用键字符串

         void linphone_call_log_set_user_data(LinphoneCallLog* cl, void* ud)

         设置通话记录的用户数据

         参数

                 [in] cl LinphoneCallLog对象

                 [in] ud 与通话记录相关联的用户数据

 

         char* linphone_call_log_to_str(LinphoneCallLog* cl)

         获取描述通话记录的人类可读的字符串

         注意：

                 ：返回的字符串必须有应用程序释放（用ms_free()）

         参数

                [in]  cl LinphoneCallLog对象

         返回

                  一个描述通话记录的可读字符串

         void linphone_call_log_unref(LinphoneCallLog* cl)

         释放一个通话记录的引用

         参数

                 [in] cl LinphoneCallLog对象

 

         bool_t linphone_call_log_video_enabled(LinphoneCallLog* cl)

         判断在通话结束后视频是否启用。

         参数

                [in] cl LinphoneCallLog对象

         返回

                布尔值

 

         bool_t linphone_call_log_was_conference(LinphoneCallLog* cl)

         判断通话是否为一个会议服务的通话.

         参数

                [in] cl LinphoneCallLog对象

         返回

                如果通话为一个会议服务的通话返回TRUE.

         void linphone_core_clear_call_logs(LinphoneCore* lc)

         擦除通话记录

         参数

                 [in] lc LinphoneCore对象

         LinphoneCallLog* 

         linphone_core_find_call_log_from_call_id(LinphoneCore* lc, const char* call_id)

         获取与call_id相匹配的通话记录,如果没有找到对应的通话记录返回NULL.

         参数

                   [in] lc  LinphoneCore对象

                   [in] call_id 需要查找的通话记录的id

         返回

                  ｛LinphoneCallLog}

          bctbx_list_t* linphone_core_get_call_history_for_address(LinphoneCore* lc, const LinphoneAddress* addr)

          获取与与给定的LinphoneAddress相匹配的通话记录列表.

          在linphone_core_get_call_logs的反面，你需要释放记录，你一旦用它完成操作，释放该列表.

          参数

                    [in] lc LinphoneCore对象

                    [in] addr LinphoneAddress对象

          返回

                    一个LinphoneCallLog对象的列表

          const bctbx_list_t* linphone_core_get_call_logs(LinphoneCore* lc)

          获取通话记录的列表

          参数

                      [in] lc LinphoneCore对象

          返回

                      LinphoneCallLog对象的列表

  

           LinphoneCallLog* linphone_core_get_last_outgoing_call_log(LinphoneCore* lc)

           获取最近的传出通话记录

           参数

                     [in] lc  LinphoneCore对象

           返回

                      ｛LinphoneCallLog｝

     

     

           int linphone_core_get_missed_call_count(LinphoneCore* lc)

           获取未接电话的数量.一旦检查完毕，这个计数器可以用linphone_core_reset_missed_calls_count()

           参数

                    [in] lc  LinphoneCore对象

           返回

                    未接电话数

            void linphone_core_remove_call_log(LinphoneCore* lc, LinphoneCallLog* call_log)

            从历史记录列表中移除指定的通话记录.这个函数销毁通话记录对象. 调用这个函数之后不能再访问销毁的通话记录对象

            参数

                     [in] lc  LinphoneCore对象

                     [in] call_log  LinphoneCallLog对象   需要移除的通话记录

            void linphone_core_reset_missed_calls_count(LinphoneCore* lc)

            重置未接电话的计数

            参数

                      [in] lc  LinphoneCore对象