电话录音盒和录音卡开发手册.doc

录通科技 话录通系列电话录音盒和录音卡快速开发手册录通博创科贸（北京）有限公司Lutongbochuang Technology and Trading (Beijing)Co.，Ltd前 言尊敬的用户：您好！感谢您选用本公司生产的【话录通】系列产品！为了使您轻松自如地操作【话录通】系列产品，请在使用本产品前详细阅读产品使用手册。本公司对于因软件、硬件的误操作或其它意外情况所引起的数据资料的丢失和损坏不负任何责任，也不对由此而造成的其它间接损失负责，请随时备份您的数据资料，确保它们的安全。同时我们无法控制用户对本手册可能造成的误解，因此，本公司将不对在使用本手册过程中可能出现的意外损失负责，并不对因使用该产品而引起的第三方索赔负责。本手册中的信息如有变更，恕不另行通知。本手册信息受到版权保护，其任何部分未经本公司事先书面许可，不准以任何方式影印和复制。产品及产品颜色款式等请以购买的实物为准。本公司保留对本手册及其相关资料的最终解释权。一、产品概述及功能介绍当今，电脑和电话已经成为我们日常办公的必备物品。如何把电脑、电话、办公信息三者更好地结合起来，提高我们的工作效率，这是录通人不断追求的目标。录通科技的【话录通】系列产品把电话与电脑进行无缝链接，发挥强大的客户资料管理，清晰的电话录音备份功能，大大提高员工的工作效率，节约公司资源。录通科技的【话录通】系列产品包括录通USB 1-2-4-8-12-16路数字录音盒和录通PCI 4-8-12-16路数字录音卡，以及配套的一系列电话客户管理、语音、传真、短信等软件组成。【话录通】系列产品提供二次开发接口，只是在你的程序中调用动态库中的几个函数，便可以在你的软件中增加以下功能：双制式来电显示。结合软件可以在有电话打入时系统会自动弹出来电信息，同时伴随语音提示播报来电号码；可以自动记录拨出电话号码。全自动电话录音。结合软件可以进行普通电话录音及查询；对打入打出的普通电话实时录音，备份到电脑可供日后查询。软件加密功能。提供硬件开发商定制密码，保护你的软件和硬件。二、系统要求以下列出的是使用【话录通】系列产品的推荐计算机配置硬件需求：INTEL 奔腾3以上CPU,建议 PIII-500以上等级。256MB 以上内存。20G以上硬盘空间操作系统WIN98、WIN2000、WINXP、WIN2003、Win7特别提示：用户计算机最好具备一块可以正常使用的声卡；三、【话录通】系列硬件安装指南USB录音盒连接到电脑的USB接口即可，不需要外接电源。PCI录音卡插到台式机的PCI插槽中。四、【话录通】系列硬件开发说明录通系列录音盒和录音卡采用统一开发接口，一次开发多硬件灵活选择使用；具有摘挂机检测、振铃检测、双制式来电号码检测、拨出号码检测、电话录音等功能，独有的硬件开发专业加密技术，方便你的开发。USB录音盒有路、2路、4路、8路、12路、16路，在每台计算机上可以连接一台；PCI录音卡4路、8路、12路、16路，可以在电脑的PCI插槽中放置多个使用，最多可以对128路电话进行录音。开发动态库只有一个DLL就是“LtPhoneRec.dll”。这个DLL可以适用于录通系列的USB 1到16路录音盒和PCI 1到16路录音卡，更换硬件也无须修改程序和替换DLL，大大节省你的开发和维护成本。1 硬件初始化函数（VB参考函数）Public Declare Function Lt_InitialCard Lib LtPhoneRec.dll (ByVal UserId As Long, ByVal UserIdSn As Long, ByVal UserPass As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_InitialCard(DWORD UserId, DWORD UserIdSn, DWORD UserPass)（Delphi参考函数）function Lt_InitialCard(UserId:Integer;UserIdSn:Integer;UserPass:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：该函数是录音卡初始化函数。应用程序开始时，必须首先调用该函数。如果不是定做硬件就直接三个参数赋值为0（例如Lt_InitialCard(0,0,0)）。如果是定做硬件，此处应该为我们公司提供给你的和定做硬件对应的三组密码（例如Lt_InitialCard(333333,444444,5555555)）。参数：三个参数为定做密码。如非定做，直接赋值为0。返回值：1为成功。0为失败。2 关闭硬件函数 （VB参考函数）Public Declare Function Lt_ReleaseCard Lib LtPhoneRec.dll () As Boolean（C+参考函数）BOOL WINAPI Lt_ReleaseCard(void)（Delphi参考函数）function Lt_ReleaseCard(): Bool; stdcall; far external LtPhoneRec.dll;功能：该函数是关闭硬件函数。应用程序结束前时，必须调用该函数关闭硬件。参数：无参数。返回值：True为成功。False为失败。3 系统总电话线路数（VB参考函数）Public Declare Function Lt_GetLineIdNumber Lib LtPhoneRec.dll () As Integer（C+参考函数）DWORD WINAPI Lt_GetLineIdNumber(void);（Delphi参考函数）function Lt_GetLineIdNumber(): Integer; stdcall; far external LtPhoneRec.dll;功能：得到系统的电话线路数。参数：无参数。返回值：整数，电脑上安装的录音盒和录音卡的总线路数。4 录音卡数量（VB参考函数）Public Declare Function Lt_GetCardNumber Lib LtPhoneRec.dll () As Integer（C+参考函数）DWORD WINAPI Lt_GetCardNumber(void);（Delphi参考函数）function Lt_GetCardNumber(): Integer; stdcall; far external LtPhoneRec.dll;功能：得到系统的录音盒或录音卡数量。参数：无参数。返回值：整数，电脑上安装的录音盒和录音卡的数量。5 摘挂机检测函数（VB参考函数）Public Declare Function Lt_PhoneIsPickUp Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_PhoneIsPickUp(DWORD LineId);（Delphi参考函数）function Lt_PhoneIsPickUp(LineId:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：得到某一路电话的摘挂机状态。参数：LineId为第几路电话。返回值：True为挂机，False为摘机。6 振铃检测函数（VB参考函数）Public Declare Function Lt_PhoneIsRing Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_PhoneIsRing(DWORD LineId);（Delphi参考函数）function Lt_PhoneIsRing(LineId:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：得到某一路电话的振铃状态。参数：LineId为第几路电话。返回值：True为振铃，False为没有振铃。7 拨出号码显示（双音收号）初始化函数（VB参考函数）Public Declare Function Lt_ReadyReceiveDtmf Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）void WINAPI Lt_ReadyReceiveDtmf(DWORD LineId);（Delphi参考函数）procedure Lt_ReadyReceiveDtmf(LineId:Integer); stdcall; far external LtPhoneRec.dll;功能：每次收号前，即一般再摘机后，调用该函数，初始化相应的收号缓冲区。如果来电显示信号为Dtmf, 必须在调用Lt_ReadyReceiveDtmf后才能调用本函数。参数：LineId为第几路电话。返回值：True为成功。False为失败。8 拨出号码显示（双音收号）函数（VB参考函数）Public Declare Function Lt_GetDtmfStr Lib LtPhoneRec.dll (ByVal LineId As Long) As Integer（C+参考函数）DWORD WINAPI Lt_GetDtmfStr(DWORD LineId);（Delphi参考函数）function Lt_GetDtmfStr(LineId:Integer): Integer; stdcall; far external LtPhoneRec.dll;功能：拨出号码显示（双音收号）。参数：LineId为第几路电话。返回值：返回的收号有效值为0-9，14，15，其中14=*，15=#。255为无效值，即未收到号。9 来电显示收号初始化函数（VB参考函数）Public Declare Function Lt_ReadyReceiveCid Lib LtPhoneRec.dll (ByVal LineId As Long)（C+参考函数）void WINAPI Lt_ReadyReceiveCid(DWORD LineId);（Delphi参考函数）procedure Lt_ReadyReceiveCid(LineId:Integer); stdcall; far external LtPhoneRec.dll;功能：在每次挂机后，调用该函数，初始化相应的收号缓冲区。参数：LineId为第几路电话。返回值：无。10 来电显示收号函数 （VB参考函数）Public Declare Function Lt_GetCidStr Lib LtPhoneRec.dll (ByVal LineId As Long, ByVal DateTimeStr As String, ByVal NubmerStr As String, ByVal NameStr As String) As Boolean（C+参考函数）BOOL WINAPI Lt_GetCidStr(DWORD LineId, LPSTR DateTimeStr,LPSTR NubmerStr,LPSTR NameStr);（Delphi参考函数）function Lt_GetCidStr(LineId:Integer;DateTimeStr:Pchar;NubmerStr:Pchar;NameStr:Pchar): Bool; stdcall; far external LtPhoneRec.dll;功能：来电显示收号函数,系统自动识别来电显示格式是DTMF还是FSK，是简单消息还是复合消息。参数：LineId为第几路电话。DateTimeStr为日期和时间：MMDDHHMM,即月日时分,均占2位，ASCII编码。NubmerStr：为主叫号码：ASCII编码。NameStr： 为主叫姓名：ASCII编码。DateTimeStr，NubmerStr 和NameStr 必须有足够的存储空间长度。返回值：True表示收齐号码，False为失败。11 开始放音函数（VB参考函数）Public Declare Function Lt_StartPlayFile Lib LtPhoneRec.dll (ByVal LineId As Long, ByVal FileName As String, ByVal StarPos As Long) As Boolean 放音（C+参考函数）BOOL WINAPI Lt_StartPlayFile(DWORD LineId, LPCSTR FileName, DWORD StartPos )（Delphi参考函数）function Lt_StartPlayFile(LineId:Integer;FileName:String;StartPos:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：开始放音。参数：LineId为第几路电话。FileName为要放音的文件名。 StartPos为放音起始位置，以byte为单位。因每秒1700byte，所以，StartPos除以1700等于秒。返回值：True为放音成功，False为失败。12 停止放音函数（VB参考函数）Public Declare Function Lt_StopPlayFile Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）void WINAPI Lt_StopPlayFile(DWORD LineId)（Delphi参考函数）procedure Lt_StopPlayFile(LineId:Integer); stdcall; far external LtPhoneRec.dll;功能：停止放音，退出录音系统前，应调用StopPlayFile(0)。参数：LineId为第几路电话。返回值：无。13 检查放音状态函数（VB参考函数）Public Declare Function Lt_CheckPlayFileEnd Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_CheckPlayFileEnd(WORD LineId)（Delphi参考函数）function Lt_CheckPlayFileEnd(LineId:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：检查放音状态。参数：LineId为第几路电话。返回值：True为正在放音，False为放音结束。14 开始录音函数（VB参考函数）Public Declare Function Lt_StartRecordFile Lib LtPhoneRec.dll (ByVal LineId As Long, ByVal FileName As String) As Boolean（C+参考函数）BOOL WINAPI Lt_StartRecordFile(DWORD LineId,LPSTR FileName )（Delphi参考函数）function Lt_StartRecordFile(LineId:Integer;FileName:String): Bool; stdcall; far external LtPhoneRec.dll;功能：开始电话录音。参数：LineId为第几路电话，FileName为录音保存的文件名。返回值：True为录音成功，False为录音失败。15 停止录音函数（VB参考函数）Public Declare Function Lt_StopRecordFile Lib LtPhoneRec.dll (ByVal LineId As Long) （C+参考函数）void WINAPI Lt_StopRecordFile(DWORD LineId);（Delphi参考函数）procedure Lt_StopRecordFile(LineId:Integer); stdcall; far external LtPhoneRec.dll;功能：停止录音。参数：LineId为第几路电话。返回值：无。16 检查录音状态函数（VB参考函数）Public Declare Function Lt_CheckRecordFileEnd Lib LtPhoneRec.dll (ByVal LineId As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_CheckRecordFileEnd(WORD LineId)（Delphi参考函数）function Lt_CheckRecordFileEnd(LineId:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：检查录音状态。参数：LineId为第几路电话。返回值：True为正在录音，False为录音结束。17 通话监听开始（VB参考函数）Public Declare Function Lt_StartListenLine Lib LtPhoneRec.dll (ByVal LineId As Long)（C+参考函数）void WINAPI Lt_StartListenLine(DWORD LineId);（Delphi参考函数）procedure Lt_StartListenLine(LineId:Integer); stdcall; far external LtPhoneRec.dll;功能：通话监听。参数：LineId为第几路电话。返回值：无。18 通话监听停止（VB参考函数）Public Declare Function Lt_StopListenLine Lib LtPhoneRec.dll ()（C+参考函数）void WINAPI Lt_StopListenLine(void);（Delphi参考函数）procedure Lt_StopListenLine(); stdcall; far external LtPhoneRec.dll;功能：停止通话监听。参数：无。返回值：无。19 检查静音状态函数（VB参考函数）Public Declare Function Lt_CheckSilenceDelay Lib LtPhoneRec.dll (ByVal LineId As Long, ByVal delaysecond As Long) As Boolean（C+参考函数）BOOL WINAPI Lt_CheckSilenceDelay(DWORD LineId,BYTE delaysecond);（Delphi参考函数）function Lt_CheckSilenceDelay(LineId:Integer;delaysecond:Integer): Bool; stdcall; far external LtPhoneRec.dll;功能：检查线路静音状态。参数：LineId为第几路电话，delaysecond为静音长度判别标准，单位为秒。 范围是1-30秒。返回值：True为第几路电话已经静音时间超过delaysecond，False为没有超过。20 转换录音文件为windows Wave函数（V