基于VSession语音通信控件（点对点）使用说明.docVIP

VSession语音通信控件(点对点)使用说明 一、简介 感谢您使用VSession语音通信控件点对点专用版，版本2.0，此版本集成了G729A压缩算法，实时传输协议，话音清晰流畅！使用简单方便！此控件是在VSession2.0版本的基础上，加入点对点通信时的呼叫，应答，挂断等通话前后的同步功能，使其用于点对点通信更加方便！如果您想要在程序中自定义点对点间的以通话联系方式，或者有一对多，多对多的语音通话的需求，请您下载使用VSession2.0版本控件即可；下载页见天空软件站：/soft/38190.html，或直接发邮件到csqmailbox@163.com索取控件及相关开发手册！ VSession语音通信控件适用于:VC＋＋,VB, NET平台，C++Builder，DELPHI,.或网页应用程序等。您只要先在系统中注册控件（双击开发包中的文件“安装.bat可完成控件的注册）然后在各种开发环境下就可以像使用一般控件一样地方便地使用了。本控件附带了多个平台的示例程序，要求打开示例程序前，先在系统中注册控件！ 二、控件提供的接口及说明： １．void Init() 功能描述：控件初始化 使用方法：应用程序启动后在使用控件其它功能前，调用一次且仅一次，完成初始化。多次执行仅第一次有效。 使用示例：VSessp2p1.Init();//示例假定控件已经被加载到应用程序中名称为VSessp2p1。 在有些开发环境中如C++Builder中是以指针形式调用！写成VSessp2p1-Init();,下同，略 出错处理：如出现初始化错误”Init Err!”，则是可能因为调用时机过早导致的！一般情况下不应在控件的父窗体的Create 事件中使用此函数。因为此时窗体还没有真正生成，可将初始化功能放在窗体Create以后的事件过程中，如VC++ 中的OnInitDialog()或OnPaint()事件，C＋＋Builder OnPaint()事件,C#中OnPaint()事件，VB中的Form_Load事件中，或者就直接放在Call()方法前面。若放在OnPaint()事件,可能会产生多次调用但这并不影响控件的使用，因为只有第一次才起作用！您也可以在程序作一些简单处理放在窗体生成以后的其它事件过程中。 ２．void Call(BSTR ipaddr) 功能描述：向目标端发送呼叫请求。 使用方法：在控件初始化后，通话开始前，调且此函数。 使用示例：VSessp2p1.Call(“”);或者 String ip=””; VSessp2p1.Call (ip); C++Builder环境中要显式使用宽字符串，此时可用系统的WideString()函数转换一下即可如： VSessp2p1-Call(WideString(“”));或VSessp2p1-Call(WideString(ip));//ip是变量。 出错处理：如出现“Send Call Note Err!”,可能是您的网络不通或有其它问题，请检查！ 3．void Hangup() 功能描述：挂断当前的通话。 使用方法：在控件初始化后，通话开始后，调且此函数，挂断通话。 使用示例：VSessp2p1.Hangup(); 出错处理：如出现“Send Hangup Note Err!”,可能是您的网络不通或有其它问题，请检查！ 三，控件的状态说明 正常情况下，控件有四种状态，与日常的电话类似 0，空闲状态，用户没有和别人通话，没有呼叫别人也没收到别人的呼叫请求时; 1，呼叫请求状态，空闲状态下，用户点了呼叫按钮时; 2，呼叫问询状态，空闲状态下，用户收到了别人的呼叫请求，要求响应时; 3，通话状态，用户正和别人通话时；除空闲状态，其它的统称为忙态； 四、点对点通信示例(假设控件加入到应用程序中后名称为VSessp2p1） A机： VSessp2p1.Init()// VSessp2p1.Call()//B机的IP …… VSessp2p1.Hangup(); 五、补充说明 本控件已经成功应用于多个开发案例中，如果您认为自行控制不方便，作者也可根据您的要求为您无偿定制，提供最适合您使用的控件！如会话控制、智能缓冲管理、噪音拟制等。 另外本控件可再开放的功能接口如下： （1）设置扬声器音量：SetSpeakerVolume； （2）设置麦克音量：SetMicrophoneVolume； (3) 静音设置：SetMute； (4)多声卡切换：支持在多个声卡中选择，切换等 六、常见问题解答 1．系统中如安装了防火墙软件，控件程序首次运行时系统会出提示，这时您应当选择（一直都）允许此应用程序的网络活动，一般网络应用程序都会有类似提示，你只要选择允许，并且勾选下次使用同样选择即可。以后便不会提示了 2．