Pou's IT Life

隨著Windows Live不斷地改版為SkyDrive 增加了很多新的功能，再加上WP7本身也提供很多地方與SkyDrive 的連結，例如：

Office或如同<Windows Phone Mango 7712: Streaming music and video from the Skrydrive through the browser>這篇的介紹，

讓SkyDrive成為與WP7手機一個儲存與互動的重要媒介。因此，在撰寫App時如果需要提供用戶備份使用設定的功能，過去可以透

過DropBox，那我就想說即然是WP7為何不直接使用SkyDrive就好了呢？因此，往下介紹怎麼在WP7中存取SkyDrive。

〉Live SDK (Live Connect)：

    在2011年底MS釋出了Live SDK，該SDK幫助開發人員解決了需實作OAuth交易的複雜工作，並且採用標準的OAuth 2.0、JSON與

Extensible Messaging and Presence Protocol (XMPP)為支援協定。透過REST的方式來呼叫API，而回傳的結果採用JSON的方式進

行溝通。因此，該API支援各種平台：Web、Desktop、Mobile app。那麼Live Connect提供了那些Services呢？

‧Skydrive：

   支援開發的應用程式指定Windows Live ID藉由Live Connect API存取Skydrvice中的文件與多媒體，包括：新/修/刪/查檔案與資料夾。

‧Hotmail：

   支援存取Windows Live ID上的連絡人與行事曆，讓開發的應用程式可建立/編寫聯絡人、建立事件與提醒等。

‧Messenger：

   支援與Messenger上的聯絡人進行聊天、取得聯絡人狀態等。

‧Windows Live ID：

   用於驗證用戶與連結他們的個人資訊。

以上這些服務與API，讓開發人員可透過網站或App的方式讓用戶隨時與他們的Live功能進行連接。往下介紹相關Live SDK前，使用SDK與

撰寫應用時，要記得注意<Live SDK License Agreement>，不然送審的過程會被退件的，要特別小心。

〉WP7上使用Live Connect操作API (以Managed API為例)：

    在操作Live Connect之前最重要的一件事情即是讓程式能夠與Windows Live連接。此時，Live SDK已經幫我們準備好了，

在過去使用Facebook API、Plurk API裡有一個重要的就是OAuth，它的機制需先至要操作的服務提供者端申請一組Key與權限，

接著在App裡建立讓用戶可以登入該服務網站，並且有介面允許授權存取能力給該App，這些動作雖然說沒有很難做，但對於第

一次使用的人難免有些混亂的概念，但Live SDK已經包裝好了，讓我們很簡單的能力操作它。

以C#為例，操作Live SDK有三個重要的元素：

(1). Microsoft.Live：

    集合包含了讓開發者簡易地連接Live Connect OAuth進行驗證，以及取得User Session Data與Live Connect REST APIs。

以下就擷錄<Microsoft.Live namespace>針對Microsoft.Live命名空間重要的類別做一些說明：

上表中提到數個重要類別，以LiveConnectClient最為重要，因此，以下範例將使用該類別實作相關Windows Live上的功能。     

(2). Microsoft.Live.Controls：

    該Controls提供用於操作Live Connect的特性，最常見的即是：「SignInButton class」。在WP7使用Live SDK第一步即是需要將它加入

至應用程式，並指定ClientID與Scope屬性告知它該使用怎樣的OAuth驗證來連上Windows Live，這樣才能透過OAuth標準讓用戶授權應用

程式可以存取他的Live ID資訊與相關功能。

    在使用SignInButton時，有一些參數可搭配使用：

(2-1). BrandingType enumeration：該列舉設定後，Button可呈現對應API的圖標，例如：Hotmail、SkyDrive、Messenger、Windows。

(2-2). ButtonTextType enumeration：該列舉設定後，Button可呈現相關的文字說明，例如：Connect、Custom、Login、Sigin。

(2-3). LiveConnectSessionChangedEventArgs class：

          使用SingInButton時搭配「SessionChanged」處理常式所代入的事件參數，用於監控Live Connect連線時Session的改變。

(3) Socpes and Permissions (學習Live SDK該部分的觀念一定要先建立)：

     Microsoft.Live與Microsoft.Live.Controls提供App方便使用OAuth協定登入Live Connect，但在讓開發的App可以連接Live Connect前，

在Live Connect API有定義App存取權限觀念，在Live Connect API稱為Scopes，每一個Scopes代表不同的Permission Level與對應的參數。

然而，針對Scopes Types主要分成三種類型，這三種類型有對應的參數是撰寫App時可以用來取得實際資料的部分，往下將加以說明：

(3-1). Core scopes：

    為重要連接Live Connect APIs與涉及使用者的核心資料與聯絡人資訊。主要範圍主要有三類：

    從上述即可得知這三個Scopes是讓App可以存取/控制資料的基本設定值，在wl.basic的物件結構要特別注意，如下：

更詳細的存取物件結構，可以參考<REST API>。

(3-2). Extends：

    該scopes允許App操作使用者的延伸性個人資料與聯絡人資訊。其主要範圍相當多：

更詳細的存取物件結構，可以參考<REST API>。

(3-3). Developers：該scopes允許App使用開發者的Client IDs進行操作。

更詳細的存取物件結構，可以參考<REST API>。

以上介紹了Live SDK重要的觀念與使用的元件/參數之後，還有蠻多的Structure需要參考額外的資料進行說明，

但往下先接著透過幾個簡單的範例介紹如何操作Live SDK。

[事前工作]

   在體驗使用Live SDK時，首先第一個任務需要至「https://manage.dev.live.com/Applications/Index」申請您實作App使用的

Client ID，該Client ID用於識別App在Live Connect定義為何種應用程式，由於它需要綁定一組Windows Live ID，因此需要透過

一個可接收核可性的ID來當作申請。申請方式非常容易，在這篇就不多加以說明。產生Client ID的結果如下：

記得來<Live Software Development Kit (SDK)>安裝Live SDK。

A. 登入Windws Live：

    擷錄<>中的內容，參考Core Scope設定讓App提供用戶可以登入Windows Live，並且取得用戶的資訊。其設定步驟如下：

(a-1). 拉SigninButton至畫面中，設定Scopes與Client ID；(至於怎麼在Tools加上SigninButton，請參考<Referencing the APIs with C#>)

   1: <!--TitlePanel contains the name of the application and page title-->

   2: <StackPanel x:Name="TitlePanel" Grid.Row="0" Margin="12,17,0,28">

   3:    <TextBlock x:Name="ApplicationTitle" Text="MY APPLICATION" Style="{StaticResource PhoneTextNormalStyle}"/>

   4:    <my:SignInButton Name="btnLogin" 

   5:                     Scopes="wl.signin wl.basic wl.offline_access" 

   6:                     SessionChanged="btnLogin_SessionChanged" 

   7:                     HorizontalAlignment="Left"

   8:                     ClientId="00000000480715FF"                     

   9:                     />

  10: </StackPanel>

        設定Scopes包括三個Core scopes：wl.signin wl.basic wl.offline_access三個用「空白」隔開。並且註冊SessionChanged事件，

用於監控Live Controls登入後觸發的狀態改變事件。

(a-2) 建立一個LiveConnectClient變數，並且隨著SigninButton觸發SessionChanged事件來啟動該變數連接Live Connect；

   1: private LiveConnectClient gLiveClient;

   2:  

   3: private void btnLogin_SessionChanged(object sender, LiveConnectSessionChangedEventArgs e)

   4: {

   5:     //LiveConnectSessionStatus.Connected代表SigninButton已完成OAuth認證

   6:     if (e != null && e.Session != null && e.Status == LiveConnectSessionStatus.Connected)

   7:     {

   8:                    //初始化LiveConnectClient進行存取資料的任務

   9:         this.gLiveClient = new LiveConnectClient(e.Session);

  10:         //註冊GetCompleted事件

  11:         this.gLiveClient.GetCompleted += OnGetMe;

  12:         //要求取得個人(me)層級的資訊

  13:         this.gLiveClient.GetAsync("me", null);

  14:     }

  15:     else

  16:     {

  17:         this.gLiveClient = null; 

  18:         this.tbError.Text = e.Error != null ? e.Error.ToString() : string.Empty;

  19:     }

  20: }

  21:  

  22: private void OnGetMe(object sender, LiveOperationCompletedEventArgs e)

  23: {

  24:     this.gLiveClient.GetCompleted -= OnGetMe; 

  25:     if (e.Error == null)

  26:     {

  27:         //使用wl.basic中的contact物件結構：first_name取得值

  28:         string firstName = e.Result.ContainsKey("first_name") ? 

  29:                             e.Result["first_name"] as string : string.Empty;

  30:  

  31:         //使用wl.basic中的contact物件結構：last_name取得值

  32:         string lastName = e.Result.ContainsKey("last_name") ? 

  33:                             e.Result["last_name"] as string : string.Empty;

  34:         this.tbGreeting.Text = "Welcome " + firstName + " " + lastName;

  35:     }

  36:     else

  37:     {

  38:         this.tbError.Text = e.Error.ToString();

  39:     }

  40: }

    在上述的程式範例中，有一個重要的關鍵字：「me」。此時，也許您會覺得奇怪，這個是什麼呢？其me代表的是一個Path的觀念，

它定義了目前要存取的範圍是在何某Path下，例如：存取個人的聯絡人：/me/contacts；某一個用戶的聯絡人：/USER_ID/contacts。

然而，Path的關鍵值，往下將加以說明：

(a-3) Understanding the objects：

    對於Live Connect REST API而言，每一個資訊的分類都算是一個Object。該Object包括：子物件集合、陣列、Values。

要怎麼使用這些物件，則需要先了解unique path，它類似ID一樣代表每一個物件存取的識別與範圍。

了解上述Path與對應物件使用的方式，簡單的舉個例子：想要取出自己Skydrive中的所有Photo資訊：

   1: //"/me/skydrive/files?filter=photos"：代表要從自己的Skydrive中找出PHOTOS的檔案

   2: this.gLiveClient.GetAsync("/me/skydrive/files?filter=photos", null);

其中過濾的參數可使用：albums、audio、folders、photos、videos。

[範例程式]

由於內容太多了，範例部分移至<Windows Phone 7 – 學習使用Live SDK – 2>加以說明。

======

以上是分享怎麼存取SkyDrvice的內容，因為我覺得透過SkyDrive可以配合很多的應用，因此我自己很希望去了解怎麼存取它的內容，

這樣我就可以放置一些我需要內容在SkyDrive裡，透過自己開發的App去讀取內容或做Shared的功能，至於Shared的功能也可以配合

Socket的應用來進行。因此，WP7裡一個App可以納入很多好用的開發API與概念，讓自己App更加生活化。

References：

‧Live SDK筆記 - 黑暗執行緒 (必讀)

‧Developers – Learn how to bring data from Hotmail, Messenger, and SkyDrive to your mobile apps

‧Windows Phone 7 Skydrive Library (重要) & Welcome to the Live Connect Developer Center

‧SkyDrive Photo API sample for WP7 & Windows Live Client Extensibility APIs

‧SkyDrive .Net API Client & SkyDrive Simple Viewer for WebDAV

‧Download file from skydrive in Windows Phone 7

‧SkyDrive播放器 skyDrive player v1200

‧any api to access windows live services? (skydrive, live space, etc.). How about www.mesh.com?

‧http://social.msdn.microsoft.com/Forums/en-US/messengerconnect/threads

‧ManagedMediaHelpers (重要) & Windows Phone 7 Skydrive Library & WP7Dropbox

‧Live Connect Developer Center (官方開發者網站，重要)

‧Live Connect app management site for Metro style apps (MS提供完整的服務，可參考著使用)