从应用访问 OneDrive 指南

Applies to Windows and Windows Phone

按照这些指南可以设计与 OneDrive 用户的文件、文档、图片、视频、文件夹、唱片集或评论交互的 Windows 应用商店应用。

应做事项和禁止事项

OneDrive 用户假定 Microsoft 会努力保护其数据的案例和隐私。他们依赖 OneDrive 帮助保留其重要文档,保存其照片,以及与好友共享其体验。你的应用通过提供对其数据的体贴、精心设计的访问,可以增强 OneDrive 对用户的价值。

若要保持用户对 OneDrive 的信任,请让你的应用遵循以下设计原则。

让用户选择

用户希望选择应用处理其数据的方式。他们希望应用在征得其许可之后才连接其帐户。他们希望在其数据被更改之前得到通知。为了满足他们的期望,请遵循以下做法:

  • 仅在响应明确的用户请求或选择时才将文件上载到 OneDrive。

    连接 OneDrive 的应用应包括一个按钮,以便用户有意地将其文件上载到 OneDrive。如果你的应用默认将文件同步到 OneDrive,应让用户知道此情况,并在保存任何数据之前提供选择的机会。

  • 使用“帐户”超级按钮让用户登录和注销其帐户。

    正如让用户登录和注销 Microsoft 帐户中所述,你的应用必须提供一种让用户主动登录和注销其 Microsoft 帐户的方法。(请记住,如果用户已使用其 Microsoft 帐户登录 Windows,则你的应用无法明确注销它们。)

    有关详细信息,请参阅 Microsoft 帐户登录体验指南

  • 仅访问属于已登录用户的文件。

    除非你的应用意在 OneDrive 用户之间共享文件,否则请确保它仅能访问已登录用户的文件。你的应用仅应在用户请求时才应访问已与该用户共享的文件和文件夹。相反,除非用户选择,否则你的应用不应将文件保存到共享文件夹。

  • 为用户提供一个选项,以便他们选择要将数据存储在其 OneDrive 中的位置。

    你的应用通过 Windows.Storage.Pickers 命名空间可以使用 Windows 文件选取器,以打开文件并将其保存到用户的 OneDrive。如果你的应用同步多个文件,请考虑在用户的文件夹中创建一个具有唯一名称的子文件夹。

    有关在从 OneDrive 打开文件时如何使用文件选取器的详细信息,请参阅文件夹和文件

帮助保护用户的数据和隐私

你的应用绝不能损害用户对其 OneDrive 的信任。应谨慎处理用户数据。用户假定其文件仅与他们选择的人员共享。必须保留他们的重要信息,以便他们在需要时可以找回。

要点  一旦设置,你的应用将无法更改以编程方式在 OneDrive 对象上设置的权限。

  • 默认使用仅用户权限向 OneDrive 上载文文件。

    仅当用户明确要求共享文件时,才与他人共享该文件。

  • 警告用户有关与他人共享文件的链接。

    当用户请求共享其文件的链接时,让你的应用告知他们共享的后果。尤其是,如果你的应用允许用户共享其文件的“预先验证的”链接,请告诉他们收到该链接的任何人都可以查看该文件。不评估这些链接的文件权限,打开这些链接的任何人都可以查看其内容。

    有关详细信息,请参阅 OneDrive 核心概念

  • 根据链接的用途有目的地创建 OneDrive 对象的链接。

    在可能的情况下,应共享嵌入式、只读和读写链接。这些链接仅适用于有权限查看文件的用户。仅当用户希望与特定人员共享文件夹或文件时,才提供文件的预先验证的链接。不评估这些链接的文件权限,打开这些链接的任何人都可以查看其内容。

    有关详细信息,请参阅 OneDrive 核心概念

  • 当覆盖现有文件时应提醒用户。

    在将文件上载到 OneDrive 时,上载的默认行为是覆盖任何同名的现有文件。如果发生冲突,让用户知道现有文件将被覆盖。你可以添加一个设置为“false”的 Overwrite 标头,以防止文件被覆盖。

按预期使用 OneDrive 和 Windows

使用通过 OneDrive 免费提供的存储作为包罗万象的云数据解决方案十分诱人。尽管 OneDrive 确实为 Windows 应用商店应用提供了许多选项,但按预期使用时,它为你的应用提供了最大的好处。OneDrive 旨在为用户提供从任何设备访问其文档、照片和其他重要信息的权限。

  • 使用 OneDrive 可以存储、查看和编辑文档,或者创建和共享相册。

    OneDrive 不打算作为诸如存储可伸缩数据库、共享配置文件或托管 Web 应用程序的替代产品。 其唯一目的就是为了便于存储和共享用户的离散文件。

  • 在上载文件之前,确保用户的 OneDrive 中有一定空间。

    每个 OneDrive 用户都有一个有限的存储量。如果你的应用尝试保存的文件导致用户的帐户超过其配额,该调用将返回错误。最佳做法是先检查用户的可用存储,然后才向其 OneDrive 保存文件。

    有关如何检查 OneDrive 中可用空间的详细信息,请参阅常见任务

  • 使用内置 Windows 功能。

    如果可能,请使用 Windows 功能和 UI 托管或与 OneDrive 交互。例如,使用 Windows.Storage.Pickers 命名空间提供的文件选取器打开和保存文件。又如,让你的应用使用 Windows 应用程序数据 API 跨用户的设备保存较小的数据片段。

    有关如何使用文件选取器从 OneDrive 打开文件的详细信息,请参阅文件夹和文件

    有关如何使用 Windows 应用程序数据 API 的详细信息,请参阅漫游应用程序数据指南快速入门:漫游应用程序数据

其他使用指南

OneDrive 为用户提供一个在云中存储其文件的值得信赖和可以访问的位置。用户可以从任何 Windows 设备使用其 Microsoft 帐户登录来访问其 OneDrive 文件。OneDrive 为用户提供 7 GB 的可用存储空间,用于保存和共享其照片、文档、视频和音频文件。

你的 Windows 应用商店应用可以为用户提供对其 OneDrive 中的文件和文件夹的访问权限。通过连接到 OneDrive,你的应用可以为用户提供从其 OneDrive 打开、读取、保存和下载文件的能力,而无需占用硬盘驱动器空间。OneDrive API 在设计上从 Windows 应用商店应用中使用,并完美地集成到你的应用设计中。

使用 OneDrive 的应用设计

从广义上讲,OneDrive 可以对与离散文件交互的任何应用发挥作用。如果你的应用读取或显示文件,保存文件,或者下载或打开文件,则可以将 OneDrive 添加到应用的设计中。OneDrive 可以很好地集成到你的 Windows 应用商店应用体系结构中,使用 Windows 的内置功能,而无需编写大量的额外代码。

要点  OneDrive API 在 Live Connect SDK 中。在着手开发连接 OneDrive 的 Windows 应用商店应用之前,你需要安装 Live Connect SDK,并在你的项目中添加对 SDK 的引用。

让用户登录和注销 Microsoft 帐户

当然,与 OneDrive 交互的任何应用必须为用户提供一种方法,使之能够登录和注销与 OneDrive 关联的 Microsoft 帐户。虽然其本身不是一种应用设计,但让用户登录其帐户是构建与 OneDrive 集成的应用的关键步骤。

让用户登录的推荐技术是在你的应用的“设置”超级按钮中创建一个“帐户”页和一个“隐私声明”页。“帐户”页应提供一个登录和注销按钮,以让用户登录和注销其帐户。WindowsUI 处理你的应用的其余登录过程。

若要了解详细信息,请参阅下列资源:

  • 有关如何让用户登录其 Microsoft 帐户的详细信息,请参阅让用户登录
  • 有关如何为使用 JavaScript 的 Windows 应用商店应用自定义“设置”超级按钮的详细信息,请参阅 Microsoft 帐户登录体验指南
  • 有关如何为使用 C#/Visual Basic 和 XAML 的 Windows 应用商店应用自定义“设置”超级按钮的详细信息,请参阅 Microsoft 帐户登录体验指南

在 OneDrive 中保存新文件或更新现有文件

对于某些用户而言,OneDrive 是他们的“我的文档”。对于喜欢使用 OneDrive 存储其文件的用户,你的应用可以提供此选项在 OneDrive 中保存其数据。例如,当他们在你的应用中创建新文件时,你可以提供 OneDrive 作为保存位置。 当他们在你的应用中编辑文件时,他们可以将编辑内容保存回其 OneDrive。

实际上,让用户创建新文件的任何应用都可以从为用户提供 OneDrive 访问权限中获益。

  • 有关如何构建与 OneDrive 集成的应用的指南,请参阅应做事项和禁止事项部分。
  • 有关如何从用户的 OneDrive 上载图片、视频和音频文件的详细信息,请参阅唱片集、照片、视频、音频和标记
  • 有关如何在用户的 OneDrive 中保存和上载文件的详细信息,请参阅文件夹和文件

从 OneDrive 下载、打开和查看文件

我们前面提到,一些用户将许多数据保存在云中。他们希望能够查看其中包含的数据。你的应用可以为用户提供从 OneDrive 打开和读取文件的选项。该应用可以下载、打开和显示文件的内容,以供用户查看。

例如,如果你的应用播放视频,则可以为用户提供从其 OneDrive 文件夹打开影片的能力。或者你的应用可让用户作为读者打开和查看特定的文件类型。

注意  我们建议你的 Windows 应用商店应用不仅仅是让用户查看其 OneDrive 中包含的文件。Windows 附带了一个 OneDrive 应用。如果你的应用为用户提供独特的体验,则他们更愿意下载和安装你的应用。

若要了解详细信息,请查看下列资源:

  • 有关如何构建与 OneDrive 集成的应用的指南,请参阅应做事项和禁止事项。
  • 有关如何从用户的 OneDrive 下载和查看图片、视频和音频文件的详细信息,请参阅唱片集、照片、视频、音频和标记
  • 有关如何从用户的 OneDrive 中下载和打开文件的详细信息,请参阅文件夹和文件

相关主题

对于设计人员
OneDrive API
OneDrive 核心概念
对于开发人员 (HTML)
面向开发人员的 OneDrive
常规任务
文件夹和文件
JavaScript API
对于开发人员 (XAML)
面向开发人员的 OneDrive
文件夹和文件
托管 API

 

 

显示:
© 2014 Microsoft