索引 |

目录

• Media#

  #

  • path <string> 媒体文件路径

  扫描路径path的媒体文件，将它加入媒体库中；或者如果该文件以及被删除，则通知媒体库移除该文件。

  媒体库包括相册、音乐库等，因此该函数可以用于把某个图片文件加入相册。

  //请求截图
  requestScreenCapture(false);
  //截图
  var im = captureScreen();
  var path = "/sdcard/screenshot.png";
  //保存图片
  im.saveTo(path);
  //把图片加入相册
  media.scanFile(path);
  

  media.playMusic(path[, volume, looping])#

  • path <string> 音乐文件路径
  • volume <number> 播放音量，为0~1的浮点数，默认为1
  • looping <boolean> 是否循环播放，如果looping为true则循环播放，默认为false

  播放音乐文件path。该函数不会显示任何音乐播放界面。如果文件不存在或者文件不是受支持的音乐格式，则抛出UncheckedIOException异常。

  //播放音乐
  media.playMusic("/sdcard/1.mp3");
  //让音乐播放完
  sleep(media.getMusicDuration());
  

  如果要循环播放音乐，则使用looping参数：

  //传递第三个参数为true以循环播放音乐 media.playMusic("/sdcard/1.mp3", 1, true); //等待三次播放的时间 sleep(media.getMusicDuration() * 3);

  如果要使用音乐播放器播放音乐，调用app.viewFile(path)函数。

  media.musicSeekTo(msec)#

  • msec <number> 毫秒数，表示音乐进度

  把当前播放进度调整到时间msec的位置。如果当前没有在播放音乐，则调用函数没有任何效果。

  例如，要把音乐调到1分钟的位置，为media.musicSeekTo(60 * 1000)。

  //播放音乐
  media.playMusic("/sdcard/1.mp3");
  //调整到30秒的位置
  media.musicSeekTo(30 * 1000);
  //等待音乐播放完成
  sleep(media.getMusicDuration() - 30 * 1000);
  

  media.pauseMusic()#

  暂停音乐播放。如果当前没有在播放音乐，则调用函数没有任何效果。

  media.resumeMusic()#

  继续音乐播放。如果当前没有播放过音乐，则调用该函数没有任何效果。

  media.stopMusic()#

  停止音乐播放。如果当前没有在播放音乐，则调用函数没有任何效果。

  media.isMusicPlaying()#

  • 返回 <boolean>

  返回当前是否正在播放音乐。

  media.getMusicDuration()#

  • 返回 <number>

  返回当前音乐的时长。单位毫秒。

  media.getMusicCurrentPosition()#

  • 返回 <number>

  返回当前音乐的播放进度(已经播放的时间)，单位毫秒。