6. VOS語(yǔ)言

　　6.25. 圖形化VOS，運行程序

　　菜單選項"Run"包括編譯和運行VOS程序所需的所有選項，編譯過(guò)程就是VOS檢測并把VOS代碼轉換為p-code。VOS編譯項目中的每一個(gè)應用程序。編譯程序為：VLC8.exe1。
　　編譯過(guò)程中，有一個(gè)狀態(tài)窗口顯示編譯狀態(tài)，編譯和連接過(guò)程中產(chǎn)生的錯誤和警告：

　　程序編譯完成后（無(wú)錯誤），就可以運行了。
　　運行過(guò)程中，VOS調用VOS.exe程序，VOS.exe解釋執行編譯后的VOS代碼，可以通過(guò)F5鍵或者按鈕 來(lái)實(shí)現。
　　VOS運行有許多設置：

　　6.25.1. 用戶(hù)界面，－設置

　　VOS啟動(dòng)時(shí)，用戶(hù)界面是一個(gè)稱(chēng)為VOS控制面板（VOS Control Panel）的對話(huà)框。VOS對話(huà)框如下所示：

　　任務(wù)欄中有一個(gè)當前file.VOS的索引。
　　編譯(vlc)和運行(vos)的設置通過(guò)兩個(gè)文件完成：VOS.ini和擴展名為.VOS的文件。

　　6.25.1.1. configurationfile.VOS 文件

　　從版本7（version 7）開(kāi)始，VOS和VLC的設置就固定在兩個(gè)文件中：VOS.INI和稱(chēng)為VOS設置文件的一種新文件，其擴展名為.vos。
　　設置文件與INI文件非常相象，VOS.INI文件應用于VOS運行引擎的每一個(gè)時(shí)間例程，而對于每一個(gè)VOS項目都可以有一個(gè)不同的設置文件。運行一個(gè)VOS程序時(shí)，可以指定使用某一個(gè)設置文件。如果沒(méi)有指定設置文件，VOS使用VOS.INI文件中[Setings]部分指定的缺省設置。此設置文件可以移出Windows目錄，也允許任意改變文件名，可以很容易在運行在不同的系統中。
　　VOS設置文件格式基于Widows的INI文件格式，并且VOS使用Windwos API函數來(lái)管理INI文件，所有指定段落名，關(guān)鍵詞、值和注釋的用法都相同。

　　文件可以在三個(gè)地方編輯
　　·使用圖形化的VOS(Graphical VOS)－>Project－>VOS Settings。
　　·使用VOS控制面板，單擊右鍵。
　　·直接使用記事本（NotePad）編輯VOS.ini文件。
　　設置文件中的節（Sections）包括：
　　[AutoStart]
　　VOS設置文件的[AutoStart]部分指定.vx文件，最多指定16個(gè)，當VOS使用此設置文件時(shí)，都要載入這些.vx文件。例如：
　　　　[AutoStart]
　　　　VXProgram1=C:\VoiceMail\VX\Master.vx
　　　　VXProgram2=Q:\Shared Vos Files\VX\Database.vx
　　　　VXProgram3=Q:\Shared Vos Files\VX\Pager.vx
　　[Buf]
　　VOS設置文件的[Buf]部分指定使用緩沖區的函數可以使用的緩沖區的數目。
　　例：
　　　　[Buf]
　　　　Count=10
　　　　[Colors]
　　VOS設置文件的[Colors]部分保存16種自定義顏色，用來(lái)設置VOS控制面板。

　　　　　條目　　　　 含義
　　　　Custom0　　自定義顏色 0.
　　　　Custom1　　自定義顏色 1.
　　　　Custom2　　自定義顏色 2.
　　　　Custom3　　自定義顏色 3.
　　　　Custom4　　自定義顏色 4.
　　　　Custom5　　自定義顏色 5.
　　　　Custom6　　自定義顏色 6.
　　　　Custom7　　自定義顏色 7.
　　　　Custom8　　自定義顏色 8.
　　　　Custom9　　自定義顏色 9.
　　　　Custom10　 自定義顏色 10.
　　　　Custom11 　自定義顏色 11.
　　　　Custom12 　自定義顏色 12.
　　　　Custom13 　自定義顏色 13.
　　　　Custom14 　自定義顏色 14.
　　　　Custom15 　自定義顏色 15.
　　自定義顏色的格式使用Win32RGB的十六進(jìn)制值。
　　[Consts]
　　VOS設置文件的[Consts]部分指定VLC開(kāi)始運行時(shí)聲明的常量。
　　　　[Consts]
　　　　Const1=<Name>[:Value]
　　　　Const2=<Name>[:Value]
　　　　... etc. for Const3, Const4, ...
　　[DateTime]
　　VOS 設置文件的[DateTime]部分可以使用戶(hù)覆蓋（override）VOS的時(shí)間設置。

　　[DBF]
　　VOS設置文件的[DBF]部分設置使用DBF數據庫的VOS參數。

　　[Exceptions]
　　VOS設置文件的[Exceptions]部分設置異常處理。

　　[File]
　　VOS設置文件的[File]部分用來(lái)設置DBF數據庫文件的文件和記錄鎖定參數。

　　[FunFileDirs]
　　VOS文件中的[FunFileDirs]部分用來(lái)設定最多8個(gè)目錄，VLC應該從這8個(gè)目錄中尋找函數文件。

　　VLC檢查是從Dir1到Dir8進(jìn)行的，例如，Dir1中的函數文件比Dir2中的函數文件優(yōu)先級高。這一點(diǎn)非常重要，尤其在不同的指定目錄中有兩文件同名的情況下，例如有兩個(gè)文件名字都為myfunc.fun，一個(gè)在C:\functions目錄中，另一個(gè)在D:\functions中。如果項目的設置文件如下所示：
　　　　[FunFileDirs]
　　　　Dir1=D:\functions
　　　　Dir2=C:\functions
　　編譯程序時(shí)，VOS使用D:\functions目錄中的函數。
　　[Glb]
　　VOS設置文件的[Glb]部分設定編號的全局變量的參數。
　　以下的條目不影響命名的全局變量。

　　[GUI]
　　VOS設置文件的[GUI]部分控制VOS用戶(hù)接口的外觀(guān)，可以通過(guò)VOS控制面板中的用戶(hù)接口對話(huà)框來(lái)設定。

　　[IncludeFileDirs]
　　VOS設置文件的[IncludeFileDirs]部分設置最多8個(gè)包含文件所在的目錄，VLC在這些目錄中尋找包含文件。

　　VLC檢查是從Dir1到Dir8進(jìn)行的。例如，Dir1中的函數文件比Dir2中的函數文件優(yōu)先級高這一點(diǎn)非常重要，尤其在不同的指定目錄中有兩文件同名的情況下，例如有兩個(gè)文件名字都為project.inc，一個(gè)在C:\include directory目錄中，另一個(gè)在D:\include directory中。如果項目的設置文件如下所示：
　　　　[IncludeFileDirs]
　　　　Dir1=D:\include
　　　　Dir2=C:\include
　　程序編譯后，VOS將使用D:\include directory目錄中的文件。

　　[Load]
　　VOS設置文件的[Load]部分設定缺省狀態(tài)下VOS載入的DLL，
調試和非調試DLL文件的名字和路徑名在VOS.INI文件中的[DLLs]部分設定。

　　[Log]
　　VOS設定文件的[Log]部分設定VOS日志文件的參數。

　　[Msg]
　　VOS 設置文件的[Msg]部分設定消息函數參數。

　　[NTX]
　　VOS設置文件的[NTX]部分設定DBF數據庫索引參數。

　　[Pio]
　　VOS設置文件中的[Prio]部分可以設定VOS進(jìn)程、基本線(xiàn)程、GUI線(xiàn)程在Windows中的優(yōu)先級。Windows優(yōu)先級在MSDN庫中詳細解釋?zhuān)瑓⒁?jiàn)MSDN庫中的SetThreadPriority和SetThreadPriorityBoost Win32 API函數。
　　VOS開(kāi)始時(shí)，調用SetThreadPriority和SetThreadPriorityBoost Win32 API函數（使用VOS設置文件本部分設定值）。通過(guò)控制面板的優(yōu)先級設定對話(huà)框改變設置時(shí)，也要調用上述2個(gè)API函數，不需要重啟動(dòng)VOS來(lái)改變屬性。

　　[R4]
　　VOS設置文件的[R4]部分設定傳統（legacy）VOS函數的參數，如sc_，DTI_函數等等。
　　如果應用程序中沒(méi)有使用這些函數，設置文件中刪去此節。

　　[RLLs]
　　VOS設置文件[RLLs]部分設定VOS或VLC運行時(shí)載入那些RLL。

　　[SearchPaths]

　　VOS設置文件中的[SearchPaths]部分設定查詢(xún)IPF、Par文件和VX文件的路徑。
　　如果一條SearPaths要列出多個(gè)路徑，各路徑用分號隔開(kāi)：
　　[SearchPaths]
　　IPF=.;.\IPF;c:\Projects\IPFs;

　　[Sem]
　　VOS設置文件的[Sem]部分設定信號量（Semaphore）參數。

　　[Ser]
　　VOS設置文件的[Ser]部分設定串口的參數。

　　[SRL]
　　VOS設置文件的[SRL]部分設定標準運行庫（SRL）事件的參數。

　 [Task]
　　VOS設置文件[Task]部分設定任務(wù)管理參數

　　[Trace]
　　VOS設置文件[Trace]部分設定跟蹤選項

　　[TrayIcon]
　　VOS設置文件中的[TrayIcon]部分設定當VOS運行時(shí)系統圖標。從VOS控制面板中的用戶(hù)接口對話(huà)框中可以找到這些條目。

　　[VLC]
　　VOS設置文件的[VLC]部分設置VOS語(yǔ)言編譯選項。

　　[VLs]
　　VOS設置文件中[VLs]部分指定VOS或VLC運行時(shí)載入的VL文件，一個(gè)Vlc庫文件是一組函數文件的集合，Vlc庫文件的擴展名為.VL。
　　　　[VLs]
　　　　Lib1=<VL path name>
　　　　... etc for Lib2, Lib3...

　　[VosBox]
　　"VOS Box"窗口是一個(gè)模擬MS-DOS PC的25x80字符的窗口，此窗口是為了與DOS版本的VOS后向兼容。
　　VOS設置文件的[VosBox]設定VOX Box的選項，也可以從VOS控制面板的用戶(hù)接口對話(huà)框來(lái)設置。

　　6.25.1.2. VOS.INI文件

　　VOS.INI文件保存影響VOS的設置，設置如下：
[Settings]
　　VOS.INI文件中[Settings]指定為缺省設置文件：
　　　　[Settings]
　　　　Default=c:\Vos\Settings\Default.vos
[DLLs]
　　VOS.INI文件中[DLLs]指出調試和非調試 VOS DLL的位置：
　　　　[DLLs]
　　　　Debug=c:\Vos\Bin\Vosd.dll
　　　　NonDebug=c:\Vos\Bin\Vos.dll
[Service]
　　VOS.INI文件中[Service]指定業(yè)務(wù)相關(guān)性和VOS作為WindowsNT/2000業(yè)務(wù)運行時(shí)所需的其他設置：
　　　　[Service]
　　　　GroupName=VoiceMail
　　　　Dependencies=Dialogic;Telephony
　　　　GroupOrderTag=2

7. CT ADE 體系結構（Topaz），介紹

　　第一個(gè)問(wèn)題：什么是 CT ADE體系結構（TOPAZ）？
　　回答這個(gè)問(wèn)題之前，首先回顧一下CTI應用所提出的問(wèn)題。
　　開(kāi)發(fā)電話(huà)應用程序時(shí)必須清楚：電話(huà)線(xiàn)的類(lèi)型、電路板的類(lèi)型和相關(guān)的不同的API。有3種接口：
　　·模擬
　　·數字（R2，ISDN，SS7等等）
　　·IP（Voice over IP）
　　比如，如果需要為每種接口開(kāi)發(fā)和維護相同的應用，應該開(kāi)發(fā)3種不同的程序：模擬版本、數字版本和IP版本。另外，這些應用程序直接依賴(lài)于電路板API。而且，如果要把應用程序應用到CT 媒體上，就必須重新從開(kāi)始開(kāi)發(fā)整個(gè)程序。
CTADE_A具有很多的好處，隨 CTADE_A帶有可以一組簡(jiǎn)單的命令，這允許我們?yōu)椴煌��?lèi)型的中繼和API只開(kāi)發(fā)一套應用程序就可以了。這種概念稱(chēng)為API透明性。
CTADE_A怎樣實(shí)現透明？
　　下面圖表顯示了在系統中TOPAZ處在何處，它是怎樣分開(kāi)應用程序和API的。

　　從上圖中可以看出，TOPAZ處于A(yíng)PI和應用程序之間。TOPAZ檢測API函數和安裝的板卡（使用Topaz Profile，以后介紹）。
　　TOPAZ是面向資源的，它直接處理系統中的電話(huà)資源。
　　這就是我們所謂的面向系統資源。什么是資源？
　　資源是指可以共享和使用的一個(gè)和一組元素，其中每一個(gè)元素都代表實(shí)體元素。首先要定義資源的類(lèi)型。VOS中有下列資源：
　　·中繼資源：線(xiàn)路接口資源
　　·媒體資源：播放、錄音、產(chǎn)生和檢測各種聲音的資源。
　　·傳真資源：發(fā)送和接收傳真的資源
　　·語(yǔ)音識別資源：語(yǔ)音識別資源
　　·文本到語(yǔ)音轉換資源：文本到語(yǔ)音轉換資源
　　·會(huì )議資源：協(xié)商安排和控制資源
　　由下面的VOS代碼可以看出，關(guān)于資源的函數名總是以相應資源的名稱(chēng)開(kāi)始：

　7.1. 圖形化VOS，CT ADE 體系結構（Unleashed）

　　我們已經(jīng)知道了怎樣創(chuàng )建一個(gè)項目和怎樣向一個(gè)項目加入必須的文件，另外，我們已經(jīng)知道了怎樣設置一個(gè)VOS項目。
　　下面介紹CTADE_A和VOS語(yǔ)言，我們已經(jīng)知道，CTADE_A是一組軟件模塊，用來(lái)銜接CTADE_A命令（MediaPlayFile、MediaRecofd等等）和安裝的CTI API。
CTADE_A是面向資源的。從前面的介紹可以得知，有許多種資源（中繼、媒體、傳真、ASR、TTS、會(huì )議（Conference））等等，Dialogic板卡上的這些資源使用不同的技術(shù)。
這些資源中每一種資源都包含許多內部狀態(tài)，這些狀態(tài)的轉換都與資源短語(yǔ)（resource live phases）有關(guān)。關(guān)于這些狀態(tài)，請參見(jiàn)Graphical
　　VOS User's Guide en la sección CTADE_A->Resource Stats.。

　　7.1.1. CTADE_A，資源和資源索引號碼

　　許多VOS函數控制CTADE_A資源，例如，函數MediaPlayFile在當前的媒體資源上播放一個(gè)聲音文件。現在，我們介紹資源的概念并且討論資源編號方式是怎樣工作的。
　　資源就是呼叫處理系統的一個(gè)組成部分。在大多情況下，單個(gè)資源在一條電話(huà)線(xiàn)或一個(gè)數字中繼上播放單個(gè)語(yǔ)音流。
　　每一資源由資源索引號碼來(lái)區分，通常不需要考慮資源索引號碼，因為當應用程序需要資源時(shí)，VOS負責這些資源的預留和路由。但如果要控制應用程序使用資源的方式，就需要靠資源索引號碼來(lái)指定資源。每種資源的索引號碼都從0開(kāi)始且獨立編碼：一個(gè)VOS任務(wù)能夠很方便的使用中繼資源1和媒體資源4。
　　另外，可以通過(guò)多個(gè)函數來(lái)得到資源索引的資源：
　　－ResourceTypeGetIndex，返回當前資源的索引號，如：MediaGetIndex，　　　TrunkGetIndex
　　－ResourceTypeGetCount，返回資源的總數，如：MediaGetCount，　　　　　　TrunkGetCount。

　　7.1.2. CTADE_A 函數概述

　　CTADE_A中，所有的函數有資源分組，CTADE_A的每一種資源根據不同的特征形成一組函數。通常情況下，系統中的所有資源都有一個(gè)號碼，我們可以通過(guò)索引來(lái)操作每一種資源。有兩種資源來(lái)請求資源：自動(dòng)和手動(dòng)。例子：

　　　7.1.2.1. CTADE_A函數，異步模式。

　　缺省狀態(tài)下，VOS一直在等待，直到所有的CTADE_A函數執行結束（同步模式），例：
　　　　MediaPlayFile("LeaveMsg.vox");
　　　　MediaRecordFile("Message");
　　缺省狀態(tài)下，MediaPlayFile在vox文件播放完畢或者其他終止條件（DTMF，靜音等等）下退出執行。
　　但是，在許多情況下，需要調用函數的同時(shí)繼續執行程序（異步模式），例：
　　　　MediaPlayFile("Welcome.vox");
　　　　Balance=CheckBalance(AccountNo);
　　　　MediaPlayFile(Balance&".vox");
　　假設函數CheckBalance要運行1到10秒（決定于數據庫服務(wù)器的忙閑程度），最差情況下，呼入的用戶(hù)需要在第一次播放和balance的結果之間等待10秒。
　　異步執行通過(guò)使用函數MediaEnableAsync()可以避免這些問(wèn)題，如下：
　　　　MediaEnableAsync();
　　　　MediaPlayFile("Welcome.vox");
　　　　Balance=CheckBalance(AccountNo);
　　　　MediaWait();--------------------→此函數一直等到媒體資源變?yōu)榭臻e狀態(tài)
　　　　MediaPlayFile(Balance&".vox");

　　7.1.2.2. CTADE_A函數，中繼資源和函數
　　中繼函數是用來(lái)管理系統中的中繼資源，目的是做以下事情：
　　·進(jìn)行呼出
　　·呼叫過(guò)程分析
　　·應答或拒接一個(gè)呼入呼叫
　　·獲得呼叫信息（ANI，DNIS，呼叫者姓名，等等）
　　·掛斷電話(huà)
　　可以看出，中繼資源負責所有的呼叫控制，一個(gè)中繼資源處理單個(gè)語(yǔ)音流，所以下列都可以看作是一個(gè)中繼資源
　　·單個(gè)模擬線(xiàn)的中繼接口
　　·E1/T1的一個(gè)時(shí)隙
　　·一個(gè)MSI站（An MSI Station）
　　·SimPhone模擬中繼線(xiàn)（索引號總為0）
　　控制中繼資源的函數：

　　7.1.2.3. CTADE_A函數，媒體資源與函數

　　媒體資源控制播放、錄制語(yǔ)音文件和各種提示音，并且從呼叫方接收DTMF位。
　　·向呼叫方播放語(yǔ)音文件和提示語(yǔ)。
　　·播放可變信息："你地余額為300.17元"。
　　·錄制語(yǔ)音文件，提示怎樣將呼叫方的語(yǔ)音錄制成語(yǔ)音文件。
　　·使用停止播放來(lái)表示摘機音，當呼叫方撥號時(shí)，停止播放或錄音。
　　·從呼叫方接收描述檢索摘機音的數目。
　　·向呼叫方展示怎樣播放普通的提示音。
　　控制媒體資源的函數如下：

　　7.1.2.4 CTADE_A 函數，傳真資源和函數

　　傳真資源控制傳真數據的傳送與處理。Dialogic VFZ板上或GammaLink CP板上的一個(gè)單個(gè)的傳真通道為一個(gè)傳真資源。
　　必須注意傳真資源只能收發(fā)傳真數據，所有其他需要呼出或呼入電話(huà)的操作應由中繼資源或媒體資源完成。
　　傳真資源由傳真函數管理，
　　·發(fā)傳真
　　·收傳真
　　·輪循傳送或逆向傳送

　　7.1.2.5. CTADE_A函數，會(huì )議（Conference）函數

　　會(huì )議資源用來(lái)創(chuàng )建和管理會(huì )議。
　　會(huì )議函數完成下列功能：
　　·創(chuàng )建會(huì )議
　　·從一會(huì )議中刪去某與會(huì )方
　　·刪除會(huì )議
　　多會(huì )議函數如下：

　　7.1.2.6. CTADE_A 函數，語(yǔ)音識別函數

　　語(yǔ)音識別資源把呼叫者的語(yǔ)音轉變?yōu)槲谋咀址�串。一個(gè)VR資源可以對一個(gè)語(yǔ)音流數據（來(lái)自一中繼或會(huì )議資源）進(jìn)行識別。
　　可以通過(guò)VrGetCount函數來(lái)查找系統中VR資源的數目。
　　注：系統中CTADE_A為每一媒體資源創(chuàng )建一語(yǔ)音識別資源，由于語(yǔ)音引擎的限制，可能不能同時(shí)使用VR資源。

[ 全文英文版 ]

本文[ 目錄 ] [ 第一頁(yè) ] [ 第二頁(yè) ] [ 第三頁(yè) ]

融合通信專(zhuān)欄>>技術(shù)開(kāi)發(fā)>>