学习电脑信息DirectMediaXtra用户指南

Page7DirectMediaXtra用户指南介绍

DirectMediaXtra?是一种SpriteXtra?。SpriteXtra?可以用计算图标进行限制，而且属性也可以通过脚本指定，就像Authorware中的内置媒体文件一样。

假如回放的系统允许，DirectMediaXtra?还支持Microsoft’sDirectDraw?andDirectSound?。它总能够依据机器的不同选择最佳的播放效果，即使显示设置为256色，也能运用高彩色来播放媒体文件。DirectDraw?引擎利用干脆写显存的技术增加回放效果。

要建立一个图标，打开INSERT菜单，选择TABULEIROXTRAS->DirectMediaXtra，这时会显示一个DirectMediaXtra?属性对话框，单击browsefile，打开另一个对话框，提示你选择一个媒体文件。它所支持的媒体类型有Mpeg,AVI,Quicktime?,WAV,AIF,MP2和MIDI。文件可以在本地机器，也可以在局域网上其他计算机上，甚至可以用输入URL链接一个互联网上的文件。选好文件，点击OK，返回属性对话框，文件的长度（时间），尺寸等信息应能正确的显示出来。

你可以预览文件，标注提示点并设置播放选项（工具条，音量，速率，平衡等等），单击OK完成。在流程线上就出现一个名为DirectMediaXtra的图标，可以重新调整播放的位置和尺寸。

提示点

每一个DirectMediaXtra可以有最多64个提示点，以毫秒位单位，每一个提示点的名字最多可以运用32个字符。要建立一个提示点就要在属性对话框中预览文件时确定时间，然后选择“ADD”，显示一个窗口定义提示点的名字。假如以后想修改提示点，在列表中双击名字就可以干脆编辑了。运用"GOTO"检查提示点的定位，"REMOVE"用来删除一个提示点。

用脚本建立提示点

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")-这个函数建立一个新的提示点，cuepointtime是时间cuepointname是名字，自动排列依次。

Example:

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

CallIcon(@"IconName",#removecuepoint,cuepointindex)-删除一个提示点，须要指定提示点的序号。

Example:

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

运用提示点

DirectMediaXtra?的提示点被用来在回放时几个方面的限制。下面是它的几个属性：

isPastCuePoint(sprite)à经过的提示点

themostRecentCuePointofspriteà最近的提示点

thecuepointtimesoficonà指定提示点的时间

thecuepointnamesoficonà指定提示点的名字

当媒体文件播放时，你必需设置一个事务响应以获得提示点，请参考所附带的例子程序。主要步骤是：建立一个“Event”类型的响应，在属性对话框中选择一个“Sender”图标名，再双击“EventName”框中的“CuePointPassed”事务。这样，每当经过一个新的提示点，就触发这个响应。后面将要介绍的EventLastMatched变量会让你更多地了解这个事务。

Properties属性

DirectMediaXtra?全部的属性都可以很便利地在属性对话框中进行设置，这个对话框在你创建图标或者双击该图标时出现。同时，也可以通过脚本进行设置。

IconProperties图标属性

file被运用的媒体文件的全路径名

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

Trace(result)

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

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

title媒体文件名，不带路径。这个属性用于在原书目找不到文件的时候。

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

Trace(result)

--“file.mpg”

注：基于HTTP的文件链接，DMX不会在启动时自动定位。

showlocatefiledialogDirectMediaXtra在运行时会自动定位媒体文件，假如文件没有找到，运用这个属性可以显示一个指定文件的对话框，否则，就是一片空白。

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

linkedmedialocated这个属性可以自动设置，用来表明媒体文件是否被正确调用。假如属性的值为False，DirectMediaXtra就不会进行初始化播放。

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

Trace(result)

--“1”

duration媒体文件的持续播放的时间，单位为毫秒。

例如: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，是原来标准播放速度的百分比例。

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

Trace(result)

--100

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

cpuboost由于DirectShow?技术要占用比较多的CPU时间，因此DirectMediaXtra?会使Authorware?的运行变慢。假如你遇到回放缓慢或者断续的状况，可以运用这个属性设置。合法的取值范围是0到95（百分比），一般来说，超过60就可以解决问题了。

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

adjustdurationbeforeplayback假如这项属性的值为真，DirectMediaXtra?就会在起先播放的同时确定媒体文件的可持续播放时间。这是非常必要的，因为对于同一个文件，不同的DirectShow过滤器会报告不同的可持续播放时间。这样一来，当你把一个成品放到另一台机器运行的时候，DirectMediaXtra?就有可能无法达到指定的提示点，或者它会认为文件还没有播放完。运用这个属性可以保证正常播放，因此你应当在大多数状况下都运用。

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

hastoolbar指出是否在播放窗口附带一个工具条。值为0（假）或1（真）。

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

loop指出是否自动循环播放文件。值为0（假）或1（真）。

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

playsegment指出是否只播放文件的一个片断。值为0（假）或1（真）。

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

segmentstart指定文件播放的起始时间，单位是毫秒。只在playsegment的值为真时有效。

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

segmentend指定文件播放的结束时间，单位是毫秒。只在playsegment的值为真时有效。

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

pausedatstart指出是否在打开文件的时候暂停，不播放。值为0（假）或1（真）。

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

cuepointtimes与该图标有关的提示点时间的列表。

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

Trace(result)

--[4500,12300,34650,67321]

cuepointnames与该图标有关的提示点名字的列表

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

Trace(result)

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

Sprite属性

currenttime媒体文件当前播放位置，单位是毫秒。

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

Trace(result)

--22345

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

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

Trace(result)

--1

mostrecentcuepoint最终经过的提示点的序号。

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

Trace(result)

--2

Functions函数

DirectMediaXtra?供应了几种函数功能，可以用脚本的方式运用来限制媒体文件的回放。

IconFunctions图标函数

CallIcon(@"IconName",#isDirectShowInstalled)返回0（假）或1（真）。用来推断用户机上是否安装了DirectShow?。在正式版中有效。

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

Trace(result)

--1

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")这个函数可以通过脚本语言建立一个新的提示点，提示点会自动排列依次。

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

CallIcon(@"IconName",#removecuepoint,cuepointindex)这个函数可以把你指定序号的提示点删除。

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

CallIcon(@"IconName",#scanfile)当通过脚本语言变更要播放的媒体文件时，这个函数可以确定文件长度和可持续播放时间。它将自动查询文件并变更自身属性。Adjustdurationbeforeplayback也可以用来校对播放时间，我们建议运用这个属性来代替scanfile()，因为它更精确。

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

CallIcon(@"IconName",#register,registrationnumber)在运行时对DirectMediaXtra?进行注册。这个函数不常用。

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

Sprite函数

CallSprite(@"IconName",#videoplay)用于起先或是复原播放媒体文件。通常在调用时会自动播放文件，除非选择了"PausedatStart"（在起先时暂停）

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

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

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

CallSprite(@"IconName",#videoseek,time)查找并暂停在指定的时间位置。时间单位是毫秒。

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

CallSprite(@"IconName",#videoplaysegment,starttime,endtime)播放文件的一个片断。请留意这个选项事实上限制了对片断以外其他部分的限制，因此应当再用另一个videoplaysegment()定位到其他的时间点上，跳出这个片断。

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

--thefollowingcommandpausesthevideointimelocation30000

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

CallSprite(@"IconName",#isPastCuePoint,cuepointindex)推断指定序号的提示点是否已经经过了。返回值为0（假）或1（真）。

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

Trace(result)

1

CallSprite(@"IconName",#setvolume,volume)设置音频回放的音量。赋值范围从-100到0（dB/分贝）。

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

CallSprite(@"IconName",#getvolume)返回当前音频播放的音量值，单位是dB/分贝。

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

Trace(result)

---20

CallSprite(@"IconName",#setbalance,balance)设置音频回放的平衡。赋值范围从-100到100（dB/分贝）。

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

CallSprite(@"IconName",#getbalance)返回当前音频播放的平衡值，单位是dB/分贝。

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

Trace(result)

---100

CallSprite(@"IconName",#setrate,rate)设置播放速率。赋值范围从0到200（%）

例如:CallSprite