1、DirectMedia Xtra 用户指南介绍DirectMedia Xtra?是一种Sprite Xtra?。Sprite Xtra?可以用计算图标进行控制，而且属性也可以通过脚本指定，就像Authorware中的内置媒体文件一样。如果回放的系统允许，DirectMedia Xtra?还支持Microsofts DirectDraw? and DirectSound?。它总能够根据机器的不同选择最佳的播放效果，即使显示设置为256色，也能使用高彩色来播放媒体文件。DirectDraw?引擎利用直接写显存的技术增强回放效果。要建立一个图标，打开INSERT菜单，选择TABULEIRO XTRA
2、S - DirectMedia Xtra，这时会显示一个DirectMedia Xtra?属性对话框，单击browse file，打开另一个对话框，提示你选择一个媒体文件。它所支持的媒体类型有Mpeg, AVI, Quicktime?, WAV, AIF, MP2 和MIDI。文件可以在本地机器，也可以在局域网上其他计算机上，甚至可以用输入URL链接一个互联网上的文件。选好文件，点击OK，返回属性对话框，文件的长度（时间），尺寸等信息应能正确的显示出来。你可以预览文件，标注提示点并设置播放选项（工具条，音量，速率，平衡等等），单击OK完成。在流程线上就出现一个名为DirectMedia Xtr
3、a的图标，可以重新调整播放的位置和尺寸。提示点每一个DirectMedia Xtra可以有最多64个提示点，以毫秒位单位，每一个提示点的名字最多可以使用32个字符。要建立一个提示点就要在属性对话框中预览文件时确定时间，然后选择“ADD”，显示一个窗口定义提示点的名字。如果以后想修改提示点，在列表中双击名字就可以直接编辑了。使用GOTO检查提示点的定位，REMOVE用来删除一个提示点。用脚本建立提示点CallIcon(IconName, #addcuepoint, cuepointtime, cuepointname) - 这个函数建立一个新的提示点，cuepointtime是时间 cuepoi
4、ntname是名字，自动排列顺序。Example:CallIcon(DirectMedia Xtra, #addcuepoint, 10000, newcue)CallIcon(IconName, #removecuepoint, cuepointindex) - 删除一个提示点，需要指定提示点的序号。Example:CallIcon(DirectMedia Xtra, #removecuepoint, 1)使用提示点DirectMedia Xtra? 的提示点被用来在回放时几个方面的控制。下面是它的几个属性：isPastCuePoint(sprite) -经过的提示点the mostRece
5、ntCuePoint of sprite -最近的提示点the cuepointtimes of icon -指定提示点的时间the cuepointnames of icon -指定提示点的名字当媒体文件播放时，你必须设置一个事件响应以获取提示点，请参考所附带的例子程序。主要步骤是：建立一个“Event”类型的响应，在属性对话框中选择一个“Sender”图标名，再双击“Event Name”框中的“CuePointPassed”事件。这样，每当经过一个新的提示点，就触发这个响应。后面将要介绍的EventLastMatched变量会让你更多地了解这个事件。Properties 属性Direct
6、Media Xtra?所有的属性都可以很方便地在属性对话框中进行设置，这个对话框在你创建图标或者双击该图标时出现。同时，也可以通过脚本进行设置。Icon Properties 图标属性file -被使用的媒体文件的全路径名例如: result:=GetIconProperty(DirectMedia Xtra, #file)Trace(result)-“C:myfilefile.mpg”SetIconProperty(DirectMedia Xtra, #file,”C:myfile2.mpg”)title -媒体文件名，不带路径。这个属性用于在原目录找不到文件的时候。例如: result:=
7、GetIconProperty(DirectMedia Xtra, #title)Trace(result)-“file.mpg”注：基于HTTP的文件链接，DMX不会在启动时自动定位。showlocatefiledialog - DirectMedia Xtra在运行时会自动定位媒体文件，如果文件没有找到，使用这个属性可以显示一个指定文件的对话框，否则，就是一片空白。例如: SetIconProperty(DirectMedia Xtra, #showlocatefiledialog,TRUE)linkedmedialocated - 这个属性可以自动设置，用来表明媒体文件是否被正确调用。如
8、果属性的值为False，DirectMedia Xtra就不会进行初始化播放。例如: result:=GetIconProperty(DirectMedia Xtra, #linkedmedialocated)Trace(result)-“1”duration - 媒体文件的持续播放的时间，单位为毫秒。例如: result:=GetIconProperty(DirectMedia Xtra, #duration)Trace(result)- 45200videowidth - 媒体文件的播放宽度，单位为像素。例如: result:=GetIconProperty(DirectMedia Xtr
9、a, #videowidth)Trace(result)- 352videoheight -媒体文件的播放高度，单位为像素例如: result:=GetIconProperty(DirectMedia Xtra, #videoheight)Trace(result)- 240volume - 回放音频的音量。值的范围从-100到0（dB即分贝）例如: result:=GetIconProperty(DirectMedia Xtra, #volume)Trace(result)- -10SetIconProperty(DirectMedia Xtra, #volume,0)balance - 音
10、频回放平衡，值的范围从-100到100（dB即分贝）例如: result:=GetIconProperty(DirectMedia Xtra, #balance)Trace(result)- -100SetIconProperty(DirectMedia Xtra, #balance,0)rate - 回放速率。值的范围从0到200，是原来标准播放速度的百分比例。例如: result:=GetIconProperty(DirectMedia Xtra, #rate)Trace(result)- 100SetIconProperty(DirectMedia Xtra, #rate,80)cpub
11、oost - 由于DirectShow?技术要占用比较多的CPU时间，因此DirectMedia Xtra?会使Authorware?的运行变慢。如果你遇到回放缓慢或者断续的情况，可以使用这个属性设置。合法的取值范围是0到95（百分比），一般来说，超过60就可以解决问题了。例如: SetIconProperty(DirectMedia Xtra, #cpuboost,60)adjustdurationbeforeplayback - 如果这项属性的值为真，DirectMedia Xtra?就会在开始播放的同时确定媒体文件的可持续播放时间。这是十分必要的，因为对于同一个文件，不同的DirectS
12、how过滤器会报告不同的可持续播放时间。这样一来，当你把一个成品放到另一台机器运行的时候，DirectMedia Xtra?就有可能无法达到指定的提示点，或者它会认为文件还没有播放完。使用这个属性可以保证正常播放，因此你应该在大多数情况下都使用。例如: SetIconProperty(DirectMedia Xtra, #adjustdurationbeforeplayback,1)hastoolbar - 指出是否在播放窗口附带一个工具条。值为0（假）或1（真）。例如: SetIconProperty(DirectMedia Xtra, #hastoolbar,1)loop - 指出是否自动
13、循环播放文件。值为0（假）或1（真）。例如: SetIconProperty(DirectMedia Xtra, #loop,1)playsegment - 指出是否只播放文件的一个片断。值为0（假）或1（真）。例如: SetIconProperty(DirectMedia Xtra, #playsegment,1)segmentstart - 指定文件播放的起始时间，单位是毫秒。只在playsegment的值为真时有效。例如: SetIconProperty(DirectMedia Xtra, #segmentstart,10700)segmentend -指定文件播放的结束时间，单位是毫秒
14、。只在playsegment的值为真时有效。例如: SetIconProperty(DirectMedia Xtra, #segmentend,45800)pausedatstart - 指出是否在打开文件的时候暂停，不播放。值为0（假）或1（真）。例如: SetIconProperty(DirectMedia Xtra, #pausedatstart,1)cuepointtimes - 与该图标有关的提示点时间的列表。例如: result:=GetIconProperty(DirectMedia Xtra, #cuepointtimes)Trace(result)- 4500,12300,3
15、4650,67321cuepointnames -与该图标有关的提示点名字的列表例如: result:=GetIconProperty(DirectMedia Xtra, #cuepointnames)Trace(result)- Cue 1,NewCuePoint,Start Point,Second partSprite 属性currenttime - 媒体文件当前播放位置，单位是毫秒。例如: result:=GetSpriteProperty(DirectMedia Xtra, #currenttime)Trace(result)- 22345mediabusy - 表明媒体文件是否正在
16、播放。值为0（假）或1（真）。例如: result:=GetSpriteProperty(DirectMedia Xtra, #mediabusy)Trace(result)- 1mostrecentcuepoint - 最后经过的提示点的序号。例如: result:=GetSpriteProperty(DirectMedia Xtra, #mostrecentcuepoint)Trace(result)- 2Functions - 函数DirectMedia Xtra? 提供了几种函数功能，可以用脚本的方式使用来控制媒体文件的回放。Icon Functions - 图标函数CallIcon(
17、IconName, #isDirectShowInstalled) - 返回0（假）或1（真）。用来判断用户机上是否安装了DirectShow?。在正式版中有效。例如: result:=CallIcon(DirectMedia Xtra, #isDirectShowInstalled)Trace(result)- 1CallIcon(IconName, #addcuepoint, cuepointtime, cuepointname) - 这个函数可以通过脚本语言建立一个新的提示点，提示点会自动排列顺序。例如: CallIcon(DirectMedia Xtra, #addcuepoint,
18、10000, newcue)CallIcon(IconName, #removecuepoint, cuepointindex) - 这个函数可以把你指定序号的提示点删除。例如: CallIcon(DirectMedia Xtra, #removecuepoint, 1)CallIcon(IconName, #scanfile) - 当通过脚本语言改变要播放的媒体文件时，这个函数可以确定文件长度和可持续播放时间。它将自动查询文件并改变自身属性。Adjustdurationbeforeplayback也可以用来校对播放时间，我们建议使用这个属性来代替scanfile()，因为它更准确。例如: C
19、allIcon(DirectMedia Xtra, #scanfile)CallIcon(IconName, #register, registration number) - 在运行时对DirectMedia Xtra?进行注册。这个函数不常用。例如: CallIcon(DirectMedia Xtra, #register,SERIALNUMBERHERE”)Sprite 函数CallSprite(IconName, #videoplay) - 用于开始或是恢复播放媒体文件。通常在调用时会自动播放文件，除非选择了Paused at Start（在开始时暂停）例如: CallSprite(D
20、irectMedia Xtra , #videoplay)CallSprite(IconName, #videopause) - 暂停播放。例如: CallSprite(DirectMedia Xtra , #videopause)CallSprite(IconName, #videoseek , time) - 查找并暂停在指定的时间位置。时间单位是毫秒。例如: CallSprite(DirectMedia Xtra , #videoseek, 15000)CallSprite(IconName, #videoplaysegment , starttime, endtime) - 播放文件的
21、一个片断。请注意这个选项实际上限制了对片断以外其他部分的控制，因此应该再用另一个videoplaysegment()定位到其他的时间点上，跳出这个片断。例如: CallSprite(DirectMedia Xtra , #videoplaysegment, 10000, 20000)- the following command pauses the video in time location 30000CallSprite(DirectMedia Xtra , #videoplaysegment , 30000, 30000)CallSprite(IconName, #isPastCueP
22、oint , cuepointindex) - 判断指定序号的提示点是否已经经过了。返回值为0（假）或1（真）。例如: result:=CallSprite(DirectMedia Xtra , #isPastCuePoint, 2)Trace(result)- 1CallSprite(IconName, #setvolume, volume) - 设置音频回放的音量。赋值范围从-100到0（dB /分贝）。例如: CallSprite(DirectMedia Xtra , #setvolume , 0)CallSprite(IconName, #getvolume) - 返回当前音频播放的音
23、量值，单位是dB /分贝。例如: result:=CallSprite(DirectMedia Xtra , #getvolume)Trace(result)- -20CallSprite(IconName, #setbalance, balance) - 设置音频回放的平衡。赋值范围从-100到100（dB /分贝）。例如: CallSprite(DirectMedia Xtra , #setvolume , 0)CallSprite(IconName, #getbalance) -返回当前音频播放的平衡值，单位是dB /分贝。例如: result:=CallSprite(DirectMed
24、ia Xtra , #getbalance)Trace(result)- -100CallSprite(IconName, #setrate , rate) -设置播放速率。赋值范围从0到200（%）例如: CallSprite(DirectMedia Xtra , #setrate , 80)CallSprite(IconName, #getrate) - 返回当前播放速率，百分比值。例如: result:=CallSprite(DirectMedia Xtra , #getrate)Trace(result)- 100CallSprite(IconName, #setfulscreen)
25、- 这个函数利用ActiveMovie/DirectShow实现全屏播放。它的全屏播放方式是完全独立的，无论你的程序是否工作在全屏状态下。在此期间不响应鼠标和键盘事件，因此要利用提示点来返回程序，而且在结束时要使用一次RemoveFullScreen()函数。例如: CallSprite(DirectMedia Xtra , #setfullscreen)CallSprite(IconName, #removefulscreen) - 停止ActiveMovie/DirectShow的全屏播放。返回到Authorware的展示窗口。例如: CallSprite(DirectMedia Xtra
26、 , #removefullscreen 1)Creating Executables - 建立可执行文件DirectMedia Xtra? 只能运行在Windows? 95, 98 and Windows NT? 环境。因此，你应该建立Windows? 95 and Windows NT? 的可执行文件。而且还要把DirectMediaXtra.x32文件放到XTRAS文件夹中，和你的可执行文件放在同一个目录下。最终的文件结构应该像下面这样：DirectMedia Xtra?会自动定位所有在同一目录下的相关媒体文件，或者在searchpath变量中指定的目录中的。但不会从HTTP服务器上查找媒体文件。
