【Win10 UWP】QQ SDK(二):SDK的回调处理

上一讲,我们介绍了QQ SDK的使用方法,请看《【Win10 UWP】QQ SDK(一):SDK基本使用方法》

 

一. 回调的基本形式

从前面的介绍中我们知道,我们的应用和QQ客户端之间需要通过文件类型和协议关联进行互调。我们需要调起QQ客户端进行分享或授权,同时QQ分享完成或授权完成之后,也需要调起我们的应用进行回调通知,把结果告诉我们的应用。

1. 文件类型关联

<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>    

看一下我们在Package.appxmanifest里进行的文件类型关联声明,声明了一种.qc-xxxxxxxxxx(其中xxx为你的AppId),表示我当前的应用能够打开这种后缀格式的文件,从而也就实现把我的应用调起来;显而易见,QQ客户端在回调的时候会生成这种后缀格式的文件,并且我们注意到在分享成功之后,QQ客户端会提示是否“返回应用”,当点击了“返回应用”,相当于QQ客户端想要打开这个文件;由于AppId的唯一性,能保证这个文件只能用我的应用打开;我们的应用打开这个文件后,就能读取这个文件的内容并讲结果进行解析啦。

通过文件类型关联打开这个文件之后,在App.cs里,protected override void OnFileActivated(FileActivatedEventArgs args)方法会被触发,读取args.Files[0]这个文件的内容进行解析即可。

QQSDK类提供CanHandleWindowsFileTypeAssociation(IStorageFile file)方法和HandleOpenWindowsFileTypeAssociation(IStorageFile  file)方法分别用来判断文件是否可解析,并且解析文件的内容。处理结果返回一个ResponseResult类型的对象,这就是我们要的回调结果了。

 

2. 协议关联

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

协议关联比较简单,声明一个qc-xxxxxxxxxx的协议,QQ客户端在“返回应用”的时候也可以通过Launcher.LaunchUriAsync(new Uri("qc-xxxxxxxxxxx"))的方法把我们的应用调起来,在App.cs里,protected override async void OnActivated(IActivatedEventArgs args)方法会被触发,回调内容附带在args.Uri中。

由于触发Activated的场景比较多(除了Protocol外),需要判断一下args.Kind是否为ActivationKind.Protocol才可进行处理。

QQSDK类提供CanHandleWindowsProtocolUri(string uri)方法和HandleOpenWindowsProtocolUri(string uri)方法分别用来判断协议是否可解析,并且解析协议的内容。处理结果同样返回一个ResponseResult类型的对象,这就是我们要的回调结果了。

 

这两者的区别只是在于回调结果数据量较大时,QQ客户端以文件类型回调(如登录授权、调用Open API等情形),数据量较小时(如分享)只需要以协议形式回调。实际上,我认为QQ SDK只需要统一使用文件类型关联就足够了。

 

二. QQ SDK扩展辅助

QQ SDK回调的处理还是需要不少代码量的,如果每个项目都要写这些重复代码其实是比较烦的。这里我写了一个扩展辅助ConnectQQSDK.Extensions,将所有的回调处理都进行了封装,只需要简单调用即可。

ConnectQQSDK.Extensions库nuget下载地址:https://www.nuget.org/packages/ConnectQQSDK.Extensions/1.0.0

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

 

1. 初始化方法

在App.cs的OnLaunched方法里,调用封装过的初始化方法

QQSDKHelper.Initialize("xxxxxxxxxx", new QQCallback());

其中QQCallback是一个继承了ConnectWPQQSDK.Extensions.IQQSDKCallback接口的类型,对于回调结果,用自己的应用认为合适的方法进行显示或存储。比如分享的回调结果,可以自己用Toast或MessageDialog显示出来;比如登录授权的回调结果,可以自己存储在独立存储或本地数据库中。Do It Yourself!

public class QQCallback : IQQSDKCallback
{
    public void OnHandleResult(ResponseResult result)
    {
        switch (result.OpenType)
        {
            case SDKOpenMessageType.eMessageTypeAuth:
         // 登录授权结果,反序列化result.ResultMsg得到Token、OpenId、过期时间等信息
break; case SDKOpenMessageType.eMessageTypeShare:
         // ToastPrompt.Show(result.ResultCode == ResponseRetCode.SUCCESS ? "分享成功": "分享失败");
break; case SDKOpenMessageType.eMessageTypeOpenAPI:
// OpenAPI结果,反序列化result.ResultMsg得到相应信息,具体返回值请查看Open API官方文档
break; } } }

反序列可以用Json.Net或系统自带的DataContractJsonSerializer,不再多说。

 

2. 文件关联和协议关联处理

在App.cs的OnActivated方法里:

protected override async void OnActivated(IActivatedEventArgs args)
{
    base.OnActivated(args);
    await QQSDKHelper.OnActicated(args);
}

在OnFileActivated方法里:

protected override async void OnFileActivated(FileActivatedEventArgs args)
{
    base.OnFileActivated(args);
    await QQSDKHelper.OnFileActivated(args);
}

 

以上就是在应用里需要添加的代码,比起自己去处理SDK的回调结果要简单很多。

 

三. QQ SDK扩展源码

QQSDKHelper.cs源码

    public static class QQSDKHelper
    {
        public static void Initialize(string appId, IQQSDKCallback callback = null)
        {
            AppId = appId;
            Callback = callback;

            QQSDK.Instance.Initialize(appId);
        }

        public static async Task OnActicated(IActivatedEventArgs e)
        {
            try
            {
                if (e.Kind == ActivationKind.Protocol)
                {
                    var frame = Window.Current.Content as Frame;
                    if (frame == null)
                    {
                        return;
                    }

                    var protocalArgs = (ProtocolActivatedEventArgs) e;
                    if (protocalArgs.Uri == null)
                    {
                        return;
                    }

                    if (protocalArgs.Uri.Scheme.Equals($"qc-{AppId}"))
                    {
                        if (QQSDK.Instance.CanHandleWindowsProtocolUri(protocalArgs.Uri.ToString()))
                        {
                            var result = await QQSDK.Instance.HandleOpenWindowsProtocolUri(protocalArgs.Uri.ToString());
                            HandleResult(result);
                        }
                    }
                }
            }
            catch (Exception)
            {
                // ignored
            }
        }

        public static async Task OnFileActivated(FileActivatedEventArgs e)
        {
            try
            {
                var file = e.Files?.FirstOrDefault() as IStorageFile;
                if (file == null)
                {
                    return;
                }

                if (QQSDK.Instance.CanHandleWindowsFileTypeAssociation(file))
                {
                    var result = await QQSDK.Instance.HandleOpenWindowsFileTypeAssociation(file);
                    HandleResult(result);
                }
            }
            catch (Exception)
            {
                // ignored
            }
        }

        private static void HandleResult(ResponseResult result)
        {
            Callback?.OnHandleResult(result);
        }

        public static IQQSDKCallback Callback { get; private set; }
        public static string AppId { get; private set; }
    }

 

IQQSDKCallback.cs源码

    public interface IQQSDKCallback
    {
        void OnHandleResult(ResponseResult result);
    }

 

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

posted @ 2015-07-21 13:41 zhxilin 阅读(...) 评论(...) 编辑 收藏