媒体播放器-mediaplayer
描述
媒体播放器，父对象为service.ctl，无子对象。目前只支持MP3音频播放。
事件
- play： 播放开始时触发，事件函数定义：onPlay(path)， path是当前开始播放的文件路径
- complete：播放结束时触发，事件函数定义：onComplete(path)，path是当前结束播放的文件路径
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| enabled | 使能，布尔值，默认值为false | 无 |
| volume | 音量，取值范围 0 ~ 100，默认值70 | service.ctl.mediaplayer.volume=80 设置音量为80 |
| mode | 模式，0-Normal, 1-Repeat, 2-Repeat_All。模式只在有播放列表时才生效 | service.ctl.mediaplayer.mode=1 设置单曲循环播放 |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| play(path) | 开始播放指定的媒体文件，如果之前正在播放，会立刻停止之前的播放。播放模式不适用本方法。 | service.ctl.mediaplayer.play('a.mp3')播放资源管理器添加的媒体文件 service.ctl.mediaplayer. play('/storage/d0/b.mp3')播放U盘上的媒体文件 |
| play() | 开始播放列表中的第一个媒体文件，需要先使用appendPlayList(list)方法添加。播放模式适用本方法。 | service.ctl.mediaplayer.play() 播放列表中的第一个媒体文件 |
| play(index) | 播放列表中index位置的媒体文件，需要先使用appendPlayList(list)方法添加。播放模式适用本方法。 | service.ctl.mediaplayer.play(1) 播放列表中index=1的媒体文件 |
| getCurrentIndex() | 获取当前播放的媒体文件在播放列表中的index值 | int index = service.ctl.mediaplayer. getCurrentIndex() 获取当前正在播放媒体文件在列表中的index值 |
| pause() | 暂停播放，如果需要恢复播放可以再调用一次pause()方法 | service.ctl.mediaplayer.pause() 暂停播放 service.ctl.mediaplayer.pause() 恢复播放 |
| stop() | 停止播放 | service.ctl.mediaplayer.stop() 停止播放 |
| appendPlayList(list) | 添加文件路径到播放列表，参数可以是字符串或者字符串数组 | service.ctl.mediaplayer.appendPlayList('test.mp3')添加单个文件到播放列表 service.ctl.mediaplayer. appendPlayList(['a.mp3','b.mp3','c.mp3'])添加多个文件到播放列表 |
| getPlayListSize() | 获取播放列表大小 | var size = service.ctl.mediaplayer. getPlayListSize() 获取播放列表大小 |
| clearPlayList() | 清除所有的播放列表，如果当前的播放未完成，并不会立即停止播放 | service.ctl.mediaplayer.clearPlayList()清除播放列表 |