【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/"
});
}

【Win10 UWP】QQ SDK(一):SDK基本使用方法 【Win10 UWP】QQ SDK(一):SDK基本使用方法

再看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"
});
}

【Win10 UWP】QQ SDK(一):SDK基本使用方法

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

当然,如果授权过期了,可以再调用一下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的回调处理》

上一篇:mac 终端 svn 命令(转)


下一篇:win10 uwp 渲染原理 DirectComposition 渲染