内测分享:如何把小程序游戏运行到自有app中?

152 阅读4分钟

千呼万唤始出来!FinClip终于支持小游戏了。

我们团队算是FinClip的老用户了,年初就向官方提出了希望FinClip 支持微信小游戏的建议。随着前段时间“羊了个羊”微信小游戏的爆火,官方也把小游戏支持提上了日程,近期官方开启了公测通道。我们用周末用小游戏进行了测试,记录分享一下测试情况。

截屏2022-12-06 下午3.40.02.png 以下操作均是使用FinClip 小程序容器去实现的。iOS端操作如下:

第一步:获取凭据( SDK KEY 及 SDK SECRET)

首先,集成 SDK 需要先在 FinClip 平台中创建应用并绑定小程序游戏应用,获得每个应用专属的SDK KEY及SDK SECRET后,随后就可以在集成 SDK 时填写对应的参数。打开小程序时 SDK 会自动初始化,并校验SDK KEY,SDK SECRET与BundleID(Application ID)是否正确,这一步正确了才能初始化成功并正常使用。

1.1 创建小程序游戏

需要登录FinClip管理后台「应用管理-新增合作应用」,完成应用创建;

截屏2022-12-06 下午3.40.42.png

1.2 获取 SDK KEY 及 SDK SECRET

创建应用并添加 Bundle ID后,选择对应 Bundle ID 后的「复制」,就可以导出对应的 SDK KEY 与 SDK SECRET了。

截屏2022-12-06 下午3.40.50.png

SDK KEY:是合作应用能使用小程序SDK的凭证,如果SDK Key校验失败,则SDK的所有Api都无法使用。 SDK SECERT:是访问服务的安全证书。 第二步:集成 SDK

FinClip 小程序 SDK 目前支持pod集成或者手动集成,此次测试我们用的是pod集成。

2.1.1 安装pod环境

Cocoapods 提供了一个非常简单的依赖管理系统,避免手动导入产生的错误,非常方便。官方安装指南(英文) (opens new window)或CocoaPods安装教程(中文) (opens new window)。

截屏2022-12-06 下午4.15.39.png

2.1.2 创建Podfile文件

截屏2022-12-06 下午4.16.10.png

注意

从2.8.5版本开始,FinClip 小程序 SDK 拆分为多个SDK:FinApplet(核心SDK)、FinAppletExt、FinAppletBDMap、FinAppletGDMap、FinAppletWebRTC、FinAppletBLE、FinAppletAgoraRTC、FinAppletContact、FinAppletClipBoard、FinAppletWXExt。 其中只有FinApplet是必须的,其他扩展 SDK 可根据实际情况选择集成。 如果你不需要使用扩展 SDK,那么在podfile中只依赖FinApplet即可。如果你需要使用扩展 SDK 中的 API,那么你还需要依赖FinAppletExt。比如:如果需要在小程序中使用蓝牙功能,可以在podfile中添加FinAppletBLE依赖;

具体操作方法可以去详细查看官方的的文档。iOS如何引入一个SDK:design.finclip.com/technology_…

2.1.3 安装或更新依赖

然后,执行 pod update 或者 pod install 即可。

2.1.4 打开工程

执行完 pod update 或者 pod install ,打开工程目录,找到xxx.xcworkspace文件,双击打开即可。

三、添加SDK头文件

在需要使用 FinClip 小程序 SDK 的地方,添加如下代码:

截屏2022-12-06 下午4.17.36.png

如果还集成了扩展 SDK,那么调用扩展 SDK 中的 api,还需要加上下面的代码:

截屏2022-12-06 下午4.17.43.png 当然,最方便的方式是在 pch 文件中添加以上代码,这样在使用的地方就不用再引用了。

四、初始化 SDK

在工程的AppDelegate中的以下方法中,调用 SDK 的初始化方法。

截屏2022-12-06 下午4.17.53.png

本次测试需要使用微信的登录,获取用户信息等能力,因此需要进行初始化注册组件。

截屏2022-12-06 下午4.19.59.png

并在AppDelegate.m中增加下面的代码。

  • (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> )options { / 微信登录和分享 */ if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) { return YES; } return YES; } // iOS 9.0 之前
  • (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString )sourceApplication annotation:(id)annotation{ / 微信登录和分享 */ // WeChatHandleURLDelegate WXApiDelegate代理文件 if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) { return YES; } return YES; }
  • (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL )url{ / 微信登录和分享 */ if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) { return YES; } return YES; }
  • (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id> * _Nullable))restorationHandler { return [WXApi handleOpenUniversalLink:userActivity delegate:[FATWXApiManager sharedManager]]; }

五、handleOpenURL处理

一般来说小游戏都需要支持外部通过链接打开,便于分享。则需要做如下处理。

截屏2022-12-06 下午4.22.19.png

六、打开小程序

截屏2022-12-06 下午4.22.27.png 打开效果如下:

截屏2022-12-06 下午3.44.31.png

本次测试使用的是官方给到的demo,整体流程跑下来是比较顺利的,没有遇到特别卡壳的地方,目前官方正在做内测,感兴趣的朋友都可以去官方平台看看。

接下来,安卓系统我们打算使用自己的小游戏再跑一次流程,届时再给大家做分享。