Unity接入微信支付SDK 2022年版安卓篇

最近1年转了UE开发，博客更新的比较少，技术栈宽了不少，以后有空尽量多更新，也方便总结记忆

Unity接入微信支付整个过程坑比较多，网上之前的教程要么比较老，要么比较零碎，只能东拼西凑摸索，跑通后还是总结记录下吧

开发环境，Windows11，Unity2020.3.24f1c2，Android Studio2021.2.1 Patch2

1.注册微信开放平台，注册应用，申请微信支付，来获取调取SDK的必要参数，此处不展开了(https://open.weixin.qq.com/)
2.确保开发环境装好，jdk，sdk等，Unity的安卓环境可以用Unity Hub自带的装好，也可以用全局环境变量的
3.Android Studio端的开发，导出aar

新建工程

设置包名，注意要和unity工程的包名一致

切换到Project视图，新建module，要选择Android Library

保持包名一致

需要将微信的库和Unity（微信支付成功后需要安卓端主动通知Unity端）的库都加入到工程中的lib文件夹中

Unity的库在这个位置，classes.jar文件，根据自己的需求来选择il2cpp还是mono，release还是dev，一共四种

将Unity的库照图右键添加到gradle配置中

新版的classes.jar文件里不包含UnityPlayerActivity类，需要从你编辑器的这个路径里Editor\2020.3.24f1c2\Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player拷贝出UnityPlayerActivity.java文件

然后回到编辑器中，取消勾选图片中的选线，可以让包名文件夹分级

新建一级微信package

直接把UnityPlayerActivity.java文件拖到wx下面

然后我们开始引入微信的库，微信官方已经不直接提供jar或者aar的下载，已改用 gradle 形式，发布到 Maven Central

这样方便安卓工程集成，但是我们要打出aar包给unity使用，直接导出aar的话并不包含微信的库，有两种方法来解决
1）是谷歌出的一款插件，通过Unity插件Play Services Resolver for Unity在Unity端补全aar库的依赖关系，这个甚至可以补全ios平台的依赖，但我用的不多，引路官方仓库：https://github.com/googlesamples/unity-jar-resolver
2）通过Google Maven下载,搜索wechat，然后选择版本，选择aar包下载到本地

aar包中是包含jar的，我们需要用解压软件把jar包提取出来，然后改好名字

最后将微信的jar包放到lib下面并右键添加到工程中

这时我们rebuild工程，就可以看到打出的aar包了，在这个路径下

还有一点，这个aar包中包含unity的库，我们不需要，这会导致我们打包报错，修改build.gradle，将unity的库改为只引用，打包不包含

至此我们的lib依赖部分完成，下面开始添加Java的逻辑，首先是两个微信的Activity，用于安卓到Unity端的调用，一个登录，一个支付

代码在这里,记住，别忘了把APP_ID换成你们自己申请的
WXEntryActivity

package com.myvision.myapp.wxapi;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.widget.Toast;

import com.tencent.mm.opensdk.constants.ConstantsAPI;
import com.tencent.mm.opensdk.modelbase.BaseReq;
import com.tencent.mm.opensdk.modelbase.BaseResp;
import com.tencent.mm.opensdk.modelbiz.SubscribeMessage;
import com.tencent.mm.opensdk.modelbiz.WXLaunchMiniProgram;
import com.tencent.mm.opensdk.modelbiz.WXOpenBusinessView;
import com.tencent.mm.opensdk.modelbiz.WXOpenBusinessWebview;
import com.tencent.mm.opensdk.modelmsg.SendAuth;
import com.tencent.mm.opensdk.modelmsg.ShowMessageFromWX;
import com.tencent.mm.opensdk.modelmsg.WXAppExtendObject;
import com.tencent.mm.opensdk.modelmsg.WXMediaMessage;
import com.tencent.mm.opensdk.openapi.IWXAPI;
import com.tencent.mm.opensdk.openapi.IWXAPIEventHandler;
import com.tencent.mm.opensdk.openapi.WXAPIFactory;

import java.lang.ref.WeakReference;

public class WXEntryActivity extends Activity implements IWXAPIEventHandler{
    private static String TAG = "MicroMsg.WXEntryActivity";

    private IWXAPI api;
    private MyHandler handler;
    public static String wxAPPID = "换成你们自己";
    private static class MyHandler extends Handler {
        private final WeakReference<WXEntryActivity> wxEntryActivityWeakReference;

        public MyHandler(WXEntryActivity wxEntryActivity){
            wxEntryActivityWeakReference = new WeakReference<WXEntryActivity>(wxEntryActivity);
        }

        @Override
        public void handleMessage(Message msg) {
            int tag = msg.what;

        }
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        api = WXAPIFactory.createWXAPI(this, wxAPPID, false);
        handler = new MyHandler(this);

        try {
            Intent intent = getIntent();
            api.handleIntent(intent, this);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);

        setIntent(intent);
        api.handleIntent(intent, this);
    }

    @Override
    public void onReq(BaseReq req) {
        switch (req.getType()) {
            case ConstantsAPI.COMMAND_GETMESSAGE_FROM_WX:
                goToGetMsg();
                break;
            case ConstantsAPI.COMMAND_SHOWMESSAGE_FROM_WX:
                goToShowMsg((ShowMessageFromWX.Req) req);
                break;
            default:
                break;
        }
        finish();
    }

    @Override
    public void onResp(BaseResp resp) {
        int result = 0;

        switch (resp.errCode) {
            case BaseResp.ErrCode.ERR_OK:

                break;
            case BaseResp.ErrCode.ERR_USER_CANCEL:

                break;
            case BaseResp.ErrCode.ERR_AUTH_DENIED:

                break;
            case BaseResp.ErrCode.ERR_UNSUPPORT:

                break;
            default:
                break;
        }

        Toast.makeText(this, getString(result) + ", type=" + resp.getType(), Toast.LENGTH_SHORT).show();


        if (resp.getType() == ConstantsAPI.COMMAND_SUBSCRIBE_MESSAGE) {
            SubscribeMessage.Resp subscribeMsgResp = (SubscribeMessage.Resp) resp;
            String text = String.format("openid=%s\ntemplate_id=%s\nscene=%d\naction=%s\nreserved=%s",
                    subscribeMsgResp.openId, subscribeMsgResp.templateID, subscribeMsgResp.scene, subscribeMsgResp.action, subscribeMsgResp.reserved);

            Toast.makeText(this, text, Toast.LENGTH_LONG).show();
        }

        if (resp.getType() == ConstantsAPI.COMMAND_LAUNCH_WX_MINIPROGRAM) {
            WXLaunchMiniProgram.Resp launchMiniProgramResp = (WXLaunchMiniProgram.Resp) resp;
            String text = String.format("openid=%s\nextMsg=%s\nerrStr=%s",
                    launchMiniProgramResp.openId, launchMiniProgramResp.extMsg,launchMiniProgramResp.errStr);

            Toast.makeText(this, text, Toast.LENGTH_LONG).show();
        }

        if (resp.getType() == ConstantsAPI.COMMAND_OPEN_BUSINESS_VIEW) {
            WXOpenBusinessView.Resp launchMiniProgramResp = (WXOpenBusinessView.Resp) resp;
            String text = String.format("openid=%s\nextMsg=%s\nerrStr=%s\nbusinessType=%s",
                    launchMiniProgramResp.openId, launchMiniProgramResp.extMsg,launchMiniProgramResp.errStr,launchMiniProgramResp.businessType);

            Toast.makeText(this, text, Toast.LENGTH_LONG).show();
        }

        if (resp.getType() == ConstantsAPI.COMMAND_OPEN_BUSINESS_WEBVIEW) {
            WXOpenBusinessWebview.Resp response = (WXOpenBusinessWebview.Resp) resp;
            String text = String.format("businessType=%d\nresultInfo=%s\nret=%d",response.businessType,response.resultInfo,response.errCode);

            Toast.makeText(this, text, Toast.LENGTH_LONG).show();
        }

        if (resp.getType() == ConstantsAPI.COMMAND_SENDAUTH) {
            SendAuth.Resp authResp = (SendAuth.Resp)resp;
            final String code = authResp.code;

        }
        finish();
    }

    private void goToGetMsg() {
       // Intent intent = new Intent(this, GetFromWXActivity.class);
      //  intent.putExtras(getIntent());
      //  startActivity(intent);
        finish();
    }

    private void goToShowMsg(ShowMessageFromWX.Req showReq) {
        WXMediaMessage wxMsg = showReq.message;
        WXAppExtendObject obj = (WXAppExtendObject) wxMsg.mediaObject;

        StringBuffer msg = new StringBuffer();
        msg.append("description: ");
        msg.append(wxMsg.description);
        msg.append("\n");
        msg.append("extInfo: ");
        msg.append(obj.extInfo);
        msg.append("\n");
        msg.append("filePath: ");
        msg.append(obj.filePath);

 //       Intent intent = new Intent(this, ShowFromWXActivity.class);
  //      intent.putExtra(Constants.ShowMsgActivity.STitle, wxMsg.title);
  //      intent.putExtra(Constants.ShowMsgActivity.SMessage, msg.toString());
 //       intent.putExtra(Constants.ShowMsgActivity.BAThumbData, wxMsg.thumbData);
 //       startActivity(intent);
        finish();
    }
}

WXPayEntryActivity

package com.myvision.myapp.wxapi;

import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;

import com.tencent.mm.opensdk.constants.ConstantsAPI;
import com.tencent.mm.opensdk.modelbase.BaseReq;
import com.tencent.mm.opensdk.modelbase.BaseResp;
import com.tencent.mm.opensdk.openapi.IWXAPI;
import com.tencent.mm.opensdk.openapi.IWXAPIEventHandler;
import com.tencent.mm.opensdk.openapi.WXAPIFactory;
import com.unity3d.player.UnityPlayer;


public class WXPayEntryActivity extends Activity implements IWXAPIEventHandler{

    public static String GameObjectName;
    public static String CallBackFuncName;

    private static final String TAG = "WXPayEntryActivity";
    private IWXAPI api;
    public static String wxAPPID = "换成你们自己";		// 在调用微信支付处，设置该变量值

    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);

        // setContentView(R.layout.wx_pay_result);
        //

        api = WXAPIFactory.createWXAPI(this, wxAPPID);
        api.handleIntent(getIntent(), this);
        //UnityPlayer.UnitySendMessage(GameObjectName,CallBackFuncName,"微信API_ING");
    }

    @Override
    protected void onNewIntent(Intent intent)
    {
        super.onNewIntent(intent);
        setIntent(intent);

        api.handleIntent(intent, this);
    }

    @Override
    public void onReq(BaseReq req)
    {

    }


    /** 微信返回支付结果，会调用该函数*/
    @Override
    public void onResp(BaseResp resp)
    {
        showText("onPayFinish, errCode = " + resp.errCode);

        if (resp.errCode != 0 && resp.errCode != -2)
        {
            showToast(this, "微信支付失败, errCode：" + resp.errCode);
        }

        if (resp.getType() == ConstantsAPI.COMMAND_PAY_BY_WX)
        {
            // AlertDialog.Builder builder = new AlertDialog.Builder(this);
            // builder.setTitle("提示");
            // builder.setMessage("微信支付结果：" + resp.errCode);
            // builder.show();

            if(resp.errCode == 0)
            {
                // PaySuccess(this);	// 可在此处，添加应用自己的支付结果统计相关逻辑
                showToast(this, "微信支付成功");
            }
            else if(resp.errCode == -2) showToast(this, "用户取消支付");
            else showToast(this, "支付失败，其他异常情形" );
        }
        showToast(this, GameObjectName+","+CallBackFuncName );
        UnityPlayer.UnitySendMessage(GameObjectName,CallBackFuncName,"支付回调："+resp.errCode);
        this.finish();
    }


    /** 输出log信息 */
    public static void showText(final String info)
    {
        Log.d(TAG, info);
    }

    /** 输出Toast消息 */
    private void showToast(Context context, final String info)
    {
        Toast.makeText(context, info, Toast.LENGTH_SHORT).show();
        Log.d(TAG, info);
    }
}

然后我们需要新建一个继承自UnityPlayerActivity的MainActivity，里面目前只实现的创建wxapi和一个支付逻辑

package com.myvision.myapp.wx;

import android.os.Bundle;

import com.myvision.myapp.wxapi.WXPayEntryActivity;
import com.tencent.mm.opensdk.modelpay.PayReq;
import com.tencent.mm.opensdk.openapi.IWXAPI;
import com.tencent.mm.opensdk.openapi.WXAPIFactory;

public class MainActivity extends UnityPlayerActivity {
    public static String APP_ID;

    private PayReq req = new PayReq();
    private IWXAPI wxAPI = null;

    @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        APP_ID = "换成你们自己";
        WechatInit(APP_ID);
    }

    public void WechatInit(String appid){
        APP_ID = appid;

        if(wxAPI==null){
            wxAPI = WXAPIFactory.createWXAPI(this,appid);
            wxAPI.registerApp(appid);
        }
    }

    public boolean IsWechatInstalled(){
        return wxAPI.isWXAppInstalled();
    }

    public void WeChatPayReq(String APP_ID,String MCH_ID,String prepayid,String packageValue,String noncestr,String timestamp,String sign,String callBackObjectName,String CallBackFuncName) {
        WXPayEntryActivity.GameObjectName = callBackObjectName;
        WXPayEntryActivity.CallBackFuncName = CallBackFuncName;
        req.appId = APP_ID;
        req.partnerId = MCH_ID;
        req.prepayId = prepayid;
        req.packageValue =packageValue;
        req.nonceStr = noncestr;
        req.timeStamp = timestamp;
        req.sign = sign;
        wxAPI.sendReq(req);
    }
}

坚持住伙计！Rebuild Project！我们的aar就新鲜出炉了！我为你感到自豪！

4.Unity端的开发
首先新建好unity工程，确保包名一致，把我们的aar丢到图中位置

切换到安卓平台，设置下你的keystore签名，没有这个的话不能正常唤起微信（关联Tip1），勾选Custon Main Manifest,我们需要创建一个自定义的AndroidManifest.xml文件

AndroidManifest这样写

<?xml version="1.0" encoding="utf-8"?>
<!-- GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN-->
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.myvision.myapp"
    xmlns:tools="http://schemas.android.com/tools">

  <queries>
    <package android:name="com.tencent.mm" />   // 指定微信包名
  </queries>

  <application>
    <activity android:name="com.myvision.myapp.wx.MainActivity"     
              android:exported="true"
              android:theme="@style/UnityThemeSelector">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
    </activity>
    <activity
        android:name="com.myvision.myapp.wxapi.WXEntryActivity"
        android:exported="true"
        android:launchMode="singleTask">
    </activity>
    <activity
    android:name="com.myvision.myapp.wxapi.WXPayEntryActivity"
    android:exported="true"
    android:launchMode="singleTask">
    </activity>
  </application>
</manifest>

注意安卓11以上，一定要加这段，否则无法调起微信（落泪）

 <queries>
    <package android:name="com.tencent.mm" />   // 指定微信包名
  </queries>

最后一的C#做一个简单的调用

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class Test : MonoBehaviour
{
    public Text ui;
    public Text ui2;
    private AndroidJavaObject jo= null;
    // Start is called before the first frame update

    public void Init() {
        AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
        jo = jc.GetStatic<AndroidJavaObject>("currentActivity");
    }

    public void CheckWX() {
        bool bo = true;
        bo = jo.Call<bool>("IsWechatInstalled");
        ui.text = bo.ToString();
    }

    public void WXPay() {
        jo.Call("WeChatPayReq", 
            "你的APP_ID",
            "",
            "",
            "com.myvision.myapp",
            "",
            "",
            "",
            "Test",
            "WXCallback");
    }

    public void WXCallback(string str) {
        print("WXCallback");
        ui2.text = str;
    }
}

Editor里面大概就是这个样子，自己给按钮绑定好对应事件

然后就可以打包了，签过名打出包来以后装在手机上，要再下载微信的签名获取工具：https://res.wx.qq.com/wxdoc/dist/assets/media/Gen_Signature_Android.e481f889.zip
在里面输入包名获取签名，把签名填在微信开平平台对应的app信息里面，否则无法正常调起

平台上更新好签名后（审核要半天左右），再重新运行app，就可以调用微信支付了,我目前还没接后端服务器部分，所以还没有真实的微信支付参数，但传入app_id后就可以正常调微信（但是没调起来，需要支付相关参数正确），以及接收到安卓传来的支付回调给Unity端，所以还不算完整流程，后面有机会再详细补充下