飞环语音卡开发手册.docVIP

模拟卡开发手册 语音卡开发概述 呼叫流程 Phonic.ocx开发接口 Phonic.OCX事件 Phonic.OCX方法 Phonic.DLL开发接口 系统设置 远程实时监听 语音卡开发概述 返回上一级????????模拟语音卡均采用统一的编程接口，使得用户编程、系统升级 非常容易。模拟语音卡有两种编程接口： Phonic.OCX 控件编程接口 Phonic.DLL 动态连接库编程接口 ????????Phonic.DLL动态库编程接口与Phonic.OCX控件编程接口大致相同， 由含义相同的方法(函数)和事件组成，所不同的是： Phonic.DLL的方法有一个前缀“tpi_”，Phonic.OCX的方法没有前缀。 例如呼叫电话的方法，在Phonic.OCX控件中是MakeCall,而在Phonic.DLL中是tpi_MakeCall； 事件触发机制不一样 在Phonic.OCX上有事件触发机制，应用程序可以直接响应控件的事件，在动态连接库上没有固定的事件触发机制， 因此Phonic.DLL使用回调函数向应用程序触发事件。由于Phonic.DLL和Phonic.OCX的事件和方法完全一样,所 以本手册事件和方法的名称以控件Phonic.OCX的为准, Phonic.DLL的不再重复. 语音卡常识 ????????本系列语音卡共用到三种电话模块,即内线、外线、高阻. 内线模块 内线模块是可以直接接电话机的模块，它可以给电话机馈电、提供铃流。可以检测电话机的按键、摘机、挂机，可以实现录放音。 外线模块 外线模块接市话线或小交换机的内线。它可以检测振铃、来电号码、按键、摘机、挂机。可以呼叫别的电话,可以实现录放音。 高阻模块 高阻模块的功能是并接在市话线或小交换机的内线上，主要用来录音的电话模块，因此它没有放音的功能。此外它还可以 检测振铃、来电号码、按键、摘机、挂机。 通道类型、通道ID 通道类型表示电话线路的性质,有如下通道类型： 通道类型 对应的模块 在事件、方法中对应的值 内线通道 内线模块 1 外线通道 外线模块 2 高阻监控录音通道 高阻模块 9 空通道 未插模块 11 电话会议通道 5 扬声器通道 卡上的扬声器口 12 方法和事件的第一和第二个参数一般为：通道类型、通道ID。只要通过这两个参数，就可以区分所有类型的通道。 注意各类型通道ID都是从0开始编排。 线路ID 内线模块、外线模块、高阻模块、空模块和实际的电话线路相连。线路ID反应的是实际的模块位置，线路ID和模块的物理位置一一对应。 可以通过线路ID查询相对应的通道类型及通道ID，也可以根据通道类型和通道ID查询相对应的线路ID。 tpi_GetLineID(channelType, channelID) 根据通道类型和通道ID查询线路ID tpi_GetChannelType(lineID) 根据线路ID查询通道类型 tpi_GetChannelID(lineID) 根据线路ID查询通道ID 下面以一个例子来说明通道ID和线路ID的关系. 物理序号 模块 通道类型 通道ID 线路ID 0 内线 1 0 0 1 内线 1 1 1 2 内线 1 2 2 3 内线 1 3 3 4 外线 2 0 4 5 外线 2 1 5 6 外线 2 2 6 7 高阻 9 0 7 8 外线 2 3 8 9 外线 2 4 9 10 高阻 9 1 10 11 高阻 9 2 11 12 内线 1 4 12 13 内线 1 5 13 14 内线 1 6 14 15 内线 1 7 15 通道状态定义 通道状态表明通道当前的工作情况,有如下状态： 名称 值 含义 STATE_IDLE 0 通道空闲态 STATE_IN_CALLING 1 呼入进行态，表示有电话正在呼入 STATE_IN_RINGING 2 呼入振铃状，表示有电话已经呼入，等待应答 STATE_IN_TALK 3 呼入通话态 STATE_IN_HANGUP 4 呼入挂机态，表示在呼入通话态时，对方用户挂机 STATE_IN_RELEASE 5 呼入释放态，表示在呼入通话态时，系统挂机。 STATE_OUT_CALLING 6 呼出进行态，表示有电话正在呼出 STATE_OUT_RINGING 7 呼出振铃状，表示有电话呼出已经完成，等待对方用户应答 STATE_OUT_TALK 8 呼出通话态 STATE_OUT