[SER初步]SEMS 程序开发指南

  

SEMS application development tutorial

SEMS 程序开发指南

原文：http://www.iptel.org/howto/sems_application_development_tutorial   

免责：下面的文字是自己研究时笔记，对错不负责任：）转载请注明 MWG_arden 2007

Short description: 简述
this tutorial explains how to write SEMSⁱ applications, both in C++ and (using the IVRⁱ) in Python. All examples are available with their complete sources.

此指南展示如何用 C++ 或 Python 编写 SMES 应用程序。所有的例子都有完整的代码可以利用。

 

Steps: 步骤

The tutorial consists of the pdf document and the sources of the examples. In "semsⁱ-tutorial-apps.tgz" all examples are contained, in "sems-tutorial-app-xxx" only one module. "ccard_wav.tgz" is an archive with sample announcements for the calling card application.

指南包括一份 pdf 文档和示例的代码。在 "semsⁱ-tutorial-apps.tgz" 中包含了所有的示例，在 "sems-tutorial-app-xxx" 中只包含 ”xxx” 模块。 "ccard_wav.tgz" 是 calling card 应用程序需要的声音文件。

 

We will download SER and SEMS, add the applications from the howto and start SER and SEMS from their source directories. If you install SER/SEMS using make install you will have to adapt the paths in the configuration files.

我们需要下载 SER 和 SEMS ，添加应用程序并从 SER 和 SEMS 的代码目录启动它们。如果安装 SER/SEMS 时使用了 ”make install” ，你需要修改配置文件中的一些目录。

 

We will place SER and SEMS source trees under /usr/local/src, make sure that you have the appropriate rights to create files there.

我们将 SER 和 SEMS 代码树放在 under /usr/local/src 目录下，请确认你使用的用户拥有此目录建立文件的权限。

 

We will use two SER instances: one, at port 5060, will be the home proxy, and one, at port 5070, will be the SIPi stack of SEMS. The SER/SEMS combination at port 5070 acts just like another UA.

我们将使用两个 SER 实例：一个监听 5060 端口，做为本地代理，另一个监听 5070 端口，做为 SEMS 的 SIP 栈。 SER/SEMS 绑定在 5070 端口，扮演用户代理 (UA) 的角色。

 

Download and make SER 0.9.6

下载并编译 SER 0.9.6

译注：下面都是命令，我只大概介绍命令的作用 

cd /usr/local/src   进入 /usr/local/src 目录
cvs -d :pserver:anonymous@cvs.berlios.de:/cvsroot/serⁱ co -r rel_0_9_0 -d ser-0.9.6 sip_router   从 CVS 上下载源代码
cd ser-0.9.6 ; make ; make modules 进入源代码目录并编译

 

Download SEMS

下载SEMS

我们可以使用 0.10.0 版的源码包或者从 SVN 直接签出

Either we use the tarball of 0.10.0 rc1
cd /usr/local/src ; 到目录
wget ftp://ftp.iptel.org/pub/sems/sems-0.10.0_rc1.tar.gz ; 下载源码包
tar xzvf sems-0.10.0_rc1.tar.gz ; mv sems-0.10.0_rc1 ; sems-0.10.0 解包，改目录名。 mv sems-0.10.0_rc1 ; sems-0.10.0 应该去掉中间的 ”;”

or we checkout trunkⁱ SEMS from SVN:

cd /usr/local/src ; 到目录
svn checkout http://svn.berlios.de/svnroot/repos/sems/trunk ; 从 SVN 签出
mv trunk sems-0.10.0 修改目录名

Download the tutorial's applications

下载指南示例程序

cd /usr/local/src/sems-0.10.0/apps ; 到目录
wget http://www.iptel.org/files/sems-tutorial-apps.tgz ; 下载
tar xzvf sems-tutorial-apps.tgz ; rm sems-tutorial-apps.tgz 解包，删除原始包

Make SEMS

编译SEMS

cd /usr/local/src/sems-0.10.0/ ; 到目录
make 编译
ignoring (for the moment) some error messages complaining about mp3/lame,python or flite.h not found.

忽略掉一些 mp3/lame 、 python 及没找到 flite.h 的错误消息

Download the sample configuration files for the tutorial

下载示例配置文件

A set of sample configuration files for SER and SEMS is available for this tutorial. 这里有一些用于本文的 SER/SEMS 示例配置文件

cd /usr/local/src ; wget http://www.iptel.org/files/sems-tutorial-config.tgz;
tar xzvf sems-tutorial-config.tgz 到目录；下载；解包；

Download the sample wave file set for the cc application

下载cc程序的示例声音文件

cd /usr/local/src/sems-tutorial-config ; wget http://www.iptel.org/files/ccard_wav.tgz;
tar xzvf ccard_wav.tgz 到目录；下载；解包；

Start SER home proxy

启动SER本地代理

We will start one SER at port 5060, that will forward all calls that come to a number starting with 1 to "localhost:5070".

我们在端口 5060 启动一个 SER ，它将所有开头为 1 的呼叫传给 "localhost:5070"

cd /usr/local/src/ser-0.9.6 ; ./ser -f ../sems_tutorial_config/ser_main.cfg 到目录；启动 ser 配置文件为 ../sems_tutorial_config/ser_main.cfg

Start SER for SEMS

启动用于SEMS的SER

The second SER at port 5070, will forward all calls to SEMS. 第二个 SER 监听端口 5070 ，它将所有呼叫传给 SEMS

cd /usr/local/src/ser-0.9.6 ; ./ser -f ../sems_tutorial_config/ser_sems.cfg 到目录；启动 ser 配置文件为 ../sems_tutorial_config/ser_sems.cf

Start SEMS

启动SEMS

cd /usr/local/src/sems-0.10.0/core ; ./sems -f ../../sems_tutorial_config/sems.conf

到目录；启动 SEMS 配置文件为 ../../sems_tutorial_config/sems.conf

The SEMS configuration is set to no-forkⁱ and debug, such that we can follow all debug logging of SEMS.

SEMS 配置文件设置为 no-fork 及 debug ，我们可以跟踪到所有 debug 信息

Try out the applications

尝试这些程序

Now we can try out the applications by calling the numbers 101, 102, 103, ...

现在我们可以通过呼叫号码 101, 102, 103, ... 来试验一下这些应用程序，下面是号码对应的程序

101	myapp
102	myconfigurableapp
103	myannounceapp
104	myjukebox
105	mycc
106	ivr_announce
110	echo
111	announcement
112	conference
113	mailbox
114	early_announce
115	voicemail

Notes: 注意

• default ivr script path is set to ivr_announce source dir, change this in ivr.conf if you want to try other python apps (mailbox, or your own scripts)

默认的 ivr 脚本路径设置为 ivr_announce 代码目录，如果你想尝试其他 python 程序如 mailbox ，可以在 ivr.conf 修改这个设置。

• If the ivr doesnt want to build, you probably have to set the python path prefix,version and no TTS/flite path in apps/ivr/Makefile.defs (see doc/COMPILING)

如果不想建立 ivr ，你需要在 apps/ivr/Makefile.defs 中设置 python 路径前缀，版本及 no TTS/flite 。

Have Fun! 玩的开心 ……..

Attachment 附件	Size 大小
semsng-app_module_tutorial.pdf	161 KB
sems-tutorial-apps.tgz	6.96 KB
sems-tutorial-app-annc_service.tgz	1.25 KB
sems-tutorial-app-cc_acc.tgz	1.19 KB
sems-tutorial-app-ivr_announce.tgz	606 bytes
sems-tutorial-app-myannounceapp.tgz	1.21 KB
sems-tutorial-app-myapp.tgz	787 bytes
sems-tutorial-app-mycc.tgz	3.1 KB
sems-tutorial-app-myconfigurableapp.tgz	1.14 KB
sems-tutorial-app-myjukebox.tgz	1.35 KB
ccard_wav.tgz	295.77 KB
sems-tutorial-config.tgz	3.47 KB