文件

打开本地文件

openLocalFile
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎

参数

字段 类型 必填 说明
filePath string 文件的本地地址(通过下载文件获取的本地路径)
fileType string 文件格式jpeg,txt,pdf等

返回参数说明

字段 类型 说明
error_code number 返回的状态码
tip_level number 提示级别
error_description string 提示信息

示例

mtl.openLocalFile({
  filePath:'/var/mobile/Containers/Data/Caches/e61190ef76c6a7efab37ba85fdfaaf51f3de667b.jpg',
  fileType:'jpg',
  success: function(res) {
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

选择本地文件

chooseLocalFiles
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎

参数

字段 类型 必填 说明
maxNumber number 可以选择文件的最大数量默认是5,不能超过5或者小于等于0,这种情况默认是5个

成功回调返回

字段 类型 说明
localfiles array 文件描述列表

file参数

字段 类型 说明
fileName string 文件名称
filePath string 文件路径
fileSize long 文件大小

示例

mtl.chooseLocalFiles({
  maxNumber:3,
  success: function(res) {
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

选取本地文件并上传友空间服务器

chooseLocalFileToServer
选取本地文件,上传到友空间服务器,并返回文件名称、路径、类型等信息。 android:最大可选数为5,所选文件不大于100MB、且不能为空。 IOS:选择iCloud文件,仅支持单选文件,所选文件不大于100MB、且不能为空。(友空间5.19.0及以上版本)
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎

参数
-无-

返回参数说明

参数 类型 说明
files array 文件描述列表

files内部结构字段说明

参数 类型 说明
fileId number 文件id
fileName string 文件名称
filePath string 文件路径
fileSize long 文件大小

示例

mtl.chooseLocalFileToServer({
  success: function(res) {
    // 成功回调
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
})
{
    "data": {
        "files": [
            {
                "fileId": 147813,
                "fileName": "65a13e61b00be098e0ce3cf11a23ea55.png",
                "filePath": "http://ykj-esn-test.oss-cn-beijing.aliyuncs.com/1/3274608/201904/23/155598836793295aa4940b600da0102d89fd2f69f5.png",
                "fileSize": 8293,
            },
            {
                "fileId": 147814,
                "fileName": "一种图元属性定制机制.doc",
                "filePath": "http://ykj-esn-test.oss-cn-beijing.aliyuncs.com/17164/3274608/201904/12/1555050649bd86effaced8a184b1779cdabfd7e89d.doc",
                "fileSize": 222720,
            }
        ]
    }
}

文件预览

previewDoc
提供文件下载url或者文件fid,实现文件的预览,界面可包含下载等功能。(友空间5.18.0及以上版本)

注:
有文件fid传入文件fid,传参参考-参数1
没有文件fid必须传入下载url,传参参考-参数2

支持平台

微信 友空间 安卓 iOS
✔︎

参数1(文件有fid)

字段 类型 默认值 必填 说明
fileId string 文件ID
fromType number 0 文件来源

返回参数说明1

参数 类型 说明
fromType number 0:来自文库,1:IM,2:web,3:项目,4:旧IM,6:公告附件,7:新NC预览,8:任务预览

参数2(文件有下载地址)

字段 类型 默认值 必填 说明
downloadUrl string 文件下载url
fromType number 5 文件来源
fileName string 文件名,且文件名必须带后缀名
needDownload number 是否需要下载按钮
0 不需要,1需要
金格编辑时此参数不起作用
upload_url string 上传的文件服务器地址,只有金格编辑才必须要传此参数。否则不用传

返回参数说明2

参数 类型 说明
fromType number 5:下载地址预览,9:金格编辑
金格编辑只支持pdf格式

示例

mtl.previewDoc({
  // 参数1
  fileId: '130423',
  fromType: 0,
  // 参数2
  downloadUrl: 'http://ykj-esn-test.oss-cn-beijing.aliyuncs.com//153437/1/201811/1/1541052859669H.jpg',
  fromType: 5,
  fileName: '金田一1.jpg',
  needDownload: 1, 
  upload_url: '',
  success: function(res) {
    // 成功回调
    let first = res[0];
    let fileName = first.fileName;
    ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

是否仍需要帮助? 请保持联络!
最后更新于 2023/01/18