随着Windows Live不断地改版为SkyDrive 增加了很多新的功能,再加上WP7本身也提供很多地方与SkyDrive 的连结,例如:
Office或如同
让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与撰写应用时,要记得注意
〉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。
以下就撷录
Class | Description |
LiveAuthClient | 用于撷取Live Connect连线过程的Session Data。 二个重要的参数:client ID and redirect Uniform Resource Identifier (URI)。 |
LiveAuthException | 用于识别当Auth Process过程发生Exception时的处理常式。 |
LiveConnectClient | Live Connect的重要功能,用与Live Connect web service endpoints连接,并且管理Token保持连线的验证与交易凭证。 另外,它更包括重要操作Windows Live上必要的方法: CopyAsync, DeleteAsync, DownloadAsync, UploadAsync, PostAsync,用于操作WP7的资源发佈或下载至二端之间。 |
LiveConnectException | 用于识别当Connect Process过程发生Excpetion时的处理常式。 |
LiveConnectSession | 用于取得目前Connect的Session。其内容包括:目前与Live Connect使用的Token有效期限、Token属性等。 |
LiveDownloadProgressChangeEventArgs | 在Download Operation过程中每一时间点下载数据量的改变参数。 |
LiveOperationCompletedEventArgs | 当Operation完成时所触发的事件处理参数。 |
LiveUploadProgressChangedEventArgs | 在Upload Operaion过程中每一时间点下载数据量的改变参数。 |
LoginCompletedEventArgs | 当登入完成时所触发的事件并且回传需要的事件参数。 |
上表中提到数个重要类别,以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与涉及使用者的核心资料与联络人资讯。主要範围主要有叁类:
Scope | Enables |
wl.basic | 讀取已連結的用戶基本資訊,與聯絡人清單。存取REST中的User與Contact二大物件。 |
wl.offline_access | 允許App有能力在任何時間讀取與更新用戶的資料。如果沒有設定該值,App只能在每一次進行登入連接Live Connect才能操作。 |
wl.signin | 單一登入行為(Single sign-in behavior)。設定該值,用戶透過App登入Live Connect也一併登入WebSite。更詳細的說明可參考<Signing users in>。 |
从上述即可得知这叁个Scopes是让App可以存取/控制资料的基本设定值,在wl.basic的物件结构要特别注意,如下:
REST Object | Structure (取值的,key) |
User | link |
User | update_time |
Contact | id |
Contact | first_name |
Contact | last_name |
Contact | name |
Contact | gender |
Contact | is_friend |
Contact | is_favorite |
Contact | user_id |
Contact | email_hashes |
Contact | birth_day (存取該結構值,需要scope多增加:wl.contacts_birthday)。 |
Contact | birth_moth (存取該結構值,需要scope多增加:wl.contacts_birthday)。 |
Contact | updated_time |
更详细的存取物件结构,可以参考<REST API>
(3-2). Extends:
该scopes允许App操作使用者的延伸性个人资料与联络人资讯。其主要範围相当多:
Scope | Enables |
wl.birthday | 讀取用戶的生日資訊,包括:年(birth_year)/月(birth_month)/日(birth_day)。 |
wl.calendars | 讀取用戶的行事曆與事件資訊。 |
wl.calendars_update | 存取(r/w)用戶的行事曆與事件。 |
wl.contacts_birthday | 讀取用戶所有聯絡人生日(年/月/日)。配合wl.basic中birth_day, birth_moth使用。 |
wl.contacts_calendars | 讀取用戶所屬與其他人分享給該用戶的行事曆與事件資訊。 |
wl.contacts_create | 建立新的聯絡人至用戶的通訊錄。 |
wl.contacts_photos | 讀取用戶的albums、photos、videos與audios,以及這些資源的相關comments與tags;也支援讀取其他用戶分享給該用戶的資源。 操作元件:Album, Audio, Photo, and Video objects。 |
wl.contacts_skydrive | 讀取其他用戶分享給該用戶的skydrive資源,也能存取用戶所屬的skydrive資源。 |
wl.emails | 讀取用戶的personal、preferred與business email。 可用結構:emails / preferred / account / personal / business。 |
wl.events_create | 建立事件在該用戶default的行事曆。操作元件:Event object。 |
wl.messenger | 允許登入Windows Live Messenger與Presence Protocol (XMPP) service。 詳細內容可以參考<Getting started using Messenger with XMPP>的介紹。 |
wl.phone_numbers | 讀取用戶的personal、preferred與business phone number。 可用結構:phones / personal / business / mobile。 |
wl.photos | 讀取用戶的albums、photos、videos與audios。 |
wl.postal_addresses | 讀取用戶的postal address。可用結構相當多,可以點擊連結。 |
wl.share | 允許更新用戶的狀態訊息。存取的物件:Activity Object。 |
wl.skydrive | 讀取用戶所屬Skydrive中的檔案。 |
wl.skydrive_update | 存取(r/w)用戶所屬Skydrive中的檔案。 |
wl.work_profile | 讀取用戶的員工與工作地址資訊。 可用結構:work / employee (work array) / name (employee object) / position (work array) / name (position object) |
更詳細的存取物件結構,可以參考
(3-3). Developers:該scopes允許App使用開發者的Client IDs進行操作。
Scope | Enables |
wl.applications | 讀取開發者的Client ID,該Client ID驗證後,可配合Live Connect APIs產生功用。 操作元件:Application object's structures,用於取得該Client ID在Live Connect上註冊的相關資訊。 |
wl.applications_create | 代表開發者建立了一個新的Client ID。操作元件:Applicationobject's structures。 |
更详细的存取物件结构,可以参考
以上介绍了Live SDK重要的观念与使用的元件/参数之后,还有蛮多的Structure需要参考额外的资料进行说明,但往下先接着透过几个简单的範例介绍如何操作Live SDK。
[事前工作]
在体验使用Live SDK时,首先第一个任务需要至「https://manage.dev./Applications/Index」申请您实作App使用的Client ID,该Client ID用于识别App在Live Connect定义为何种应用程式,由于它需要绑定一组Windows Live ID,因此需要透过一个可接收核可性的ID来当作申请。申请方式非常容易,在这篇就不多加以说明。产生Client ID的结果如下:

记得来
A. 登入Windws Live:
撷录<>中的内容,参考Core Scope设定让App提供用户可以登入Windows Live,并且取得用户的资讯。其设定步骤如下:
(a-1). 拉SigninButton至画面中,设定Scopes与Client ID;(至于怎么在Tools加上SigninButton,请参考
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;
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一样代表每一个物件存取的识别与範围。
Object | Description | Value object paths |
Activity | 储存用户的活动feed与状态讯息。 | /me/share /USER_ID/share |
Album | 用户在Skydrive裡Album的资讯内容。 包括:photos、videos、audios、files与folders的组合。 | /me/albums /USER_ID/albums /ALBUM_ID 一个Album物件可回传以下的Path内容: /ALBUM_ID/files /me/skydrive/files /me/skydrive/shared/files /me/skydrive/shared/albums /USER_ID/skydrive/files |
Application | 储存与Live Connect互动的Client ID资讯。 | /me/applications /USER_ID/applications /APPLICATION_ID |
Audio | 用户储存于Skydrive的Audio资讯。 | /AUDIO_ID 一个Audio物件可回传以下的Path内容: /ALBUM_ID/files /FOLDER_ID/files /me/skydrive/files /USER_ID/skydrive/files |
Calendar | 储存用户的Calendar资讯。 | /me/calendars /USER_ID/calendars /CALENDAR_ID |
Comment | 储存在用户Skydrive裡photos或videos的Comment资讯。 | /PHOTO_ID/comments /VIDEO_ID/comments /COMMENT_ID |
Contact | 用户在Hotmail上的联络人。如果联络人资讯中的is_friend值为true,取出的联络人也是friend.。 | /me/contacts /USER_ID/contacts /CONTACT_ID |
Error | 由Live Connect API回传的错误资讯。 | None |
Event | 储存在用户Calendar上的事件。 | /me/events /USER_ID/events /CALENDAR_ID/events |
File | 用户在Skydrive中的档案。 | /FILE_ID 一个File物件可回传以下的Path内容: /FOLDER_ID/files /me/skydrive/files /me/skydrive/shared /me/skydrive/shared/files /USER_ID/skydrive/files |
Folder | 用户在Skydrive中的资料夹。它能包括:photos、videos、audios、files与子资料夹的组合资讯。 | /FOLDER_ID 一个Photo物件可回传以下的Path内容: /ALBUM_ID/files /FOLDER_ID/files /me/skydrive/files /me/skydrive/shared/files /USER_ID/skydrive/files |
Friend | 用户朋友的资讯。朋友是联络人的子集合,并且搭配publicly visible relationship 定义可见度。因此,Contact物件的资料会比Friend完整。它能取到的内容,最简单ID与Name。 | /me/friends /USER_ID/friends |
Permissions | 储存scopes清单。 | /me/permissions /USER_ID/permissions |
Photo | 用户储存于Skydrive的Photo资讯。 | /PHOTO_ID 一个Photo物件可回传以下的Path内容: /ALBUM_ID/files /ALBUM_ID/photos /FOLDER_ID/files /me/skydrive/files /me/skydrive/shared/photos /USER_ID/skydrive/files |
Tag | 在Skydrvice中photo或video上标记的关联资讯。 | /PHOTO_ID/tags /VIDEO_ID/tags /TAG_ID |
User | 代表一个用户。 | /me /USER_ID |
Video | 用户储存于Skydrive的Video资讯。 | /VIDEO_ID 一个Video物件可回传以下的Path内容: /ALBUM_ID/files /ALBUM_ID/videos /FOLDER_ID/files /me/skydrive/files /me/skydrive/shared/videos /USER_ID/skydrive/files |
了解上述Path与对应物件使用的方式,简单的举个例子:想要取出自己Skydrive中的所有Photo资讯:
2: this.gLiveClient.GetAsync("/me/skydrive/files?filter=photos", null);
其中过滤的参数可使用:albums、audio、folders、photos、videos。
[範例程式]
由于内容太多了,範例部分移至
======
以上是分享怎么存取SkyDrvice的内容,因为我觉得透过SkyDrive可以配合很多的应用,因此我自己很希望去了解怎么存取它的内容,这样我就可以放置一些我需要内容在SkyDrive裡,透过自己开发的App去读取内容或做Shared的功能,至于Shared的功能也可以配合
Socket的应用来进行。因此,WP7裡一个App可以纳入很多好用的开发API与概念,让自己App更加生活化。
本文来自pou的博客,原文地址:http://www./pou/archive/2012/03/22/70936.aspx