|
7. CT ADE 體系結構（Topaz）介紹
7.1.3. CTADE_A，路由
7.1.4. CTADE_A，路由類型：全雙工和半雙工
7.1.5. CTADE_A， 呼叫控制、掛機處理和掛斷事件
7.1.6. CTADE_Architecture技術
7.1.7. CTADE_A 特征ID
7.1.8. CTADE_A. 設置，TOPAZ.INI
7.1.9CTADE_A. 提示音（Tones）
8. VOS 運行日志
7. CT ADE 體系結構（Topaz）介紹 7.1.3. CTADE_A，路由
許多電話操作需要兩種資源共同工作。例如，向呼叫者播放一段語音要求使用媒體資源播放文件，使用中繼資源建立與呼叫者的連接。中繼資源必須偵聽媒體資源的輸出，這樣呼叫者才能聽到播放的文件，媒體資源應該偵聽中繼資源，這樣才能處理呼叫者輸入的數(shù)字。
在大多情況下，用戶不需明確地控制路由：缺省狀態(tài)下，CTADE_A通過用戶使用的函數(shù)將用戶所需的資源路由到一起。例如，當播放一個文件時，CTADE_A確定當前媒體資源已經(jīng)路由到了當前中繼資源上。
但用戶可以替換Topaz的自動路由。
看下面的一個例子：
·如果有一個媒體資源，MediaUse函數(shù)預留媒體資源并且將其路由到當前的中繼資源上。
·缺省狀態(tài)下，F(xiàn)axUse函數(shù)預留一個與當前中繼資源兼容的傳真資源，并且將兩者路由到一起。
·如果使用MediaPlayFile函數(shù)時還沒有打開一個媒體資源，播放文件前，Topaz會保留一個媒體資源，并且把它路由到當前的中繼資源，如果沒有保留中繼資源，Topaz在保留媒體資源前會先保留一個中繼資源。
·向一個會議添加任何資源時，Topaz都會將兩者路由到一起。
然而，也可以調用下面的函數(shù)使自動路由失效：
TopazDisableAutoRoute();
可以調用下面的函數(shù)使自動路由重新有效：
TopazEnableAutoRoute();
7.1.4. CTADE_A，路由類型：全雙工和半雙工
如果使用全雙工連接，兩種資源之間有雙向的路由，如下圖所示。每一種資源偵聽其他資源的傳輸，典型的情況如媒體和中繼設備之間的相互路由：
然而，半雙工中，只是一種資源偵聽另一種資源：
一個全雙工連接函數(shù)TopazRoute(Res1, Index1,
Res2, Index2)
可以創(chuàng)建如第一個圖所示的路由，資源2在偵聽資源1，反過來，資源1也在偵聽資源2。
一個全雙工路由相當于兩個偵聽命令。
一個半雙工連接如第二個圖所示，資源2在偵聽資源1，但反過來資源1沒有偵聽資源2（除非之前有路由命令使資源1偵聽資源2）。
7.1.5. CTADE_A， 呼叫控制、掛機處理和掛斷事件
掛斷過程中有兩個重要的問題：
·檢測呼叫者何時掛斷
·掛斷時處理
7.1.5.1.掛斷檢測
掛斷檢測操作可以體現(xiàn)出Topaz API透明性的好處。因為當使用中繼函數(shù)開發(fā)應用程序時，不需要考慮CTADE_A進行掛斷檢測的技術細節(jié)。
當使用開發(fā)的應用程序時，可以使用相同的VOS代碼，不用考慮系統(tǒng)，只需要改變一下Topaz的一下設置細節(jié)即可。
7.1.5.2 掛斷處理
檢測到呼叫者的掛斷操作后，VOS在當前的p-code指令執(zhí)行完后（可能正在語句和表達式執(zhí)行中）停止運行，并將控制權交給onhangup函數(shù)。然后onhangup函數(shù)就會一種執(zhí)行，直到遇見重啟、返回或掛斷結束（endhangup）的語句。如果遇見endhangup語句，效果與return語句相同，如果遇見return語句，程序返回到中斷的語句繼續(xù)執(zhí)行，如果處理onhangup的過程中又有一個掛斷事件發(fā)生，此事件將會被忽略。
大多應用中，建議使用restart將控制權交回程序的開始，這樣會使體系結構比較明確。
如果掛斷發(fā)生時正在執(zhí)行象MediaPlayFile、MediaRecordFile或MediaWaitDigits等異步CTADE_A函數(shù)。VOS會中斷函數(shù)，立即轉到onhangup處理。
如果掛斷發(fā)生時只在執(zhí)行其他的阻塞函數(shù)如sem_set或ser_rdbuf。VOS直到函數(shù)完成后再轉到onhangup處理。
TrunkDeferOnHangup函數(shù)和TrunkClearDeferOnHangup函數(shù)允許應用程序定義關鍵代碼區(qū)，這些代碼區(qū)不允許被onhangup處理函數(shù)中斷。一個典型的例子就是一組數(shù)據(jù)庫更新，一旦開始，必須完全接收。當有掛斷事件時，TrunkDeferOnHangup函數(shù)后面的任何電話阻塞函數(shù)都將終止。控制權交給onhangup函數(shù)的操作被推遲，直到函數(shù)TrunkClearDeferOnHangup。
例：
7.1.6. CTADE_Architecture技術
CTADE_Architecture（Topaz）是為API的透明性設計的，即一套程序可以在所有的電話API和所支持的所有中繼類型下運行。但某些特征只適用于某種技術，例如，GloblaCall系統(tǒng)發(fā)送記帳比率信息，但其他中繼接口API不使用協(xié)議定義的記帳比率。所以，函數(shù)TrunkGetBilling不能提供R4GcTrunk技術到其他技術的接口，所以是不透明的。
VOS提供了控制電話資源技術細節(jié)的函數(shù)，象TrunkGetInt一樣，Get/Set函數(shù)可以操作特定的技術參數(shù)和API函數(shù)。
Get/Set函數(shù)可以讀取和設置CTADE_A中只應用于特殊技術的參數(shù)。
Get函數(shù)，象MediaGetInt返回技術的布爾、字符串和整數(shù)參數(shù)，比如，要獲取R4DxMedia資源當前的播放聲音的大小，可以使用MediaGetInt函數(shù)和REGID_PlaySpeed
RegID（702）：
Value = MediaGetInt(702);
Set函數(shù)，象MediaSetInt可以設定技術參數(shù)，例如要設定R4DxMedia資源當前播放聲音值為7，可以使用MediaSetInt函數(shù)和REGID_PlaySpeed（702）：
MediaSetInt(702, 7);
注意：
必須注意，調用API級的函數(shù)設置一個CTADE_A參數(shù)可能不只改變電路板級的參數(shù)。例如，R4DxMedia中，使用函數(shù)MediaSetBool設置REGID_R4DxMediaDisableAllToneDetection（280）為0或1來清除Dialogic提示音ID。
MediaSetBool(280, 0);
此處函數(shù)MediaSetBool沒有設置Board級的參數(shù)為0，此函數(shù)調用Dialogic的函數(shù)dx_deltones來刪除以前在此通道上的用戶定義提示音。
要詳細了解VOS中可用的函數(shù)和方法以及更多例子，參見Get/Set函數(shù)。
可以從CTADE_A RegIDs中找到一系列可用的RegIDs。
當前的CTADE_A技術如下：
中繼技術
技術 ID號碼 描述
SimTrunk 1001 SimPhone Trunk
R4AgTrunk 1002 R4 ag_ / dx_ API (aka LSI)
R4GcTrunk 1003 R4 gc_ API
S100Trunk 1005 S.100 CTscr_ API
R4MsTrunk 1006 R4 ms_ station API
媒體技術
技術 ID號碼 描述
SimMedia 2001 SimPhone Media
R4DxMedia 2002 R4 dx_ API (aka VOX)
S100Media 2003 S.100 CTplyr_/CTrcdr_ API
WaveMedia 2004 Win32 Wave API
傳真技術
技術 ID號碼 描述
R4FxFax 3001 R4 fx_ API
R4GrtFax 3002 GammaLink fax
S100Fax 3003 S.100 Fax
會議技術
技術 ID號碼 描述
R4MsConf 5001 R4 ms_ conference API
R4DcbConf 5002 R4 dcb_ API
S100Conf 5003 S.100 CTconf_ API
例如，下面為R4DxMedia技術的一些（some3）RegId：
R4DxMedia RegIDs
7.1.7. CTADE_A 特征ID
特征ID
保存在Topaz 特征（Profile）中的一些描述系統(tǒng)細節(jié)的RegID稱為特征ID。Profile的內容可以通過TopazProfile.exe
-L命令來查看，Profile的內容產(chǎn)生一個包含文件，產(chǎn)生的文件中的每一項都代表一個特征（Profile）ID。
可以通過適當?shù)腉et函數(shù)獲得特征（profile）ID的值，例如，要查出是否支持ANI（呼叫者ID），可以使用函數(shù)TrunkGetBool
和REGID_ANISupported(301)：
Support = TrunkGetBool(301);
Topaz Profile是類似于Windows注冊表的一個數(shù)據(jù)庫，是一個文件和目錄樹，包括以下信息：
·所有安裝的硬件資源細節(jié)，由資源掃描器決定。
·用戶提供的硬件配置信息，資源掃描器檢查不到。
·用戶可設的選項，象缺省的語言（英語、西班牙語… …）。
運行的VOS應用程序把Profile當作只讀來處理，這些程序開始運行前，Profile應該完全初始化。
Topaz Profile中不包含任何動態(tài)改變的信息，象某一資源的狀態(tài)等等。
Profile中的各項，稱為Profile ID，具有名字和值。某一項的名字與一個文件系統(tǒng)中的路徑名相似。所有的名字從根段開始，以反斜線表示。比如，Topaz
代碼內部使用的Profile ID如下：
\Techs\TechCount
TechCount的值是本PC機安裝的不同的CTADE_A提示的數(shù)目（一個技術是指一個特定的硬件和相應的API函數(shù)，如DialogicR4
VOX）。
值分三種類型：整數(shù)，字符串和布爾值（True/False）。
常常可以看到如下的數(shù)值和名字：
\Techs\TechCount=4
一個Topaz 目錄可以包含一些數(shù)值，象TechCount，也可以包含一個數(shù)值數(shù)組，名字相同，索引不同。（Topaz不允許在同一目錄下既包含數(shù)組又包含非數(shù)組值）。如，\TechTypes
包含一個整數(shù)值的數(shù)組，\TechTypes[0]，\TechTypes[1]，…..最大的索引為TechCount-1。
此例中數(shù)組可以包含連續(xù)的索引，或數(shù)組的索引可以不連續(xù)，比如，可以只有A[1]、A[16]和A[19]有值。如果數(shù)組的索引不連續(xù)，CTADE_A要求有一個索引連續(xù)的數(shù)組，其值為上個數(shù)組中有值的索引，如上例，可以有另一個數(shù)組B[0]=1，B[1]=16和B[2]=19.設計規(guī)則：CTADE_A
不需要查詢提供的第一個數(shù)組，但需要查找第二個數(shù)組的值以及指定數(shù)組大小的值。比如TechCount。這有助于提供系統(tǒng)的前向和后向的兼容性，并且提高資源掃描器改變時程序的健壯性。
7.1.7.1. 更新Topaz Profile
TopazProfile 數(shù)據(jù)庫使用下面程序進行更新：
C:\Program Files\Parity Software\Common\Topaz\Bin\TopazProfile.exe
TopazProfile.exe是一個Win32平臺的應用程序，有以下的選項：
·-S 掃描設備（刪除Profile并且重新建立）
·-L 將Profile列入"TopazProfile.exe"
·-D 刪除Profile
·-C<file> 從文件中向Profile拷貝關鍵字
·-I 與-C一樣更新Profile，文件名取自"TOPAZ.INI"的[ProfileInclude
Files]
部分。
·-F<file> 讀取文件，標準輸出
·-K 以整數(shù)值排列關鍵詞（缺省以字母排列）
創(chuàng)建和設置Topaz Profile文件
與Windows注冊表不同，用戶的應用程序不能直接訪問Profile，并且不能創(chuàng)建新的條目。Profile只能由Topaz在內部使用。
完成下列設置后通過運行TopazProfile程序創(chuàng)建TopazProfile。
缺省的情況下，TopazProfile安裝在主機的系統(tǒng)盤：
C:\Program Files\Parity Software\Common\Topaz\Profile
為了Topaz能夠運行，文件Topaz.ini的[Profile]部分必須指定Topaz
Profile的路徑。
"通過在Topaz設置文件（Topaz.ini）和Profile包含文件中添加合適的條目，在Topaz
Profile設置某種資源參數(shù)。"
RegId和Get/Set函數(shù)
Topaz通過在內部使用其他的RegID來操作技術級的信息。這些RegID不在Topaz
Profile中，但可以通過Get/Set函數(shù)檢索系統(tǒng)信息或執(zhí)行一個技術級的命令。
下列RegIDs用于Get/Set函數(shù)中。同時也列出了每種技術的特定RegID。
看下列RegsID：
7.1.7.2Topaz RegID：R4AgTrunk
7.1.7.3
7.1.7.4 Topaz RegID：R4DxMedia
7.1.7.5 Topaz RegID：R4GcTrunk
7.1.7.6 Topaz RegID：R4MsTrunk
7.1.7.7. Topaz RegIDs： S100Conf
7.1.7.8. Topaz RegIDs：S100Fax
7.1.7.9. Topaz RegID：S100Media
7.1.8. CTADE_A. 設置，TOPAZ.INI
Topaz.ini文件設定系統(tǒng)首次Topaz引擎時所要讀取的各種設置參數(shù)。要改變Topaz.ini中的任何項時，必須確保這些變化生效時VOS和CallSuite的所有例程已全部關閉，因為這些例程使用Topaz。
7.1.8.1 [Profile]部分
Topaz.ini文件的Profile部分設定開始時控制Topaz Profile的參數(shù)
7.1.8.2. [ProfileIncludeFiles] 部分
Topaz.ini文件的ProfileIncludeFiles部分列出了每次TopazProfile.exe運行時（使用Include選項）都要拷貝到Topaz
Profile的文件。例：
7.1.8.3. [ProfileExcludeTechnologies]部分
Topaz.ini文件中的ProfileExcludeTechnologies部分列出了TopazProfile.exe自動掃描時排除的技術。
例：
7.1.8.4. [ProfileDependencies] 部分
Topaz.ini文件的ProfileDependencies部分列出了TopazProfile.exe運行前必須啟動的Windows
NT/2000的服務程序。例：
7.1.8.5. [SimMediaScanner]部分
Topaz.ini文件的SimMediaScanner部分指定了SimMedia使用的Wave
IN和Wave Out 設備的ID。
缺省情況下，兩個Wave ID都為0。例：
7.1.8.6 [WaveScanner]部分
Topaz.ini文件的WaveScanner部分指定了WaveMedia技術所使用的Wave
IN和Wave Out 設備的ID。例：
7.1.8.7. [S100Groups] 部分
Topaz.ini文件的S100Groups部分指定了應用程序所使用的S100組和相關的Topaz資源。
S100Groops部分的缺省設置保存在[S100Defaults]部分中。例：
7.1.8.8. [S100Defaults]部分
Topaz.ini文件的S100Defaults部分指定S100Groups部分的缺省值，如果沒有設定S100Defaults部分的關鍵詞，Topaz使用標準的缺省設置。有效的關鍵詞和相應的缺省值如下例所示：
例：
MakeCallGroupSet、SPROnlyGroupSet和SPRGroupSet只用于CT
Media版本V1。版本V2中被刪除。
此部分的詳細描述參見S100Topaz.ini配置中此部分的描述和S100Groups部分。
7.1.9CTADE_A. 提示音（Tones）
此章中介紹如何產(chǎn)生和檢測提示音。
7.1.9.1 播放提示音
Tones，也稱為全程Tones或全局Tones，可以為以下4中類型：單音、雙音、有步調的單音和有步調的雙音。
單音和雙音
單音只有一個幅度和頻率，雙音有兩套幅度和頻率。公眾網(wǎng)中的大部分相似的聲音，包括Touch-tones，都是雙音。
步調
步調音有規(guī)則的步調，一段為音調，一段為靜音。在美國，忙音采用步調音，步調如下所示：
沒有步調的音稱為連續(xù)音，比如，摘機音是連續(xù)音。
播放音調
可以使用函數(shù)MediaPlaySingleContinuousTone播放一段連續(xù)音。
MediaPlaySingleContinuousTone(Freq1,
Amp1, Duration, StopTones);
Freq1參數(shù)定義聲音的頻率，可在300到2000hz之間。Amp1定義聲音的幅度，有效的范圍為-40到2dB。Duration
參數(shù)指定聲音的長度，以0.1秒為單位。StopTones參數(shù)是一個摘機音（touch tone）位的字符串，可以中斷任何語音文件的播放和錄制。
使用函數(shù)MediaPlayDualContinuousTone播放一段連續(xù)的雙音：
MediaPlayDualContinuousTone(Freq1, Amp1,
Freq2, Amp2, Duration, StopTones);
除了Freq2和Amp2這兩個參數(shù)外，其他參數(shù)和函數(shù)MediaPlaySingleContinuousTone的參數(shù)相同，F(xiàn)req2和Amp2指定雙音第二部分的頻率和幅度。
播放步調音的函數(shù)與播放連續(xù)音的函數(shù)相同：
MediaPlaySingleCadenceTone(Freq1, Amp1,
OnTime, OffTime, Count, StopTones);
MediaPlayDualCadenceTone(Freq1, Amp1,
Freq2, Amp2, OnTime, OffTime, Count,
StopTones);
除了參數(shù)Freq1、Amp1、Freq2和Amp2外，OnTime參數(shù)指定播放聲音的時間長度，由0.1秒為單位表示，OffTime參數(shù)指定靜音的時間長度，也由0.1秒為單位表示。Count參數(shù)指定了步調重復的次數(shù)。
如果在Topaz Profile中指定了某一聲音的參數(shù)，就可以在媒體資源中使用函數(shù)MediaPlayTone來播放：
MediaPlayTone(ToneName, StopTones);
參數(shù)ToneName必須與Topaz Profile中設置的聲音名字一致，可選的StopTones參數(shù)指定停止音。
7.1.9.2. Tone 包含文件
tone包含文件以.TZP為擴展名，指定了CTADE_A直接支持的聲音。
注意：
要從聲音包含文件中向Topaz Profile中添加信息，必須使用TopazProfile.exe（使用Copy命令，-C）將Topwz
Profile和包含的文件合并起來。為了保證每次CTADE_A啟動時都合并最新的聲音包含文件，可以使用函數(shù)TopazProfile.exe（使用Include選項,-I）向Topaz.ini文件的[ProfileIncludeFiles]部分添加一個索引。
ToneCount
ToneCount Profile ID指出需要定義的聲音的數(shù)目，從0開始。
ToneName
VOS應用程序使用ToneName來確定播放哪一個聲音。
ToneType
當前CTADE_A支持四種聲音：
SingleContinuous
SingleCadence
DualContinuous
DualCadence
這些種類聲音的描述參見Playing Tones 部分。
Freqencies（ToneFreq1，ToneFreq2）
聲音的頻率在300Hz到2000Hz之間。
Amplitudes（ToneAmp1，ToneAmp2）
以分貝表示聲音的幅度，有效幅度范圍是：-40到2 dB。
ToneOnTime
ToneOnTime參數(shù)指定了播放步調聲音時的聲音時間長度，以0.1秒為單位。
ToneOffTime
ToneOffTime Profile ID定義了播放步調聲音時靜音的時間長度，以0.1秒為單位。
ToneFreq1Var
檢測頻率1時允許的誤差，以Hz為單位。 ToneFreq2Var
檢測頻率2時允許的誤差，以Hz為單位。
ToneOnTimeVar
檢測步調音時，"OnTime"所允許的誤差，以0.1秒為單位。
ToneOffTimeVar
檢測步調音時，"OffTime"所允許的誤差，以0.1秒為單位。
ToneRepetitions
確定檢測出步調音要求的步調音的重復次數(shù)。
ToneChar
ToneChar為聲音分配一個字符（從E到Z）。自定義聲音檢測前，必須為聲音分配一個字符。
ToneIsBuffered
ToneIsBuffered是一個布爾值，指出CTADE_A是否將聲音字符放入數(shù)字緩沖，可以使用VOS函數(shù)MediaGetDigitBuffer來檢索。
例：
8. VOS 運行日志
VOS運行時產(chǎn)生日志文件VOS1.log和VOS2.log。最新的日志總在VOS1.log文件中。這些文件的內容如下：
Start of run
010518 172034.35 VOS loaded from C:\Program Files\Parity
Software\Graphical
VOS\Bin\Vos7d.dll
010518 172034.35 VOS 7 (Debug) Built Apr 4 2001
13:43:51
End of run
010518 172038.05 CASEST~1:062b[0] VOS 7 (Debug)
Built Apr 4 2001 13:43:51
010518 172038.05 CASEST~1:062b[0] Stopping: exit(21)
Warnings, Failures, and Errors
010518 172036.14 @W 713 RLL Adorll missing, wrong
version or loaded in wrong order
010518 172036.17 CASEST~1:149b[0] @F fil_open(LOGO,r):
088 error 2
010518 172037.91 CASEST~1:0606[0] @E CADOConn
'Open' : Films : COM Error
0x80004005(Unspecified error ) : _Connection::Open()
010518 172037.91 CASEST~1:0606[0] Source = Microsoft
OLE DB Provider for ODBC
Drivers
010518 172037.91 CASEST~1:0606[0] Description
= [Microsoft][ODBC Microsft
Access Driver] Could not find file '(unknown)'.
Builtin function calls
010518 172036.15 CASEST~1:004b[0] @B getpid()
= 0
Driver / API
010727 164728.19 @D ATDX_TERMMSK(1[dxxxB1C1])=0x0
010727 164728.19 @D Dev 1 dxxxB1C1 Evt 0x86 Data
0x15b9350 CST Data 0x0 Rings received
010727 164728.19 @D ATDX_TERMMSK(1[dxxxB1C1])=0x0
Topaz Events / States
010727 164728.19 CASEST~2:0017[1] @Y Trunk:0 Event
dxxxB1C1[1] 134 CST Data 0x0 Rings
received
010727 164728.19 CASEST~2:0017[1] @Z Trunk:0 Idle->InboundRinging
(1)
010727 164728.19 ResumeTask(1, 1)
010727 164728.27 CASEST~2:001f[1] @D dx_sethook(1[dxxxB1C1],
1, EV_ASYNC)=0
010727 164728.27 CASEST~2:001f[1] @B TrunkAnswerCall()
= 1
[ 全文英文版 ]
|
