【Win10 UWP】QQ SDK（一）：SDK基本使用方法

每当开发一个应用需要社交分享的应用时，总是心里咯噔一下：到底什么时候分享能加上QQ和微信？除了WP8.0版本的微信SDK，官方似乎从未正面发布过适应时代发展的QQ SDK，就连后台，也没有一个可以创建WP应用的入口（其实WP QQ团队很早就已经在开发WP版的QQ SDK，只是网站那边一直没人管上线这事，具体你也懂）。

吐槽完毕。

作为一个长期以来，致力于散播温暖，散播希望的小清新无公害WP开发者，今天又要给广大WP开发者传播希望了。博主拿到了非正式版的QQ SDK，并且做了一些封装，仅供学习交流。开始我们今天的主题”QQ SDK“，以下以Win10 UWP作为例子说明使用方法。

1. 安装ConnectQQ SDK

博主拿到的SDK是散件，自己写了个nuget合成一个神装。由于SDK是C++写的，需要将你的项目设置成x86、x64或ARM进行调试，这个nuget作用就是实现在你进行架构切换时，在build过程中自动引用正确的dll。

通过nuget下载并安装QQ SDK，链接：https://www.nuget.org/packages/ConnectQQSDK/1.4.0

或者在控制台输入PM> Install-Package ConnectQQSDK

QQ SDK的作用是使我们在自己的代码里能将QQ客户端呼起来，并作相应的操作。

注意：引用完成后，需要先Unload一下项目再重新Reload，或者重启一下VS。

2. 申请QQ互联应用Id

到QQ互联官网：http://connect.qq.com/ 创建应用，获得一个AppId

3. 配置Package.appxmanifest文件

QQ SDK使用文件类型关联和协议关联混合模式来进行应用间互调通信，那么需要进入Package.appxmanifest文件进行相关配置。

在<Applications>节点中的<Application>节点下，添加一个<Extensions>节点，分别添加windows.fileTypeAssociation和windows.protocol两个声明：

<Extensions>

    <uap:Extension Category="windows.fileTypeAssociation">
          <uap:FileTypeAssociation Name="test">
                <uap:SupportedFileTypes>
                      <uap:FileType ContentType="application/qqsdkconnect">.qc-xxxxxxxxxx</uap:FileType>
                </uap:SupportedFileTypes>
          </uap:FileTypeAssociation>
    </uap:Extension>

    <uap:Extension Category="windows.protocol">
        <uap:Protocol Name="qc-xxxxxxxxxx" />
    </uap:Extension>

</Extensions>    

注意：把其中的xxxxxxxx替换成你自己的AppId。

至于什么时候通过文件类型，什么时候通过协议进行互调，我们在下一讲会具体说明。

4. 初始化SDK

在App.cs的OnLaunched和OnActivated方法的适当位置进行初始化，SDK提供一个静态的QQSDK实例进行管理，调用其Initialize方法初始化，传递第3步获取的AppId作为参数：

QQSDK.Instance.Initialize("xxxxxxxxxx");

5. 调用SDK的分享方法

(1) 分享到QQ

QQSDK类的ShareToQQ方法用来分享数据到QQ客户端，支持分享到QQ好友、群、讨论组等，如图：

ShareToQQ有两个重载方法：ShareToQQ(ShareToQQDefaultModel model) 和 ShareToQQ(ShareToQQImageModel model)，分别表示分享图文消息和分享纯图片消息。

首先看ShareToQQDefaultModel，分享图文消息

public sealed class ShareToQQDefaultModel : __IShareToQQDefaultModelPublicNonVirtuals
{
    public ShareToQQDefaultModel();
    public byte[] ImageData { get; set; }
    public string ImageUrl { get; set; }
    public ShareToQQKeyType KeyType { get; set; }
    public string Summary { get; set; }
    public string TargetUrl { get; set; }
    public string Title { get; set; }
}

字段含义不多解释，注意其中ImageUrl和ImageData，前者用于图片链接数据，后者用于图片流数据，调用时二者不要同时设置。

private async void ShareButton_OnClick(object sender, RoutedEventArgs e)
{
    await QQSDK.Instance.ShareToQQ(new ShareToQQDefaultModel
    {
　　　　 KeyType = ShareToQQKeyType.Default, 
　　 　　Title = "test title",
        Summary = "test summary",
        ImageUrl = "http://ww2.sinaimg.cn/square/b50ea691gw1eu9a1mwyt9j20b408c752.jpg",
        TargetUrl = "http://news.qq.com/"
    });
}  

  

再看ShareToQQImageModel，分享纯图片消息

public sealed class ShareToQQImageModel : __IShareToQQImageModelPublicNonVirtuals
{
    public ShareToQQImageModel();
    public string ImageLocalPath { get; set; }
    public ShareToQQKeyType KeyType { get; set; }
}

注意：这里ImageLocalPath只能传ApplicationData.Current.LocalFolder下的图片...

private async void ShareButton_OnClick(object sender, RoutedEventArgs e)
{
    await QQSDK.Instance.ShareToQQ(new ShareToQQImagetModel
    {
        KeyType = ShareToQQKeyType.Image,
        ImageLocalPath = "test.jpg"
    });
}      

(2) 登录授权

在没有QQ SDK之前，如果想要获取QQ用户的授权，只能走OAuth去获取授权，自己实现起来其实也是比较费工夫的，相信大部分开发者都有这方面的经验，可以参考官方文档：http://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token

然而这不是我们今天要讨论的内容，有了QQ SDK，就能通过QQ客户端来获取授权了。

QQSDK类的Login和Logout可以实现获取授权和终止授权，当然前提是你在QQ互联创建应用时需要申请一下一些Open API的权限，如"get_simple_userinfo", "get_simple_userinfo,get_vip_info", "all"等，更多开放API权限列表请参考官方文档：

http://wiki.connect.qq.com/api%E5%88%97%E8%A1%A8

调用方法如下，Login方法传入一个AuthorizeRequestData对象，且需要指定ApiScope：

private async void LoginButton_OnClick(object sender, RoutedEventArgs e)
{
    await QQSDK.Instance.Login(new AuthorizeRequestData
    {
        ApiScope = "get_simple_userinfo"
    });
}    

至于授权结果的回调处理，我们留待下一讲。

当然，如果授权过期了，可以再调用一下QQSDK类的ReAuth方法刷新Token，这里不再具体讲了。

(3) 调用Open API

QQ SDK还支持调用Open API，不再需要手动去封装了。QQSDK类提供Request方法来调用Open API，需要传入一个OpenAPIRequestData对象。

public sealed class OpenAPIRequestData : __IOpenAPIRequestDataPublicNonVirtuals
{
    public OpenAPIRequestData();
    public string ApiName { get; set; }
    public HttpMethod Method { get; set; }
    public string[] Params { get; set; }
}

其中ApiName指Open API的名字，更多API请参考官方文档：http://wiki.connect.qq.com/api%E5%88%97%E8%A1%A8

比如获取QQ会员信息：

private async void GetVipInfoButton_OnClick(object sender, RoutedEventArgs e)
{
    var result = await QQSDK.Instance.Request(new OpenAPIRequestData
    {
        ApiName = "get_vip_info",
        Method = HttpMethod.HttpGet
    });
    
    // ToDo: 处理result
}    

本文仅用于学习交流，转载请注明出处：http://www.cnblogs.com/zhxilin/p/4661910.html

下一讲，我们来谈谈如何处理SDK的回调结果：《【Win10 UWP】QQ SDK（二）：SDK的回调处理》