AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpencvPoint
- OpencvRect
- OpencvSize

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# 多媒体 (Media)#

此章节待补充或完善...

Marked by SuperMonster003 on Oct 22, 2022.

media模块提供多媒体编程的支持. 目前仅支持音乐播放和媒体文件扫描. 后续会结合UI加入视频播放等功能.

需要注意是, 使用该模块播放音乐时是在后台异步播放的, 在脚本结束后会自动结束播放, 因此可能需要插入诸如`sleep()`的语句来使脚本保持运行. 例如：

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

## media.scanFile(path)#

- `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 }

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