【游戏开发教程】Unity iOS平台接入微信SDK，实现微信登录等功能（教程 | 流程讲解）

移动开发 2021-12-14 07:16:21 阅读次数: 0

文章目录

一、前言

嗨，大家好，我是新发。
有小伙伴私信问我Unity怎么接入微信登录，
在这里插入图片描述
答案就是接入微信SDK，不过，微信开放平台的文档写的不是很友好，这里我讲讲流程，希望可以帮助到有疑问的同学。（注：我手头上没有mac电脑，不方便测试，本文主要是讲解流程）
注：本文以iOS平台为例。

二、流程

1、申请开发者账号

首先在微信开放平台得先有一个企业开发者账号，微信开放平台地址：https://open.weixin.qq.com/，
在这里插入图片描述
注册流程很简单，不赘述，
在这里插入图片描述

2、创建应用

上面申请好开发者账号后就可以登录了，登录开发者账号后，进入管理中心，选择移动应用，然后点击创建移动应用，
在这里插入图片描述
填写相关信息，提交后等审核，
在这里插入图片描述
审核通过后，即可得到应用的AppID和AppSecret，后面调用SDK接口的时候需要用到这两个值。

3、下载SDK

首先可以看一下微信开放平台的文档，这个是 iOS接入指南文档：https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/iOS.html
里面讲了两种方式来引入SDK：
1、通过CocoaPods集成；（有点类似于Android Gradle配置依赖，自动下载依赖文件）
2、手动集成。（手动下载SDK库文件，导入工程中）

一般我们是在内网开发，所以这里我讲一下手动集成的方式。
iOS平台SDK库文件下载页：https://developers.weixin.qq.com/doc/oplatform/Downloads/iOS_Resource.html
点击iOS开发工具包即可下载SDK库文件，如果想看下Demo范例，可以点击范例代码，如下
在这里插入图片描述

4、导入到Unity中

iOS开发工具包下载下来后解压，里面的文件如下，一个.a库文件和三个.h头文件，
在这里插入图片描述
我们将它们拷贝到Unity工程的Assets/Plugins/iOS/WeChatSDK目录中，如下，
在这里插入图片描述

5、编写Objective-C代码

想要在C#中调用SDK接口，我们需要写一层中间层（使用Objective-C写），
在这里插入图片描述

5.1、CustomAppController.mm

在iOS平台接SDK的时候，需要实现自己的AppController来维护SDK的生命周期，默认是UnityAppController，我们可以继承它并重写逻辑。
在Assets/Plugins/iOS/目录中创建一个CustomAppController.mm文件，如下，
（注：文件名必须是 xxxxAppController.mm，xxxx前缀可自定义，但不能省略，比如我这里叫CustomAppController.mm​）
在这里插入图片描述
内容如下：

// CustomAppController.mm

#import  "UnityAppController.h"
@interface CustomAppController : UnityAppController
@end

IMPL_APP_CONTROLLER_SUBCLASS (CustomAppController)

@implementation CustomAppController

- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
{
    
    
    [super application:application didFinishLaunchingWithOptions:launchOptions];
	// TODO 

    return YES;
}
@end

注：上面的代码中有一个宏IMPL_APP_CONTROLLER_SUBCLASS，Unity就是通过 IMPL_APP_CONTROLLER_SUBCLASS知道要使用我们定制的 CustomAppController而不是使用默认的UnityAppController。

好了，继续往下走流程。

5.2、WXApiManager.h

在Assets/Plugins/iOS/目录中创建WeChatUnity文件夹，并创建WXApiManager.h头文件，如下，
在这里插入图片描述
内容如下，很简单，引入WXApi.h头文件，继承WXApiDelegate，然后定义一个单例对象sharedManager，

// WXApiManager.h

#import <Foundation/Foundation.h>
#import "WXApi.h"

@interface WXApiManager : NSObject<WXApiDelegate>

+ (instancetype)sharedManager;

@end
5.3、WXApiManager.mm

在WXApiManager.h同级目录中创建WXApiManager.mm文件，去实现具体的逻辑。
在这里插入图片描述
内容如下，

#import "WXApiManager.h"

@implementation WXApiManager

// 单例
+(instancetype)sharedManager {
    
    
    static dispatch_once_t onceToken;
    static WXApiManager *instance;
    dispatch_once(&onceToken, ^{
    
    
        instance = [[WXApiManager alloc] init];
    });
    return instance;
}

- (void)onResp:(BaseResp *)resp {
    
    
	// TODO 微信回调，调用微信SDK的sendReq，会回调此方法，登录、分享等都是回调到这里
}

- (void)onReq:(BaseReq *)req {
    
    
	// TODO 微信回调，从微信端主动发送过来的请求
}

@end

TODO的内容我们先留着，继续往下走流程。

5.4、注册回调对象

我们要让微信回调到WXApiManager对象的onResp方法，就需要先告诉微信，不然它是不知道回调到哪里的。
我们回到CustomAppController.mm文件，先引入头文件：

#import "WXApiManager.h"

添加如下的调用，

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    
    
    return  [WXApi handleOpenURL:url delegate:[WXApiManager sharedManager]];
}

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    
    
    return [WXApi handleOpenURL:url delegate:[WXApiManager sharedManager]];
}

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRestoring>> * __nullable restorableObjects))restorationHandler
{
    
    
    return [WXApi handleOpenUniversalLink:userActivity delegate:[WXApiManager sharedManager]];
}
5.5、封装初始化接口

微信SDK的初始化调用是

[WXApi registerApp:@"你的APPID" universalLink:@"你的UniversalLink"];

你可以把它放在CustomAppController.mm的didFinishLaunchingWithOptions方法中，如下：

- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
{
    
    
    [super application:application didFinishLaunchingWithOptions:launchOptions];
	
	[WXApi registerApp:@"你的APPID" universalLink:@"你的UniversalLink"];
	
    return YES;
}

它是程序启动时最先执行的地方，如果你不想在这么前的位置执行，想推迟到在C#层去执行，则可以封装一个接口出来，然后由C#层来调用。
我们在Assets/Plugns/iOS/WeChatUnity文件夹中创建WeChatUnity.mm文件，如下，
在这里插入图片描述
内容如下，

// WeChatUnity.mm

#import <Foundation/Foundation.h>
#import "WXApiManager.h"

#define UNITY_CS_API extern "C"

static NSString *mWXAppid = nil;

// 将c字符串const char* 转为 oc字符串NSString
static inline NSString * str_c2ns(const char*s)
{
    
    
    if (s)
        return [NSString stringWithUTF8String: s];
    else
        return [NSString stringWithUTF8String: ""];
}

// 初始化
UNITY_CS_API void UnityWeChatInit(const char* appId, const char* universalLink)
{
    
    
	mWXAppid = str_c2ns(appId);
	[WXApi registerApp:mWXAppid universalLink:str_c2ns(universalLink)];
}

接着，我们就可以在C#层声明这个接口并调用了，我们新建一个C#脚本，名叫WeChatSDK.cs，如下
在这里插入图片描述
内容如下，

// WeChatSDK.cs

using UnityEngine;

public class WeChatSDK
{
    
    
    public static void Init()
    {
    
    
#if UNITY_IOS
        UnityWeChatInit("你的APPID", "你的UniversalLink");
#elif UNITY_ANDROID
        // TODO Android的调用
#endif
    }


#if UNITY_IOS
        [DllImport("__Internal")]
        static extern void UnityWeChatInit(string appId, string universalLink);
#endif
}

然后你就可以在你的C#入口脚本那里调用WeChatSDK.Init()了。

5.6、封装登录接口

同理，我们继续在WeChatUnity.mm中封装登录接口，

// WeChatUnity.mm

UNITY_CS_API void UnityWeChatLogin(const char* state)
{
    
    
    NSLog(@"UnityWeChatLogin");

    SendAuthReq* req = [[SendAuthReq alloc] init];
    req.scope = @"snsapi_userinfo";;
    req.state = str_c2ns(state);
    [WXApi sendReq:req completion:nil];
    // 此时会拉起微信，授权后会回调WXApiManager的onResp方法
}

回到WeChatSDK.cs脚本，添加Login接口，如下，

// WeChatSDK.cs

public static void Login()
{
    
    
#if UNITY_IOS
	// "app_wechat"后期改为随机数加session来校验
    UnityWeChatLogin("app_wechat");
#elif UNITY_ANDROID
    // TODO Android的调用
#endif
}
    

#if UNITY_IOS
        [DllImport("__Internal")]
        static extern void UnityWeChatLogin(string state);
#endif

当你在游戏中点击微信登录按钮时，即可调用WeChatSDK.Login啦。
接着，我们去WXApiManager.mm的onResp添加回调的响应逻辑，如下，

// WXApiManager.mm

- (void)onResp:(BaseResp *)resp {
    
    
	if ([resp isKindOfClass:[SendAuthResp class]]) {
    
    
		NSLog(@"微信授权回调");
		if (resp.errCode == 0) {
    
    
			// 通过code去交换token，此步需要用到APPSecret，这个字段非常敏感
			// 实际项目此步是放在服务端执行，这里仅作为客户端演示
			[self requestWxToken:((SendAuthResp *)resp).code];
		}
		else
		{
    
    
			// 失败，回调给Unity
			UnitySendMessage("SDKCallBack", "WeChatLoginCallback", "");
		}
	}
}

// 通过code换取token，此步实际项目是放在服务端执行
-(void)requestWxToken:(NSString*)code {
    
    
    NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@"https://api.weixin.qq.com/sns/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code", mWXAppid, "你的APPSecret", code]];
    
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    
    
        if (error == nil) {
    
    
            NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
            
            [self requestWxUserInfo:[dict valueForKey:@"access_token"]];
        }
    }];
    
    [dataTask resume];
}

// 通过token查询用户信息，此步实际项目是放在服务端执行
-(void)requestWxUserInfo:(NSString*)token{
    
    
    NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@"https://api.weixin.qq.com/sns/userinfo?access_token=%@&openid=%@",token, mWXAppid]];
    
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    
    
        if (error == nil) {
    
    
            NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];
            NSString *jsonStr = [self DataTOjsonString:dict];
            // 回调给Unity
            UnitySendMessage("SDKCallBack", "WeChatLoginCallback",[jsonStr UTF8String]);
        }
    }];
    
    [dataTask resume];
}

上面的结果我们是通过UnitySendMessage接口给Unity发送消息的，会查找名字为SDKCallBack的物体上的脚本，调用脚本中的WeChatLoginCallback方法。
我们在场景中创建一个空物体，重命名为SDKCallBack，
在这里插入图片描述
然后创建一个SDKCallBack.cs脚本，并将其挂到SDKCallBack物体上，
在这里插入图片描述
我们在SDKCallBack脚本中实现WechatLoginCallback方法，如下，

// SDKCallBack.cs

using UnityEngine;

public class SDKCallBack : MonoBehaviour
{
    
    
    /// <summary>
    /// 登录回调
    /// </summary>
    /// <param name="callBackInfo"></param>
    public void WechatLoginCallback(string callBackInfo)
    {
    
    
        // openid	    普通用户的标识，对当前开发者帐号唯一
        // nickname	    普通用户昵称
        // sex	        普通用户性别，1为男性，2为女性
        // province	    普通用户个人资料填写的省份
        // city	        普通用户个人资料填写的城市
        // country	    国家，如中国为CN
        // headimgurl    用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空
        // privilege	    用户特权信息，json数组，如微信沃卡用户为（chinaunicom）
        // unionid	    用户统一标识。针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。多app数据互通保存该值
        // access_token  用户当前临时token值，自主添加的值
        if(string.IsNullOrEmpty(callBackInfo))
        {
    
    
            // TODO 登录失败，请重试
        }
        else
        {
    
    
            // 解析字段，登录进游戏服务器
        }
    }
}
5.7、其他接口封装

其他接口流程同理，在WeChatUnity.mm中封装C接口，调用微信SDK的API，
在WeChatSDK.cs中声明[DllImport("__Internal")]，封装C#层接口，在WXApiManager.mm的onResp中处理响应，通过UnitySendMessage发消息给Unity，在SDKCallBack.cs中处理回调。
画个图方便大家理解，
在这里插入图片描述
流程懂了之后，大家应该就知道怎么封装接口和调用了，我这里就不往下写了~

6、XCodeAPI

我们知道，Unity打包iOS平台是导出XCode工程，我们还需要在XCode工程中做一些设置，最后再导出ipa，事实上，这个过程也可以写成自动化处理，我之前写过一篇文章讲过XCodeAPI，推荐大家看下，《Unity打iOS包之xcodeapi的使用》

7、关于Universal Link

关于Universal Link我之前写过一篇文章，也推荐大家看下，《微信分享显示“未验证应用”问题（辅助标签：Universal Link）》

8、关于iOS刘海屏适配

关于iOS刘海屏适配的问题，我之前写过一篇文章，也推荐大家看下，《Unity适配iphone刘海屏》

三、完毕

好啦，就到这里吧~
我是林新发：https://blog.csdn.net/linxinfa
原创不易，若转载请注明出处，感谢大家~
喜欢我的可以点赞、关注、收藏，如果有什么技术上的疑问，欢迎留言或私信~

猜你喜欢

转载自blog.csdn.net/linxinfa/article/details/121891347
今日推荐
LFOSSA 源来如此公开课 | 掌握云原生未来：CNCF 认证全面攻略与备考秘籍
国产云输入法——仅华为无云端数据上传安全问题
开源日报 | 工业开源项目OGG 1.0；姐姐，你要和我一起配置火狐吗；苹果AI遥遥落后？Fedora 40
开放签电子签章：停止新增，优化体验，前进更进（五一假期前工作）
开源日报 | 中学生开源前端动画引擎；全球首个Llama3 8B中文版开源模型；联想电脑恐出局；Linus讽刺AI炒作
“百模大战”必有一战 | 2024中国“百模大战”竞争格局分析
周排行
Family Tree 题解
BZOJ 1093 最大半连通子图 SCC + DP
幂等处理
Spring----学习（2）----XML 配置Bean 自动装配
SQL Server 远程更新目标表数据
HIbernate3.6 环境搭建
特殊符号正则表达式
【Linux】第一章 进程的理解
843. n-皇后问题（dfs+输出各种情况）
空间数据库2
每日归档
更多
2024-04-26(39)
2024-04-25(22)
2024-04-24(36)
2024-04-23(26)
2024-04-22(39)
2024-04-21(0)
2024-04-20(6)
2024-04-19(5)
2024-04-18(0)
2024-04-17(5)

代码天地 © 2018 codetd.com

境外服务器   最新电视剧2022