操作系統(tǒng) ：CentOS 7.6_x64
FreeSWITCH版本 ：1.10.9
之前寫過FreeSWITCH添加自定義endpoint的文章，今天整理下api及app開發(fā)的筆記。歷史文章可參考如下鏈接：
FreeSWITCH添加自定義endpoint
FreeSWITCH添加自定義endpoint之媒體交互
一、常用函數(shù)介紹
這里列舉下開發(fā)過程中常用的函數(shù)。
1、根據(jù)uuid查詢session
使用switch_core_session_locate宏進(jìn)行查詢。
定義如下：
#define switch_core_session_locate(uuid_str) switch_core_session_perform_locate(uuid_str, FILE, SWITCH_FUNC, LINE)
示例如下：
switch_core_session_t *session; if ((session = switch_core_session_locate(uuid))) { switch_channel_t *tchannel = switch_core_session_get_channel(session); val = switch_channel_get_variable(tchannel, varname); switch_core_session_rwunlock(session); }
查詢session后，需要使用switch_core_session_rwunlock函數(shù)釋放鎖。
2、獲取session的uuid
使用 switch_core_session_get_uuid 函數(shù)根據(jù)session查詢uuid。定義如下：
SWITCH_DECLARE(char *) switch_core_session_get_uuid(_In_ switch_core_session_t *session);
示例如下：
const char *uuid = switch_core_session_get_uuid(session);
3、根據(jù)session獲取channel
_Ret_ SWITCH_DECLARE(switch_channel_t *) switch_core_session_get_channel(_In_ switch_core_session_t *session);
示例如下：
switch_channel_t *tchannel = switch_core_session_get_channel(session);
4、channel操作
- switch_channel_set_name
設(shè)置通道名稱，通常以 endpoint 類型作為前綴，比如"sofia/1001"、"rtc/1002"等。
- switch_channel_get_name
獲取通道名稱。
- switch_channel_set_variable
設(shè)置通道變量的值。
- switch_channel_get_variable
獲取通道變量的值。
- switch_channel_set_flag
設(shè)置channel的標(biāo)記
- switch_channel_ready
判斷channel是否就緒
- switch_channel_set_caller_profile
設(shè)置profile屬性
更多內(nèi)容channel操作可參考 switch_channel.h 文件。
二、查看已有api及app
使用 show modules 顯示所有api、app及mod對應(yīng)關(guān)系。
效果如下：
?如需查看單個(gè)模塊包含的api及app，可以在后面加上模塊名稱，比如：
show modules mod_db
三、新增api命令
通過SWITCH_STANDARD_API進(jìn)行添加。
比如添加如下命令：
ctest_update_token <uuid> <token>
示例代碼如下：
/* <uuid> <token> */ SWITCH_STANDARD_API(ctest_update_token_function) { char *argv[3]; char *mydata; char *uuid, *token; if (zstr(cmd)) { stream->write_function(stream, "-ERR Parameter missing\n"); return SWITCH_STATUS_SUCCESS; } if (!(mydata = strdup(cmd))) { return SWITCH_STATUS_FALSE; } if (!switch_separate_string(mydata, ' ', argv, (sizeof(argv) / sizeof(argv[0]))) || !argv[0]) { goto end; } uuid = argv[0]; token = argv[1]; if (zstr(uuid) || zstr(token)) { goto end; } switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO,"uuid : %s , token : %s\n",uuid,token); end: switch_safe_free(mydata); return SWITCH_STATUS_SUCCESS; }
在模塊加載函數(shù)（mod_ctest_load）添加入口：
switch_api_interface_t *api_interface; SWITCH_ADD_API(api_interface, "ctest_update_token", "update ctest channel token", ctest_update_token_function,"<uuid> <token>");
設(shè)置自動填充uuid：
switch_console_set_complete("add ctest_update_token ::console::list_uuid");
?運(yùn)行效果如下：
四、新增app命令
通過 SWITCH_STANDARD_APP 添加，這里就不詳細(xì)描述了，具體看下?echo 這個(gè)app：文章來源：http://www.zghlxwxcb.cn/news/detail-711152.html
mod/applications/mod_dptools/mod_dptools.c ：2317 SWITCH_STANDARD_APP(echo_function) { switch_ivr_session_echo(session, NULL); }
好，就這么多了，希望對你有幫助。文章來源地址http://www.zghlxwxcb.cn/news/detail-711152.html
到了這里，關(guān)于FreeSWITCH添加自定義endpoint之a(chǎn)pi及app開發(fā)的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
