Unity iOS平台接入微信SDK,实现微信登录等功能

文章目录

      • 一、前言
      • 二、流程
        • 1、申请开发者账号
        • 2、创建应用
        • 3、下载SDK
        • 4、导入到Unity中
        • 5、编写Objective-C代码
          • 5.1、CustomAppController.mm
          • 5.2、WXApiManager.h
          • 5.3、WXApiManager.mm
          • 5.4、注册回调对象
          • 5.5、封装初始化接口
          • 5.6、封装登录接口
          • 5.7、其他接口封装
        • 6、XCodeAPI
        • 7、关于Universal Link
        • 8、关于iOS刘海屏适配
      • 三、完毕

一、前言

嗨,大家好,我是新发。
有小伙伴私信问我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​)

内容如下:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

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

1

2

3

4

5

6

7

8

9

10

11

// WXApiManager.h

#import "">

#import "WXApi.h"

@interface WXApiManager : NSObject

+ (instancetype)sharedManager;

@end

5.3、WXApiManager.mm

在WXApiManager.h同级目录中创建WXApiManager.mm文件,去实现具体的逻辑。

内容如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

#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文件,先引入头文件:

1

#import "WXApiManager.h"

添加如下的调用,

1

2

3

4

5

6

7

8

9

10

11

12

13

- (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> * __nullable restorableObjects))restorationHandler

{

    return [WXApi handleOpenUniversalLink:userActivity delegate:[WXApiManager sharedManager]];

}

5.5、封装初始化接口

微信SDK的初始化调用是

1

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

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

1

2

3

4

5

6

7

8

- (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文件,如下,

内容如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

// WeChatUnity.mm

#import "">

#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,如下

内容如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

// 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中封装登录接口,

1

2

3

4

5

6

7

8

9

10

11

12

// 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接口,如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

// 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添加回调的响应逻辑,如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

// 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方法,如下,

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

// SDKCallBack.cs

using UnityEngine;

public class SDKCallBack : MonoBehaviour

{

    ///

    /// 登录回调

    ///

    ///

    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刘海屏》

三、完毕

文章转自 林新发的博客_CSDN博客-Unity3D,android,C#领域博主

你可能感兴趣的:(unity,ios,微信)