文件

打开本地文件

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; // 错误信息
  }
});
是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/24