中智盟Widget发手册_扩展.docVIP

中智盟 Widget开发手册 (扩展版) 中国智能多媒体终端技术联盟 2011-8-10目录 1 multiMediaPlayer类 4 版本历史 版本 日期 作者 描述 备注 2010-9-6 段宝山 初始版本 1.0.1 2011-1-25 段宝山 增加对多媒体播放器state取值及含义的说明 MultiMediaPlayer类 MultiMediaPlayer是中智盟自己开发的类，专门用于播放多媒体文件。MultiMediaPlayer支持播放本地文件，网络连接以及应用的压缩包中资源文件。MultiMediaPlayer只有一个实例，名为“multiMediaPlayer”，不能创建多个新的实例。其支持的属性及方法如下： 属性 名称 描述 类型 读/写 balance 只有在多媒体有音频信号时才起作用。用于控制音频信号的平衡值，其值在-1000至 1000之间，包含-1000和1000两个值。 -1000表示只有左声道有声音，1000只有右声道有声音。 integer Read-Write currentPosition 当前多媒体正在播放的位置，其值从0开始。 integer Read-Write duration 多媒体的总长度，以秒为单位。 integer Read error 最后一次的出错状态 integer Read src 指定多媒体的播放源。有两种形式，一种文件路径，一种是URL。其中文件路径可以是磁盘上的绝对路径，也可以是相对路径，也可以是Widget包中的路径。当要指定Widget包的中路径时，路径名前不得加“./”只需直接指定包中的路径名即可。比如资源文件名为“test.mp3”且放在包中的根下，那么用“test.mp3”即可，如果该文件在包中的一个目录“music”中，那么用“music/test.mp3”即可。如果Widget包中根目录下和磁盘当前目录下有同名文件存在，那么会播放磁盘中的文件，而不播放Widget包中的文件。比如当前目录有一个文件“test.mp3”，而Widget包的根目录中也有个文件“test.mp3”，那么当src=“test.mp3”时会播放当前目录中的那个“test.mp3”。 string Read-Write state 多媒体的当前状态。 integer Read callback 状态回调函数，当多媒体播放器的状态发生变化时即会回调该函数，同时把多媒体播放器当前的状态做为参数传给该函数。 function Write volume 只有在多媒体有音频信号时才起作用。用于控制音频信息的音量值，从 0至 1000 ，包含0和1000，0表示静音，1000表示最大音量。 integer Read-Write 方法 名称和参数 描述 返回值 play() 从当前位置开始播放一个多媒体。 void pause() 暂停播放一个多媒体。 void stop() 停止播放一个多媒体，同时其currentPosition回到0的位置。 void fastForward() 快进功能 void fastBackward() 快退功能 void seek(position) 定位播放位置，position单位为秒 void 多媒体播放器state取值及含义如下： 0：Playing 1：Paused 2：Stopped 3：FastForward 4：FastBackward 5：Inited 6：UnInited 7：End 因此当用户在自己为多媒体播放器设计的回调函数中检测到state为7时即表示已经播放结束，具体例子请参考下边代码。 示例代码： var getStateIntervalID; var songArray = [./YouRaiseMeUp.mp3, music/test.mp3, ../WidgetEngineData/YouRaiseMeUp.mp3, ../../NfsDir/WidgetEngineData/YouRaiseMeUp.mp3, YouRaiseMeUp.mp3, test.mp3,”/music/test.mp3”]; var songArrayIndex; function viewOnOpen() { debug.trace(Hello world.); /*一般在viewOnOpen函数中设置一次状态回调函数即可*/ multiMediaPlayer.callback = MultiMediaPlayerStateChanged; getStateInterval