6. VOS語言

　　6.25. 圖形化VOS，運行程序

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

　　程序編譯完成后（無錯誤），就可以運行了。
　　運行過程中，VOS調(diào)用VOS.exe程序，VOS.exe解釋執(zhí)行編譯后的VOS代碼，可以通過F5鍵或者按鈕 來實現(xiàn)。
　　VOS運行有許多設(shè)置：

　　6.25.1. 用戶界面，－設(shè)置

　　VOS啟動時，用戶界面是一個稱為VOS控制面板（VOS Control Panel）的對話框。VOS對話框如下所示：

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

　　6.25.1.1. configurationfile.VOS 文件

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

　　文件可以在三個地方編輯
　　·使用圖形化的VOS(Graphical VOS)－>Project－>VOS Settings。
　　·使用VOS控制面板，單擊右鍵。
　　·直接使用記事本（NotePad）編輯VOS.ini文件。
　　設(shè)置文件中的節(jié)（Sections）包括：
　　[AutoStart]
　　VOS設(shè)置文件的[AutoStart]部分指定.vx文件，最多指定16個，當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設(shè)置文件的[Buf]部分指定使用緩沖區(qū)的函數(shù)可以使用的緩沖區(qū)的數(shù)目。
　　例：
　　　　[Buf]
　　　　Count=10
　　　　[Colors]
　　VOS設(shè)置文件的[Colors]部分保存16種自定義顏色，用來設(shè)置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的十六進制值。
　　[Consts]
　　VOS設(shè)置文件的[Consts]部分指定VLC開始運行時聲明的常量。
　　　　[Consts]
　　　　Const1=<Name>[:Value]
　　　　Const2=<Name>[:Value]
　　　　... etc. for Const3, Const4, ...
　　[DateTime]
　　VOS 設(shè)置文件的[DateTime]部分可以使用戶覆蓋（override）VOS的時間設(shè)置。

　　[DBF]
　　VOS設(shè)置文件的[DBF]部分設(shè)置使用DBF數(shù)據(jù)庫的VOS參數(shù)。

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

　　[File]
　　VOS設(shè)置文件的[File]部分用來設(shè)置DBF數(shù)據(jù)庫文件的文件和記錄鎖定參數(shù)。

　　[FunFileDirs]
　　VOS文件中的[FunFileDirs]部分用來設(shè)定最多8個目錄，VLC應(yīng)該從這8個目錄中尋找函數(shù)文件。

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

　　[GUI]
　　VOS設(shè)置文件的[GUI]部分控制VOS用戶接口的外觀，可以通過VOS控制面板中的用戶接口對話框來設(shè)定。

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

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

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

　　[Log]
　　VOS設(shè)定文件的[Log]部分設(shè)定VOS日志文件的參數(shù)。

　　[Msg]
　　VOS 設(shè)置文件的[Msg]部分設(shè)定消息函數(shù)參數(shù)。

　　[NTX]
　　VOS設(shè)置文件的[NTX]部分設(shè)定DBF數(shù)據(jù)庫索引參數(shù)。

　　[Pio]
　　VOS設(shè)置文件中的[Prio]部分可以設(shè)定VOS進程、基本線程、GUI線程在Windows中的優(yōu)先級。Windows優(yōu)先級在MSDN庫中詳細解釋，參見MSDN庫中的SetThreadPriority和SetThreadPriorityBoost Win32 API函數(shù)。
　　VOS開始時，調(diào)用SetThreadPriority和SetThreadPriorityBoost Win32 API函數(shù)（使用VOS設(shè)置文件本部分設(shè)定值）。通過控制面板的優(yōu)先級設(shè)定對話框改變設(shè)置時，也要調(diào)用上述2個API函數(shù)，不需要重啟動VOS來改變屬性。

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

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

　　[SearchPaths]

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

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

　　[Ser]
　　VOS設(shè)置文件的[Ser]部分設(shè)定串口的參數(shù)。

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

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

　　[Trace]
　　VOS設(shè)置文件[Trace]部分設(shè)定跟蹤選項

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

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

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

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

　　6.25.1.2. VOS.INI文件

　　VOS.INI文件保存影響VOS的設(shè)置，設(shè)置如下：
[Settings]
　　VOS.INI文件中[Settings]指定為缺省設(shè)置文件：
　　　　[Settings]
　　　　Default=c:\Vos\Settings\Default.vos
[DLLs]
　　VOS.INI文件中[DLLs]指出調(diào)試和非調(diào)試 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 體系結(jié)構(gòu)（Topaz），介紹

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

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

　7.1. 圖形化VOS，CT ADE 體系結(jié)構(gòu)（Unleashed）

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

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

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

　　7.1.2. CTADE_A 函數(shù)概述

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

　　　7.1.2.1. CTADE_A函數(shù)，異步模式。

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

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

　　7.1.2.3. CTADE_A函數(shù)，媒體資源與函數(shù)

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

　　7.1.2.4 CTADE_A 函數(shù)，傳真資源和函數(shù)

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

　　7.1.2.5. CTADE_A函數(shù)，會議（Conference）函數(shù)

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

　　7.1.2.6. CTADE_A 函數(shù)，語音識別函數(shù)

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

[ 全文英文版 ]

本文[ 目錄 ] [ 第一頁 ] [ 第二頁 ] [ 第三頁 ]

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