mtlFile

chooseLocalFiles

模块概述

此模块封装了通过系统资源管理器选择文件的功能

模块接口

chooseLocalFiles

打开系统文件选择，选择文件后返回路径。注意：由于Android11文件沙盒存储模式，尽量从侧边栏手机图标点击进去，从”最近“、“下载”等其他路径访问可能无法拿到文件真实路径。

chooseLocalFiles({params}, callback(ret,err))

parames

maxNumber:

  • 类型：数字
  • 描述：（可选项）可以选择文件的最大数量 默认是5，不能超过5或者小于等于0，这种情况默认是5个

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:true,                //布尔类型；是否成功返回
    localfiles:[],              //array；返回选择的文件列表信息，包含以下字段：
                                        //fileName:文件名 string类型
                                        //filePath:文件路径 string类型
                                        //fileSize:文件大小 数字类型        }

err：

  • 类型：JSON 对象
  • 内部字段：
{
    message:'',                        //字符串类型；错误信息
}

示例代码

var mtlFile = api.require('mtlFile');
mtlFile.chooseLocalFiles({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本