mtlFile

模块概述

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

模块接口

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及更高版本