OneDrive 文件选取器 JavaScript SDK v6.0 概述

注意: 此版本已被替换成 文件选取器 v7.2。 应使用最新版文件选取器 SDK 实现新集成。

使用 OneDrive 文件选取器 SDK,Web 应用可以通过快速集成 OneDrive 来打开和保存文件,而无需使用大量代码。 最新版文件选取器 SDK 适用于所有 OneDrive 帐户,无论是个人版还是商业版。

可以通过下列方式使用文件选取器 SDK 将应用与 OneDrive 集成:

  • 打开文件,然后获取用于下载文件内容的短期 URL。
  • 创建用于查看或编辑文件的可共享长期链接。 这些链接旨在发送或共享给同事、亲朋好友或其他人。
  • 将文件保存到 OneDrive。

注意: 如果管理员已启用外部共享功能,那么只能获取 OneDrive for Business 中文件的可共享链接。 对于 OneDrive 个人版,始终都能获取可共享链接。

Requirements

若要使用 OneDrive 文件选取器 SDK,Web 应用必须满足以下要求:

  • 通过数量有限的静态 URL(而不使用书签或查询字符串参数)使用文件选取器 SDK。 例如, https://www.contoso.com/openFile.aspx.
  • 通过用户驱动的交互操作启动文件选取器 SDK(以免弹出窗口阻止程序阻止文件选取器)。

设置

若要开始使用文件选取器,必须注册应用 ID,以便在 OneDrive 中标识应用。 如果已有应用 ID,可以继续使用。

需要为 OneDrive 个人版和 OneDrive for Business 单独获取应用 ID,因为它们使用不同的身份验证系统。 只有在希望允许这两种服务的用户都能使用集成时,才必须这样做。

OneDrive 个人版

注册应用以获取应用 ID(客户端 ID)(如果尚未这样做的话)。 确保将引用 SDK 的网页是 API 下重定向 URL设置。 还可以上载应用程序徽标,OneDrive文件选取器体验中显示。

OneDrive for Business

注册应用以获取应用 ID(客户端 ID)(如果尚未这样做的话)。 注册应用时,请确保满足以下要求:

  • 将应用注册为 Web 应用。 必须将应用设置为使用 隐式流(必须在应用清单中手动启用)。 为此,可以下载并修改应用清单,将 oauth2AllowImplicitFlow 设置为 true,然后上传清单。 有关详细信息,请参阅 将应用与 Azure Active Directory 集成
  • 答复 URL 是 重定向 URL,即要引用此 SDK 的网页。
  • 需要向应用授予 对 Office 365 SharePoint Online 的权限,并且需要"读取用户文件"权限 (才能仅下载) 或"读取和写入用户文件"权限 (才能共享链接和保存) 。

后续步骤

支持的浏览器

OneDrive 文件选取器和保存器支持以下 Web 浏览器:

  • Internet Explorer 桌面版和移动版 11 及更高版本
  • Chrome 桌面版 5 及更高版本
  • Chrome Android 版
  • Android 浏览器 4.1 及更高版本
  • Firefox 桌面版和移动版 8 及更高版本
  • Safari 桌面版和移动版 5 及更高版本

已知问题

  • 此 SDK 返回缩略图链接,这些链接要求对从 OneDrive for Business 中选择的图像文件进行身份验证。
  • 如果文件名已被占用,此 SDK 无法将文件上传到 OneDrive for Business 中。
  • OneDrive for Business 不支持数据 URI。

许可证

版权所有 (c) Microsoft Corporation。 保留所有权利。

MIT 许可证下获得许可。