Live Connect和Live SDK的一些简介

我最近就在研究了一下Live Connect的API，准备用SDK写一个和网盘有关的App，不过现在暂时还没完全定型。不过API的调用，我也大概看得七七八八，就先写一写吧。

这里有完整的文档http://msdn.microsoft.com/zh-cn/library/live/，我主要会写写文档里一些基本和比较重要的地方。

一、Live Connect的简单概念

Live Connect现在可以获取的信息有SkyDrive、Hotmail、Messenger和Live，其中我就主要用到SkyDrive这个部分。所以其余的API调用，我不怎么研究过。而Live Connect所用的也是OAuth 2.0的协议标准，REST的体系结构，返回JSON数据以及XMPP的实时通信标准。首先要创建一个自己的应用才可以调用API，具体的我就不多说，跟新浪差不多，不过记得要在API设置那里勾上mobile的选项。

Live Connect的权限分得很细，应用的权限大小在Live Connect中是称为作用域，而权限的大小是由应用去请求，经由用户确认授权所获得的。当然，在满足应用需要的前提下尽可能请求小的权限，这样可以尽量打消用户的疑虑，更有机会取得授权。这个也是Live提倡的理念之一。

作用域之间也有包含和被包含的关系，一旦你请求的作用域中，其中有一个为另一个的子集，那么子集的作用域就会因为冗余而取消。在请求授权的时候也不会显示出子集作用域的权限，只会显示出其超集的权限。这里是作用域的详细资料http://msdn.microsoft.com/zh-cn/library/live/hh243646.aspx。

HTTP动词有这些：

GET — 返回资源的表示。
POST — 向集合添加新资源。
PUT — 在 URL 指出的位置处更新资源或创建新的资源（如果资源不存在）。
DELETE — 删除资源。
MOVE — 移动资源的位置。
COPY — 复制资源。

二、使用Live SDK

调用API的方法其实有两种，一种就是直接通过引用REST API获取JSON数据并自己进行处理，第二种就是根据自己的要开发的平台下载对应的SDK。第一种方法基本任何平台都可以使用，不过处理JSON数据这些枯燥的工作还必须要自己做。第二种方法，针对性比较强，SDK已经为开发者做好了大量的工作，可以缩短开发周期。在http://msdn.microsoft.com/zh-cn/library/live/hh826538.aspx可以找到对应的SDK下载，不过这里也分为引用API Framework和直接引用API源代码。以下我就以iOS的Framework为例子。

首先把Framework拖进去

然后每个头文件都加上#import "LiveSDK/LiveConnectClient.h"，最后在需要调用SDK的Controller加入对应的协议，如LiveAuthDelegate, LiveDownloadOperationDelegate, LiveOperationDelegate, LiveUploadOperationDelegate。再添加协议包含的属性LiveConnectClient *liveClient，并实现一些方法- (void)authCompleted: session: userState:，- (void) liveOperationSucceeded: operation。那么基本工作就完成了。

三、API具体的调用

SDK已经把REST API的调用封装成了Objective-c的方法，而且大部分的操作基本都是通过LiveConnectClient *liveClient来调用。有点要注意就是，我通过调试发现SDK使用了多线程的技术，所以对于界面的更新，开发者需要作出其他的安排。

1 - (void)viewDidLoad
2 {
3     [super viewDidLoad];
4     
5     self.liveClient = [[LiveConnectClient alloc] initWithClientId:APP_CLIENT_ID 
6                                                          delegate:self 
7                                                         userState:@"initialize"];
8 }

APP_CLIENT_ID是应用的ID，这里我用宏定义了。userState其实可以随便填写，因为它仅仅是一个类似identifer的东西，具体的作用都是由自己去定义。这样就先初始化了liveClient。

 1 - (void)authCompleted:(LiveConnectSessionStatus) status 
 2               session:(LiveConnectSession *) session 
 3             userState:(id) userState
 4 {
 5     if ([userState isEqual:@"initialize"])
 6     {
 7         [self.liveClient login:self 
 8                         scopes:[NSArray arrayWithObjects:@"wl.signin", @"wl.offline_access", @"wl.basic", @"wl.contacts_skydrive", @"wl.skydrive_update", nil] 
 9                       delegate:self 
10                      userState:@"signin"];
11     } else if ([userState isEqualToString:@"signin"]) {
12         [self.liveClient getWithPath:@"me/skydrive/my_documents/files?sort_by=name" 
13                             delegate:self
14                            userState:@"get root folder files"];
15     }
16 }

userState的作用就在这里体现出来了，由于initWithClientId:delegate:userState:需要有LiveAuthDelegate，当这个方法执行成功后就会调用authCompleted:session:userState:。这时就要通过userState来判断究竟下一步应该执行什么操作。我这里就用login:scopes:delegate:userState:请求用户授权，至于token什么的不用担心，SDK会自动处理的，下次打开程序就是自动登陆了。如果要用SDK做多用户管理，暂时是无解的，因为Live Connect并不想开发者过多地接触到用户的账号和密码的资料，所以就做出了这种处理。

当授权成功以后，就可以调用getWithPath:delegate:userState:来获取SkyDrive里面的信息。这个方法执行成功后也会调用liveOperationSucceeded:方法，老规矩也是利用userState来判断下一步的操作。说到这里就要讲一下，返回的数据到底在哪里了。其实返回的数据是NSDictionary类型的operation.result，已经不用我们重新解释一次JSON数据了。数据的样子大概是这样。

{
   "data": [
      {
         "id": "folder.8c8ce076ca27823f.8C8CE076CA27823F!142", 
         "from": {
            "name": "Roberto Tamburello", 
            "id": "8c8ce076ca27823f"
         }, 
         "name": "My Sample Folder in Album 1", 
         "description": "",
         "parent_id": "folder.de57f4126ed7e411", 
         "upload_location": "https://apis.live.net/v5.0/folder.de57f4126ed7e411.DE57F4126ED7E411!126/files/", 
         "is_embeddable": true, 
         "count": 3, 
         "link": "https://cid-8c8ce076ca27823f.skydrive.live.com/redir.aspx?page\u003dself\u0026resid\u003d8C8CE076CA27823F!142\u0026parid\u003d8C8CE076CA27823F!126\u0026type\u003d5", 
         "type": "folder", 
         "shared_with": {
             "access": "Just me"
         },
         "created_time": "2011-04-22T00:36:30+0000", 
         "updated_time": "2011-04-22T19:18:12+0000"
      }, {
         ...
      }
   ]
}

这是文件夹的数据，由于Live Connect那里也划分了很多的对象，具体可查看http://msdn.microsoft.com/zh-cn/library/live/hh243648.aspx。最后显示到界面上的数据就再自己处理一下。不过，File对象有一个比较有趣的结构“source”，里面保存了一个临时的网址，允许拥有网址的人不需要任何权限就可以读取该文件。但是，这个网址是会过期的，官方也提醒开发者不应该储存该网址，那么这个结构到底有什么用呢？其实，iOS有一个UIWebView是很强悍的控件，可以看视频，看PDF，事实上SkyDrive也支持在线浏览。“source”就是为了可以浏览SkyDrive文件中的内容而存在的，支持格式有MS Office三剑客（你懂的）的基本文件doc，docx等，mp4，pdf，jpg，png，其他的大家可以试试，这里有http://msdn.microsoft.com/zh-cn/library/live/hh826545.aspx#fileformats。时间是ISO8601格式，需要自己进行一下转换，用NSDate的方法可以做到的，其余的我也就不多说了。

现在我就只做到很少的一部分，很多功能还没有实现，下面就放出一下现在写好的程序的截图吧。