Access to third party SDK - micro-channel

Access to third party SDK - micro-channel

Explanation

---

Due to the company's needs, app requires the use of micro-channel micro-channel to log on and share features such as the recent third-party sign-on micro letter, sharing has been little studied and reported below.

Note points:
1, the need to "WeChat open platform" to register;
2, after registration if "Developer certification," the application under the WeChat open platform account is not carried out, only to have to share with friends or send to a friend circle two permissions function of.
3, "developer certification" after the passage of the application under the WeChat open platform account will receive advanced capabilities to log micro letter, intelligent interfaces, third-party platform development and other public number.
4, "developer certification" is valid for one year, valid for the last two months can apply to renew the annual audit fee of 300 yuan.

---

WeChat open platform

After successful registration and log micro letter public platform you can see above page, we are currently developing a basic "resource center", "management center."

• Resource Center, there are many development documents made available for reference when we develop.
• In Central Administration, we can create and browse our app.

Note that when we create applications may not contain the word "micro-letters" and in the name of the application , because the first time I wrote using the name of the "micro-letters SDK test", the results of the audit is not to pass.

Important here is the application of the signature, the signature on access, we need to give sign your application, whether you are using Eclipse or Android Studio developers need to let you sign your application packaged into Apk then installed on the phone, and then apk using the signature generation micro-channel resource Center, installed on the phone. Open the signature generation tool to enter the name of your application package can be obtained by signing your application on your phone.

以下地址是微信资源中心签名工具的地址：
https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419319167&token=75dc8457c70c2f4324e9cfd255674d7965d65049&lang=zh_CN

填写完整并提交完毕后就需要耐心等待审核通过了，一般半天就会有结果的。审核通过后可以查看应用的信息如下，这里重要的就是应用的AppID与AppSecret，接下来集成SDK的时候要用到这两个值。

---

APP集成微信SDK

1、 所需文件

1） 申请到的AppID。
2） 微信SDK，在资源中心—资源下载—Andoid资源下载中即可下载。微信SDK连接如下：https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419319167&lang=zh_CN

下载完毕解压后里面最重要的文件就是libammsdk.jar这个jar包了，其他暂时不需要。

2、 应用中集成

2.1、Eclipse导入Jar包

在工程中新建一个libs目录，将开发工具包中libs目录下的libammsdk.jar复制到该目录中.

右键单击工程，选择Build Path中的Configure Build Path…，选中Libraries这个tab，并通过Add Jars…导入工程libs目录下的libammsdk.jar文件。（如下图所示）

2.2、Android Studio导入Jar包

将工程切换到Project视图，然后将开发工具包中libs目录下的libammsdk.jar复制到该工程的app→libs目录中。

右键刚刚粘贴进来的libammsdk.jar文件，在弹出的菜单上点击Add As Library即可，如下图所示。

2.3、在代码中使用Jar包

Jar包在导入的时候针对两种开发工具写了Eclipse和Android Studio两种导入方法，导入完毕后进行代码的开发时则不用区分不同开发工具的用法了。

2.3.1、分享给微信好友、分享到朋友圈或者添加到微信收藏

这一步比较简单不会涉及太多的东西。微信分享及收藏目前支持文字、图片、音乐、视频、网页共五种类型。

但是要使你的程序启动后微信终端能响应你的程序，必须在代码中向微信终端注册你的APPID。这一步的原理就相当于：你想联系一个人，那么你就必须先给他打个电话，电话接通了你们才能通话，否则则无法联系。所以这个“打电话”的过程是需要在你要分享之前执行的，你可以在Application中注册，也可以在一个Activity中注册，注意只需要注册一次就好了。其他时候也需要使用IWXAPI，但是不需要再注册了。

注册代码类似如下：

private static final String WECHAT_APP_ID = "你申请应用得到的APPID";
// IWXAPI是第三方app和微信通信的openapi接口
    private IWXAPI iwxapi;
/**
     * 将当前应用的APP_ID注册到微信
     */
    private void regToWx() {
        iwxapi = WXAPIFactory.createWXAPI(this,WECHAT_APP_ID, true);
        iwxapi.registerApp(WECHAT_APP_ID);
}

分享或收藏的目标场景，通过修改scene场景值实现（下文中红色代码处为修改分享的场景）。
发送到聊天界面——WXSceneSession
发送到朋友圈——WXSceneTimeline
添加到微信收藏——WXSceneFavorite
具体的分享的用法如下，在调用封装好的方法之前别忘了下面的两句代码。

private IWXAPI api;
api = WXAPIFactory.createWXAPI(this,WECHAT_APP_ID, true);

2.3.1.1文字类型分享示例

（以下代码中做了封装，与官网中开发文档中不符的以官方文档为主）

/**
     * 分享到微信
     *
     * @param text              文字内容
     * @param isShareToTimeline false表示分享给朋友，true表示分享到朋友圈
     */
    public static void sendReqText(String text, boolean isShareToTimeline) {
        // 初始化一个WXTextObject对象
        WXTextObject textObj = new WXTextObject();
        textObj.text = text;

        // 用WXTextObject对象初始化一个WXMediaMessage对象
        WXMediaMessage msg = new WXMediaMessage();
        msg.mediaObject = textObj;
        // 发送文本类型的消息时，title字段不起作用
        // msg.title = "Will be ignored";
        msg.description = text;

        // 构造一个Req
        SendMessageToWX.Req req = new SendMessageToWX.Req();
        req.transaction = buildTransaction("text"); // transaction字段用于唯一标识一个请求
        req.message = msg;
//要分享给好友还是分享到朋友圈
        req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;

        // 调用api接口发送数据到微信
        api.sendReq(req);
    }

2.3.1.2图片类型分享示例

（以下代码中做了封装，与官网中开发文档中不符的以官方文档为主）

/**
     * 发送图片到微信
     *
     * @param context           上下文
     * @param index             索引。0：表示Bitmap文件；1：表示手机本地图片；2：表示网络图片(图片的URL)
     * @param isShareToTimeline false表示分享给朋友，true表示分享到朋友圈
     */
    public static void sendReqImg(Context context, int index, boolean isShareToTimeline) {
        switch (index) {
            case 0: {
                Bitmap bmp = BitmapFactory.decodeResource(context.getResources(), R.mipmap.welcome);
                WXImageObject imgObj = new WXImageObject(bmp);

                WXMediaMessage msg = new WXMediaMessage();
                msg.mediaObject = imgObj;

                Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB_SIZE, THUMB_SIZE, true);
                bmp.recycle();
                msg.thumbData = Util.bmpToByteArray(thumbBmp, true);  // 设置缩略图

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("img");
                req.message = msg;
                //要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);

                break;
            }
            case 1: {
                String path = SDCARD_ROOT + "/test.png";
                File file = new File(path);
                if (!file.exists()) {
                    String tip = "图片文件不存在";
                    Toast.makeText(context, tip + " path = " + path, Toast.LENGTH_LONG).show();
                    break;
                }

                WXImageObject imgObj = new WXImageObject();
                imgObj.setImagePath(path);

                WXMediaMessage msg = new WXMediaMessage();
                msg.mediaObject = imgObj;

                Bitmap bmp = BitmapFactory.decodeFile(path);
                Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB_SIZE, THUMB_SIZE, true);
                bmp.recycle();
                msg.thumbData = Util.bmpToByteArray(thumbBmp, true);

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("img");
                req.message = msg;
                //要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);
                break;
            }
            case 2: {
                String url = "http://weixin.qq.com/zh_CN/htmledition/images/weixin/weixin_logo0d1938.png";

                try {
                    WXImageObject imgObj = new WXImageObject();
                    imgObj.imageUrl = url;

                    WXMediaMessage msg = new WXMediaMessage();
                    msg.mediaObject = imgObj;

                    Bitmap bmp = BitmapFactory.decodeStream(new URL(url).openStream());
                    Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB_SIZE, THUMB_SIZE, true);
                    bmp.recycle();
                    msg.thumbData = Util.bmpToByteArray(thumbBmp, true);

                    SendMessageToWX.Req req = new SendMessageToWX.Req();
                    req.transaction = buildTransaction("img");
                    req.message = msg;
                    //要分享给好友还是分享到朋友圈
                    req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                    api.sendReq(req);
                } catch (Exception e) {
                    e.printStackTrace();
                }

                break;
            }
            default:
                break;
        }
    }

2.3.1.3音乐类型分享示例

（以下代码中做了封装，与官网中开发文档中不符的以官方文档为主）

/**
     * 分享音乐到微信
     *
     * @param context           上下文
     * @param index             索引。0：表示发送音乐url；1表示发送低带宽音乐url
     * @param musicUrl          音乐的URL
     * @param title             标题
     * @param description       描述
     * @param isShareToTimeline false表示分享给朋友，true表示分享到朋友圈
     */
    public static void sendReqMusic(Context context, int index, String musicUrl, String title, String description, boolean isShareToTimeline) {
        switch (index) {
            case 0: {
                WXMusicObject music = new WXMusicObject();
                music.musicUrl = musicUrl;

                WXMediaMessage msg = new WXMediaMessage();
                msg.mediaObject = music;
                msg.title = title;
                msg.description = description;

                Bitmap thumb = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_launcher);
                msg.thumbData = Util.bmpToByteArray(thumb, true);

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("music");
                req.message = msg;
                //要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);
                break;
            }
            case 1: {
                WXMusicObject music = new WXMusicObject();
                music.musicLowBandUrl = musicUrl;

                WXMediaMessage msg = new WXMediaMessage();
                msg.mediaObject = music;
                msg.title = title;
                msg.description = description;

                Bitmap thumb = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_launcher);
                msg.thumbData = Util.bmpToByteArray(thumb, true);

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("music");
                req.message = msg;
//要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);
                break;
            }
            default:
                break;
        }
    }

2.3.1.4视频类型分享示例

（以下代码中做了封装，与官网中开发文档中不符的以官方文档为主）

/**
     * 分享视频到微信
     *
     * @param context           上下文
     * @param index             索引。0：表示发送视频url；1：表示发送低带宽视频url
     * @param title             标题
     * @param description       描述
     * @param isShareToTimeline false表示分享给朋友，true表示分享到朋友圈
     */
    public static void sendReqVideo(Context context, int index, String VideoUrl, String title, String description, boolean isShareToTimeline) {
        switch (index) {
            case 0: {
                WXVideoObject video = new WXVideoObject();
                video.videoUrl = VideoUrl;

                WXMediaMessage msg = new WXMediaMessage(video);
                msg.title = title;
                msg.description = description;
                Bitmap thumb = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_launcher);
                msg.thumbData = Util.bmpToByteArray(thumb, true);

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("video");
                req.message = msg;
//要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);
                break;
            }
            case 1: {
                WXVideoObject video = new WXVideoObject();
                video.videoLowBandUrl = VideoUrl;

                WXMediaMessage msg = new WXMediaMessage(video);
                msg.title = title;
                msg.description = description;

                SendMessageToWX.Req req = new SendMessageToWX.Req();
                req.transaction = buildTransaction("video");
                req.message = msg;
                //要分享给好友还是分享到朋友圈
                req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
                api.sendReq(req);
                break;
            }
            default:
                break;
        }
    }

2.3.1.5网页类型分享示例

（以下代码中做了封装，与官网中开发文档中不符的以官方文档为主）

/**
     * 分享网址到微信
     *
     * @param context           上下文
     * @param webUrl            要分享的网址
     * @param title             标题
     * @param description       描述
     * @param isShareToTimeline false表示分享给朋友，true表示分享到朋友圈
     */
    public static void sendReqWeb(Context context, String webUrl, String title, String description, boolean isShareToTimeline) {
        WXWebpageObject webpage = new WXWebpageObject();
        webpage.webpageUrl = webUrl;
        WXMediaMessage msg = new WXMediaMessage(webpage);
        msg.title = title;
        msg.description = description;
        Bitmap thumb = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_launcher);
        msg.thumbData = Util.bmpToByteArray(thumb, true);

        SendMessageToWX.Req req = new SendMessageToWX.Req();
        req.transaction = buildTransaction("webpage");
        req.message = msg;
//要分享给好友还是分享到朋友圈
        req.scene = isShareToTimeline ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
        api.sendReq(req);
    }

这样只要正确调用了上面的方法基本也就分享成功了，但是这里并不完善，因为分享完毕返回我们的app时微信还会返回给我们的app一些数据，来表示分享成功、失败或者取消的状态。但是这并不影响app的使用，具体的回调函数我们在下文中再做详解。

---

2.3.2、使用微信登录

使用微信登录会有三种情况：

1、 用户手机上没有微信，那么就提示没有微信，并引导用户下载（官方说法）；
2、 用户手机上有微信，但是没有登录，那么需要用户使用账号密码登录；
3、 用户手机上有微信，并且已登录，那么只需要用户点击授权按钮即可；

这里会涉及到许多东西，我们先大概看一下整个请求微信登陆的过程。（这里也是我根据官方的文档然后自己的理解来的，如有错误纰漏之处还请指出）

注： 实线代表客户端请求客户端或者服务端
虚线代表服务端相应客户端的请求

0、 首先，用户偷懒不想注册想使用微信的账号密码登录（额，好吧）；
1、 用户在app中点击“微信登录”按钮，我们的app这时需要请求微信；
2、 集成好的app去调用微信，微信给出相应（开始提到的三种情况）；
3、 用户下载好后，登录后者直接授权后，提交结果给微信服务器；
4、 微信服务器根据结果返回临时code（新版的jar包中返回的code名称改为了token，但实际仍为code的值，使用方法一致）；
5、 App根据临时的code、AppID以及AppSecret换取微信的access_token。一同返回的还有refresh_token，因为access_token是有有效期的，过期后可以使用refresh_token进行刷新。但是refresh_token也是有有效期的，一般是30天，这个过期了就需要用户重新进行授权了；
6、 微信服务器响应，返回access_token等信息；
7、 根据得到的access_token可以拿到用户的基本信息，如下：

• openid 普通用户的标识，对当前开发者帐号唯一
• nickname 普通用户昵称
• sex 普通用户性别，1为男性，2为女性
• province 普通用户个人资料填写的省份
• city 普通用户个人资料填写的城市
• country 国家，如中国为CN
• headimgurl 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空
• privilege 用户特权信息，json数组，如微信沃卡用户为（chinaunicom）
• unionid unified user identity. For applications in a WeChat open platform account, the same user unionid is unique. ;

This, micro-channel will clear the login code would not have posted it, please refer to the micro-channel official document, complete the rest of the article later.