相册与文件

统计、清空相册里的照片和视频，把图片或视频存进相册，以及把文件下载到 App 里。第一次用会请求相册权限。

功能概览

·存、删都要等系统真正做完才返回 true / false
·删除时会自动点掉系统的确认框

getPicCount#

相册里的图片数量（不含视频）。

typescript

getPicCount(): number;

返回值

类型	描述
`number`	图片数量；没有相册权限时是 0，并写一条日志。

示例

javascript

logi('photos: ' + getPicCount());

参见 getVideoCount

getVideoCount#

相册里的视频数量。

typescript

getVideoCount(): number;

返回值

类型	描述
`number`	视频数量；没有相册权限时是 0。

示例

javascript

logi('videos: ' + getVideoCount());

参见 getPicCount

deleteAllPic#

删掉相册里的所有图片。

typescript

deleteAllPic(): boolean;

返回值

类型	描述
`boolean`	删完才返回：删成功（或者本来就没有）返回 true，失败（没有相册权限、用户拒绝等）返回 false，原因写进错误日志。

异常

异常类型	触发条件
`WDAError`FEATURE_UNAVAILABLE	设备上的 App 版本太旧，没有这个功能。升级 App 即可。

注意事项

iOS 删除相册内容一定会弹系统确认框，脚本会自动点「删除」；过程中会切到「照片」App 再切回原来的 App。
删掉的内容会先进「最近删除」，30 天内还能找回；iOS 没有公开接口能清空「最近删除」。

示例

javascript

if (!deleteAllPic()) {
  return false;
}

参见 deleteAllVideo、deleteAllPicAndVideo

deleteAllVideo#

删掉相册里的所有视频。用法同 deleteAllPic。

typescript

deleteAllVideo(): boolean;

返回值

类型	描述
`boolean`	删完才返回：删成功（或者本来就没有）返回 true，失败（没有相册权限、用户拒绝等）返回 false，原因写进错误日志。

异常

异常类型	触发条件
`WDAError`FEATURE_UNAVAILABLE	设备上的 App 版本太旧，没有这个功能。升级 App 即可。

注意事项

iOS 删除相册内容一定会弹系统确认框，脚本会自动点「删除」；过程中会切到「照片」App 再切回原来的 App。
删掉的内容会先进「最近删除」，30 天内还能找回；iOS 没有公开接口能清空「最近删除」。

示例

javascript

deleteAllVideo();

参见 deleteAllPic

deleteAllPicAndVideo#

删掉相册里的所有图片和视频。用法同 deleteAllPic。

typescript

deleteAllPicAndVideo(): boolean;

返回值

类型	描述
`boolean`	删完才返回：删成功（或者本来就没有）返回 true，失败（没有相册权限、用户拒绝等）返回 false，原因写进错误日志。

异常

异常类型	触发条件
`WDAError`FEATURE_UNAVAILABLE	设备上的 App 版本太旧，没有这个功能。升级 App 即可。

注意事项

iOS 删除相册内容一定会弹系统确认框，脚本会自动点「删除」；过程中会切到「照片」App 再切回原来的 App。
删掉的内容会先进「最近删除」，30 天内还能找回；iOS 没有公开接口能清空「最近删除」。

示例

javascript

deleteAllPicAndVideo();

参见 deleteAllPic

savePicVideo#

把一张图片或一段视频存进相册，按扩展名判断是图还是视频。

typescript

savePicVideo(pathOrBase64: string, filename?: string): boolean;

参数

参数名	类型	是否必填	默认值	描述
`pathOrBase64`	`string`	是	—	App 里的文件路径（相对 App 的 Documents 目录，downloadAndSaveFile 下载的文件都在 sync/ 下），或者 base64 数据（data: 开头的也认）。
`filename`	`string`	否	—	传 base64 时用它的扩展名判断是图还是视频，例如 cover.jpg、intro.mp4。

返回值

类型	描述
`boolean`	等系统真正写完才返回：存进去了返回 true，失败返回 false，原因写进错误日志。

异常

异常类型	触发条件
`WDAError`FEATURE_UNAVAILABLE	设备上的 App 版本太旧，没有这个功能。升级 App 即可。

示例

javascript

savePicVideo('sync/intro.mp4');
savePicVideo(client.screenshot(), 'screen.png');

参见 downloadAndSaveFile、downloadAndSavePicVideo

downloadAndSavePicVideo#

下载一张图片或一段视频，存进相册。按下载到的内容自动判断是图还是视频。

typescript

downloadAndSavePicVideo(url: string): boolean;

参数

参数名	类型	是否必填	默认值	描述
`url`	`string`	是	—	下载地址。以 / 开头的会自动补上服务器地址（比如「文件同步」里的文件）。

返回值

类型	描述
`boolean`	等系统真正写完才返回：存进去了返回 true，失败返回 false，原因写进错误日志。

异常

异常类型	触发条件
`WDAError`FEATURE_UNAVAILABLE	设备上的 App 版本太旧，没有这个功能。升级 App 即可。

示例

javascript

downloadAndSavePicVideo('https://example.com/a.mp4');

参见 savePicVideo

downloadAndSaveFile#

把任意文件下载到 App 的 sync/ 目录（在「文件」App → 我的 iPhone → WTScript → sync 里能看到），文件名取地址的最后一段。

typescript

downloadAndSaveFile(url: string): boolean;

参数

参数名	类型	是否必填	默认值	描述
`url`	`string`	是	—	完整的下载地址（http:// 或 https:// 开头）。

返回值

类型	描述
`boolean`	下载并保存成功返回 true。最多等 120 秒。

示例

javascript

if (downloadAndSaveFile('https://example.com/intro.mp4')) {
  savePicVideo('sync/intro.mp4');
}

参见 savePicVideo