登录
企业内部开发 客户端API JS-SDK 微盘 选择文件
选择文件
最后更新：2023/07/26
接口说明：调用该接口，可唤起微盘选择器窗口，选择一个或多个微盘文件或文档。选中后返回对应文件的url。
调用前提
必须先成功调用agentConfig，否则调用时会报“no permission”错误。
当前成员必须在应用的可见范围之中，否则调用时会报“no permission”错误。
应用需具有微盘和文档使用权限，否则调用时会报“no permission”错误。
若用户对某文件不具备「分享」权限（微盘自定义权限取消勾选“分享”权限），则无法选择该文件。
代码示例
wx.invoke('wedriveSelectFile', {
selectedFileNum: 1
}, function (res) {
if (res.err_msg == "wedriveSelectFile:ok") {
var selectedFileUrls = res.result.selectedFileUrls; // 后续废弃
var selectedFileInfos = res.result.selectedFileInfos;
}
});参数说明
| 参数名 | 必须 | 类型 | 说明 |
|---|---|---|---|
| selectedFileNum | 是 | number | 选择文件的数量。1表示单选，大于1表示多选，上限为50 |
返回说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| res | Obj | 返回信息 |
| res.err_msg | string | 执行结果。"wedriveSelectFile:ok" 表示执行成功，否则表示报错信息 |
| res.result | Obj | 返回的数据 |
| res.result.selectedFileUrls | Array<string> | 选择的文件的 url 列表。后续废弃，请使用selectedFileInfos |
| res.result.selectedFileInfos | Array<object> | 选择的文件信息列表。企业微信版本 ≥4.1.8 才返回 |
| res.result.selectedFileInfos[].url | string | 选择的文件url |
| res.result.selectedFileInfos[].type | uint32 | 选择的文件类型。0: 其他，2: 文件，3: 文档，4: 表格，5: 收集表，6: 幻灯片，7: 思维导图，8: 流程图，10: 智能表格 |
错误列表说明
| res.err_msg | 说明 |
|---|---|
| wedriveSelectFile:ok | 执行成功 |
| wedriveSelectFile:cancel | 取消选择 |
| wedriveSelectFile:fail no permission | 无权限 |
| wedriveSelectFile:fail param error | 参数错误 |
| wedriveSelectFile:fail context error | 选择器异常 |
| wedriveSelectFile:fail not supported system version | 低系统版本不支持 |
平台版本说明
| 平台 | 企业微信版本要求 | 系统版本要求 |
|---|---|---|
| ios | ≥4.0.12 | |
| android | ≥4.0.12 | |
| win | ≥4.0.12 | |
| mac | ≥4.0.12 | >10.12 |
应用权限说明
| 应用类型 | 可调用的应用 |
|---|---|
| 自建应用 | 需具有“微盘”和“文档”权限 |
| 第三方应用 | 需具有“微盘”和“文档”权限 |
| 代开发应用 | 需具有“微盘”和“文档”权限 |
- 选择文件
本节内容
