學(xué)習(xí)電腦信息DirectMediaXtra用戶(hù)指南

Page7DirectMediaXtra用戶(hù)指南介紹

DirectMediaXtra?是一種SpriteXtra?。SpriteXtra?可以用計(jì)算圖標(biāo)進(jìn)行限制，而且屬性也可以通過(guò)腳本指定，就像Authorware中的內(nèi)置媒體文件一樣。

假如回放的系統(tǒng)允許，DirectMediaXtra?還支持Microsoft’sDirectDraw?andDirectSound?。它總能夠依據(jù)機(jī)器的不同選擇最佳的播放效果，即使顯示設(shè)置為256色，也能運(yùn)用高彩色來(lái)播放媒體文件。DirectDraw?引擎利用干脆寫(xiě)顯存的技術(shù)增加回放效果。

要建立一個(gè)圖標(biāo)，打開(kāi)INSERT菜單，選擇TABULEIROXTRAS->DirectMediaXtra，這時(shí)會(huì)顯示一個(gè)DirectMediaXtra?屬性對(duì)話(huà)框，單擊browsefile，打開(kāi)另一個(gè)對(duì)話(huà)框，提示你選擇一個(gè)媒體文件。它所支持的媒體類(lèi)型有Mpeg,AVI,Quicktime?,WAV,AIF,MP2和MIDI。文件可以在本地機(jī)器，也可以在局域網(wǎng)上其他計(jì)算機(jī)上，甚至可以用輸入U(xiǎn)RL鏈接一個(gè)互聯(lián)網(wǎng)上的文件。選好文件，點(diǎn)擊OK，返回屬性對(duì)話(huà)框，文件的長(zhǎng)度（時(shí)間），尺寸等信息應(yīng)能正確的顯示出來(lái)。

你可以預(yù)覽文件，標(biāo)注提示點(diǎn)并設(shè)置播放選項(xiàng)（工具條，音量，速率，平衡等等），單擊OK完成。在流程線(xiàn)上就出現(xiàn)一個(gè)名為DirectMediaXtra的圖標(biāo)，可以重新調(diào)整播放的位置和尺寸。

提示點(diǎn)

每一個(gè)DirectMediaXtra可以有最多64個(gè)提示點(diǎn)，以毫秒位單位，每一個(gè)提示點(diǎn)的名字最多可以運(yùn)用32個(gè)字符。要建立一個(gè)提示點(diǎn)就要在屬性對(duì)話(huà)框中預(yù)覽文件時(shí)確定時(shí)間，然后選擇“ADD”，顯示一個(gè)窗口定義提示點(diǎn)的名字。假如以后想修改提示點(diǎn)，在列表中雙擊名字就可以干脆編輯了。運(yùn)用"GOTO"檢查提示點(diǎn)的定位，"REMOVE"用來(lái)刪除一個(gè)提示點(diǎn)。

用腳本建立提示點(diǎn)

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")-這個(gè)函數(shù)建立一個(gè)新的提示點(diǎn)，cuepointtime是時(shí)間cuepointname是名字，自動(dòng)排列依次。

Example:

CallIcon(@"DirectMediaXtra",#addcuepoint,10000,"newcue")

CallIcon(@"IconName",#removecuepoint,cuepointindex)-刪除一個(gè)提示點(diǎn)，須要指定提示點(diǎn)的序號(hào)。

Example:

CallIcon(@"DirectMediaXtra",#removecuepoint,1)

運(yùn)用提示點(diǎn)

DirectMediaXtra?的提示點(diǎn)被用來(lái)在回放時(shí)幾個(gè)方面的限制。下面是它的幾個(gè)屬性：

isPastCuePoint(sprite)à經(jīng)過(guò)的提示點(diǎn)

themostRecentCuePointofspriteà最近的提示點(diǎn)

thecuepointtimesoficonà指定提示點(diǎn)的時(shí)間

thecuepointnamesoficonà指定提示點(diǎn)的名字

當(dāng)媒體文件播放時(shí)，你必需設(shè)置一個(gè)事務(wù)響應(yīng)以獲得提示點(diǎn)，請(qǐng)參考所附帶的例子程序。主要步驟是：建立一個(gè)“Event”類(lèi)型的響應(yīng)，在屬性對(duì)話(huà)框中選擇一個(gè)“Sender”圖標(biāo)名，再雙擊“EventName”框中的“CuePointPassed”事務(wù)。這樣，每當(dāng)經(jīng)過(guò)一個(gè)新的提示點(diǎn)，就觸發(fā)這個(gè)響應(yīng)。后面將要介紹的EventLastMatched變量會(huì)讓你更多地了解這個(gè)事務(wù)。

Properties屬性

DirectMediaXtra?全部的屬性都可以很便利地在屬性對(duì)話(huà)框中進(jìn)行設(shè)置，這個(gè)對(duì)話(huà)框在你創(chuàng)建圖標(biāo)或者雙擊該圖標(biāo)時(shí)出現(xiàn)。同時(shí)，也可以通過(guò)腳本進(jìn)行設(shè)置。

IconProperties圖標(biāo)屬性

file被運(yùn)用的媒體文件的全路徑名

例如:result:=GetIconProperty(@"DirectMediaXtra",#file)

Trace(result)

--“C:\myfile\file.mpg”

SetIconProperty(@"DirectMediaXtra",#file,”C:\myfile2.mpg”)

title媒體文件名，不帶路徑。這個(gè)屬性用于在原書(shū)目找不到文件的時(shí)候。

例如:result:=GetIconProperty(@"DirectMediaXtra",#title)

Trace(result)

--“file.mpg”

注：基于HTTP的文件鏈接，DMX不會(huì)在啟動(dòng)時(shí)自動(dòng)定位。

showlocatefiledialogDirectMediaXtra在運(yùn)行時(shí)會(huì)自動(dòng)定位媒體文件，假如文件沒(méi)有找到，運(yùn)用這個(gè)屬性可以顯示一個(gè)指定文件的對(duì)話(huà)框，否則，就是一片空白。

例如:SetIconProperty(@"DirectMediaXtra",#showlocatefiledialog,TRUE)

linkedmedialocated這個(gè)屬性可以自動(dòng)設(shè)置，用來(lái)表明媒體文件是否被正確調(diào)用。假如屬性的值為False，DirectMediaXtra就不會(huì)進(jìn)行初始化播放。

例如:result:=GetIconProperty(@"DirectMediaXtra",#linkedmedialocated)

Trace(result)

--“1”

duration媒體文件的持續(xù)播放的時(shí)間，單位為毫秒。

例如:result:=GetIconProperty(@"DirectMediaXtra",#duration)

Trace(result)

--45200

videowidth媒體文件的播放寬度，單位為像素。

例如:result:=GetIconProperty(@"DirectMediaXtra",#videowidth)

Trace(result)

--352

videoheight媒體文件的播放高度，單位為像素

例如:result:=GetIconProperty(@"DirectMediaXtra",#videoheight)

Trace(result)

--240

volume回放音頻的音量。值的范圍從-100到0（dB即分貝）

例如:result:=GetIconProperty(@"DirectMediaXtra",#volume)

Trace(result)

---10

SetIconProperty(@"DirectMediaXtra",#volume,0)

balance音頻回放平衡，值的范圍從-100到100（dB即分貝）

例如:result:=GetIconProperty(@"DirectMediaXtra",#balance)

Trace(result)

---100

SetIconProperty(@"DirectMediaXtra",#balance,0)

rate回放速率。值的范圍從0到200，是原來(lái)標(biāo)準(zhǔn)播放速度的百分比例。

例如:result:=GetIconProperty(@"DirectMediaXtra",#rate)

Trace(result)

--100

SetIconProperty(@"DirectMediaXtra",#rate,80)

cpuboost由于DirectShow?技術(shù)要占用比較多的CPU時(shí)間，因此DirectMediaXtra?會(huì)使Authorware?的運(yùn)行變慢。假如你遇到回放緩慢或者斷續(xù)的狀況，可以運(yùn)用這個(gè)屬性設(shè)置。合法的取值范圍是0到95（百分比），一般來(lái)說(shuō)，超過(guò)60就可以解決問(wèn)題了。

例如:SetIconProperty(@"DirectMediaXtra",#cpuboost,60)

adjustdurationbeforeplayback假如這項(xiàng)屬性的值為真，DirectMediaXtra?就會(huì)在起先播放的同時(shí)確定媒體文件的可持續(xù)播放時(shí)間。這是非常必要的，因?yàn)閷?duì)于同一個(gè)文件，不同的DirectShow過(guò)濾器會(huì)報(bào)告不同的可持續(xù)播放時(shí)間。這樣一來(lái)，當(dāng)你把一個(gè)成品放到另一臺(tái)機(jī)器運(yùn)行的時(shí)候，DirectMediaXtra?就有可能無(wú)法達(dá)到指定的提示點(diǎn)，或者它會(huì)認(rèn)為文件還沒(méi)有播放完。運(yùn)用這個(gè)屬性可以保證正常播放，因此你應(yīng)當(dāng)在大多數(shù)狀況下都運(yùn)用。

例如:SetIconProperty(@"DirectMediaXtra",#adjustdurationbeforeplayback,1)

hastoolbar指出是否在播放窗口附帶一個(gè)工具條。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#hastoolbar,1)

loop指出是否自動(dòng)循環(huán)播放文件。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#loop,1)

playsegment指出是否只播放文件的一個(gè)片斷。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#playsegment,1)

segmentstart指定文件播放的起始時(shí)間，單位是毫秒。只在playsegment的值為真時(shí)有效。

例如:SetIconProperty(@"DirectMediaXtra",#segmentstart,10700)

segmentend指定文件播放的結(jié)束時(shí)間，單位是毫秒。只在playsegment的值為真時(shí)有效。

例如:SetIconProperty(@"DirectMediaXtra",#segmentend,45800)

pausedatstart指出是否在打開(kāi)文件的時(shí)候暫停，不播放。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#pausedatstart,1)

cuepointtimes與該圖標(biāo)有關(guān)的提示點(diǎn)時(shí)間的列表。

例如:result:=GetIconProperty(@"DirectMediaXtra",#cuepointtimes)

Trace(result)

--[4500,12300,34650,67321]

cuepointnames與該圖標(biāo)有關(guān)的提示點(diǎn)名字的列表

例如:result:=GetIconProperty(@"DirectMediaXtra",#cuepointnames)

Trace(result)

--["Cue1","NewCuePoint","StartPoint","Secondpart"]

Sprite屬性

currenttime媒體文件當(dāng)前播放位置，單位是毫秒。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#currenttime)

Trace(result)

--22345

mediabusy表明媒體文件是否正在播放。值為0（假）或1（真）。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#mediabusy)

Trace(result)

--1

mostrecentcuepoint最終經(jīng)過(guò)的提示點(diǎn)的序號(hào)。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#mostrecentcuepoint)

Trace(result)

--2

Functions函數(shù)

DirectMediaXtra?供應(yīng)了幾種函數(shù)功能，可以用腳本的方式運(yùn)用來(lái)限制媒體文件的回放。

IconFunctions圖標(biāo)函數(shù)

CallIcon(@"IconName",#isDirectShowInstalled)返回0（假）或1（真）。用來(lái)推斷用戶(hù)機(jī)上是否安裝了DirectShow?。在正式版中有效。

例如:result:=CallIcon(@"DirectMediaXtra",#isDirectShowInstalled)

Trace(result)

--1

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")這個(gè)函數(shù)可以通過(guò)腳本語(yǔ)言建立一個(gè)新的提示點(diǎn)，提示點(diǎn)會(huì)自動(dòng)排列依次。

例如:CallIcon(@"DirectMediaXtra",#addcuepoint,10000,"newcue")

CallIcon(@"IconName",#removecuepoint,cuepointindex)這個(gè)函數(shù)可以把你指定序號(hào)的提示點(diǎn)刪除。

例如:CallIcon(@"DirectMediaXtra",#removecuepoint,1)

CallIcon(@"IconName",#scanfile)當(dāng)通過(guò)腳本語(yǔ)言變更要播放的媒體文件時(shí)，這個(gè)函數(shù)可以確定文件長(zhǎng)度和可持續(xù)播放時(shí)間。它將自動(dòng)查詢(xún)文件并變更自身屬性。Adjustdurationbeforeplayback也可以用來(lái)校對(duì)播放時(shí)間，我們建議運(yùn)用這個(gè)屬性來(lái)代替scanfile()，因?yàn)樗_。

例如:CallIcon(@"DirectMediaXtra",#scanfile)

CallIcon(@"IconName",#register,registrationnumber)在運(yùn)行時(shí)對(duì)DirectMediaXtra?進(jìn)行注冊(cè)。這個(gè)函數(shù)不常用。

例如:CallIcon(@"DirectMediaXtra",#register,"SERIALNUMBERHERE”)

Sprite函數(shù)

CallSprite(@"IconName",#videoplay)用于起先或是復(fù)原播放媒體文件。通常在調(diào)用時(shí)會(huì)自動(dòng)播放文件，除非選擇了"PausedatStart"（在起先時(shí)暫停）

例如:CallSprite(@"DirectMediaXtra",#videoplay)

CallSprite(@"IconName",#videopause)暫停播放。

例如:CallSprite(@"DirectMediaXtra",#videopause)

CallSprite(@"IconName",#videoseek,time)查找并暫停在指定的時(shí)間位置。時(shí)間單位是毫秒。

例如:CallSprite(@"DirectMediaXtra",#videoseek,15000)

CallSprite(@"IconName",#videoplaysegment,starttime,endtime)播放文件的一個(gè)片斷。請(qǐng)留意這個(gè)選項(xiàng)事實(shí)上限制了對(duì)片斷以外其他部分的限制，因此應(yīng)當(dāng)再用另一個(gè)videoplaysegment()定位到其他的時(shí)間點(diǎn)上，跳出這個(gè)片斷。

例如:CallSprite(@"DirectMediaXtra",#videoplaysegment,10000,20000)

--thefollowingcommandpausesthevideointimelocation30000

CallSprite(@"DirectMediaXtra",#videoplaysegment,30000,30000)

CallSprite(@"IconName",#isPastCuePoint,cuepointindex)推斷指定序號(hào)的提示點(diǎn)是否已經(jīng)經(jīng)過(guò)了。返回值為0（假）或1（真）。

例如:result:=CallSprite(@"DirectMediaXtra",#isPastCuePoint,2)

Trace(result)

1

CallSprite(@"IconName",#setvolume,volume)設(shè)置音頻回放的音量。賦值范圍從-100到0（dB/分貝）。

例如:CallSprite(@"DirectMediaXtra",#setvolume,0)

CallSprite(@"IconName",#getvolume)返回當(dāng)前音頻播放的音量值，單位是dB/分貝。

例如:result:=CallSprite(@"DirectMediaXtra",#getvolume)

Trace(result)

---20

CallSprite(@"IconName",#setbalance,balance)設(shè)置音頻回放的平衡。賦值范圍從-100到100（dB/分貝）。

例如:CallSprite(@"DirectMediaXtra",#setvolume,0)

CallSprite(@"IconName",#getbalance)返回當(dāng)前音頻播放的平衡值，單位是dB/分貝。

例如:result:=CallSprite(@"DirectMediaXtra",#getbalance)

Trace(result)

---100

CallSprite(@"IconName",#setrate,rate)設(shè)置播放速率。賦值范圍從0到200（%）

例如:CallSprite