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

来源：互联网发布：php零基础到项目实战编辑：程序博客网时间：2024/06/05 17:25

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对象

0 0