從應用程式存取 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 為使用者提供一個可以信賴、方便存取的雲端位置來儲存他們的檔案。使用者只要使用自己的 Microsoft 帳戶登入,即可從任何 Windows 裝置存取他們的 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 會為應用程式處理其餘的登入程序。

若要深入了解,請參閱下列資源:

在 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
資料夾和檔案
Managed API

 

 

顯示:
© 2015 Microsoft