QuickTime Asset Xtra函数详解！

在使用QuickTime Asset Xtra时，较为常用的控制函数如下：
◆ 属性：#controller
函数：SetIconProperty(IconID@"Icontitle", #controller, state)
GetIconProperty(IconID@"Icontitle", #controller)
说明：设置、取得控制条的显示状态。当参数state为TRUE时，显示控制条，否则隐藏控制条。例如：
if GetIconProperty(IconID@"QuickTime", #controller)=FALSE then
SetIconProperty(IconID@"QuickTime", #controller, TRUE)
end if
◆ 属性：#cuePointNames
函数：GetIconProperty(IconID@"Icontitle", #cuePointNames)
说明：以线性列表形式返回电影文件中提示点的名称。
◆ 属性：#cuePointTimes
函数：GetIconProperty(IconID@"Icontitle", #cuePointTimes)
说明：以线性列表形式返回电影文件中提示点的时间，单位为毫秒。
◆ 属性：#currentTime
函数：GetSpriteProperty(IconID@"Icontitle", #currentTime)
说明：获得当前已经播放的时间，单位为毫秒。
◆ 属性：#digitalVideoType
函数：GetIconProperty(IconID@"Icontitle", #digitalVideoType)
说明：返回值始终为#quickTime。
◆ 属性：#directToStage
函数：SetIconProperty(IconID@"Icontitle", #directToStage,state)
GetIconProperty(IconID@"Icontitle", #directToStage)
说明：设置、取得播放文件属性是否为最优显示。参数state为TRUE时播放文件为最优显示，将显示在演示窗口的最上层。
◆ 属性：#duration
函数：GetIconProperty(IconID@"Icontitle", #duration)
说明：返回播放文件所持续的总时间，单位为ticks（1／60秒）。
◆ 属性：#filename
函数：SetIconProperty(IconID@"Icontitle", #filename,file)
GetIconProperty(IconID@"Icontitle", #filename)
说明：设置、取得控件播放文件的路径，可以使用相对路径或绝对路径。例如：
SetIconProperty(IconID@"QuickTime", #filename, "sample.mov")
SetIconProperty(IconID@"QuickTime", #filename, "D:\\QTVR.mov")
SetIconProperty(IconID@"QuickTime", #filename, FileLocation^"QT.mov")
◆ 属性：#frameRate
函数：SetIconProperty(IconID@"Icontitle", #frameRate, rate)
GetIconProperty(IconID@"Icontitle", #frameRate)
说明：设置、取得文件的播放速率。参数rate为-2时，以能达到的最快速度播放文件；参数rate为-1时，以正常速度播放每一帧；参数rate为0时，和声音保持同步播放；参数rate为大于0的某个数字n时，即将播放速率设置为n帧/秒。
◆ 属性：#loop
函数：SetIconProperty(IconID@"Icontitle", #loop, state)
GetIconProperty(IconID@"Icontitle", #loop)
说明：设置、取得文件是否循环播放。参数state为TRUE时循环播放文件。
◆ 属性：#loopBounds
函数：SetSpriteProperty(IconID@"Icontitle", #loopBounds, [startTime, endTime])
GetSpriteProperty(IconID@"Icontitle", #loopBounds)
说明：设置、取得文件中循环播放的某个片段，片段由列表[startTime, endTime]指定，单位为ticks。例如：
SetSpriteProperty(IconID@"QuickTime", #loopBounds, [200, 1000])
◆ 属性：#mediaBusy
函数：GetSpriteProperty(IconID@"Icontitle", #mediaBusy)
说明：如果指定图标中的媒体文件正在播放，则返回值为TRUE，否则为FALSE。
◆ 属性：#mediaReady
函数：GetIconProperty(IconID@"Icontitle", #mediaReady)
说明：如果指定图标中的媒体文件播放就绪，则返回值为TRUE，否则为FALSE。
◆ 属性：#mouseLevel
函数：SetSpriteProperty(IconID@"Icontitle", #mouseLevel, value)
GetSpriteProperty(IconID@"Icontitle", #mouseLevel)
说明：设置、取得控件响应鼠标动作的模式。参数value为#controller时，在控制条上响应鼠标动作；参数value为#all时，则在整个播放画面内响应鼠标动作；参数value为#none时，不响应鼠标动作。
◆ 属性：#mRate
函数：SetSpriteProperty(IconID@"Icontitle", #mRate, value)
GetSpriteProperty(IconID@"Icontitle", #mRate)
说明：设置、取得播放速度比率。参数value为1时以正常速度播放；参数value为-1时逆序播放；参数value为0时停止播放；参数value在0到1之间时为慢放，超过1时则为快放。
◆ 属性：#mTime
函数：SetSpriteProperty(IconID@"Icontitle", #mTime, value)
GetSpriteProperty(IconID@"Icontitle", #mTime)
说明：设置、取得文件当前的播放时间，单位为ticks。例如：
current := GetSpriteProperty(IconID@"QuickTime", #mTime)
SetSpriteProperty(IconID@"QuickTime", #mTime, current+600)
◆ 属性：#pausedAtStart
函数：SetIconProperty(IconID@"Icontitle", #pausedAtStart, state)
GetIconProperty(IconID@"Icontitle", #pausedAtStart)
说明：设置、取得文件是否在开始播放时暂停。参数state为TRUE时则在开始时暂停。
◆ 属性：#percentStreamed
函数：GetIconProperty(IconID@"Icontitle", #percentStreamed)
说明：返回指定图标中媒体文件加载的百分比。
◆ 属性：#preload
函数：SetIconProperty(IconID@"Icontitle", #preload, state)
GetIconProperty(IconID@"Icontitle", #preload)
说明：设置、取得文件是否预载入。参数state为TRUE时预载入播放文件。
◆ 函数：QuickTimeVersion()
说明：取得当前系统中安装的最新版本的QuickTime的版本号。
◆ 属性：#rotation
函数：SetIconProperty(IconID@"Icontitle", #rotation, degrees)
GetIconProperty(IconID@"Icontitle", #rotation)
说明：设置、取得视频文件播放时画面旋转的角度。例如：
degrees := GetIconProperty(IconID@"QuickTime", #rotation)
SetIconProperty(IconID@"QuickTime", #rotation, degrees+30)
◆ 属性：#scale
函数：SetIconProperty(IconID@"Icontitle", #scale, [xPercent, yPercent])
GetIconProperty(IconID@"Icontitle", #scale)
说明：设置、取得视频文件播放时画面的缩放比率，参数xPercent和yPercent分别为横向和纵向缩放比率。例如：
SetIconProperty(IconID@"QuickTime", #scale, [150, 150])
◆ 属性：#sound
函数：SetIconProperty(IconID@"Icontitle", #sound, state)
GetIconProperty(IconID@"Icontitle", #sound)
说明：设置、取得视频文件中声音的播放状态。参数state为TRUE时播放声音，参数state为FALSE时不播放声音。例如：
state := GetIconProperty(IconID@"QuickTime", #sound)
SetIconProperty(IconID@"QuickTime", #sound, ~state)
◆ 属性：#video
函数：SetIconProperty(IconID@"Icontitle", #video, state)
GetIconProperty(IconID@"Icontitle", #video)
说明：设置、取得视频文件中画面的播放状态。参数state为TRUE时显示播放画面，参数state为FALSE时隐藏播放画面。例如：
state := GetIconProperty(IconID@"QuickTime", #video)
SetIconProperty(IconID@"QuickTime", #video, ~state)
◆ 属性：#volumeLevel
函数：SetSpriteProperty(IconID@"Icontitle", #volumeLevel, level)
GetSpriteProperty(IconID@"Icontitle", #volumeLevel)
说明：设置、取得播放文件时的音量。参数level取值范围为0到256。例如：
if GetSpriteProperty(IconID@"QuickTime", #volumeLevel) > 200 then
SetSpriteProperty(IconID@"QuickTime", #volumeLevel,150)
end if
其他不怎么常用的函数以及关于QuickTime VR的控制函数请用户参阅QuickTime Asset Xtra的帮助文件。

整理自“宇风多媒体论坛” ,作者“寒冰”