当前位置: 首页 > news >正文

如何把小程序游戏运行到自有App中?(IOS篇)

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

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

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

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

1.1 创建小程序游戏

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

1.2 获取 SDK KEY 及 SDK SECRET

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

 

  • 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)。

sudo gem install cocoapods
pod setup

2.1.2 创建 Podfile 文件

如果你不需要使用扩展 SDK,那么在 podfile 中只依赖 FinApplet 即可。如果你需要使用扩展 SDK 中的 API,那么你还需要依赖 FinAppletExt。比如:如果需要在小程序中使用蓝牙功能,可以在 podfile 中添加 FinAppletBLE 依赖;

集具体操作方法可以去详细查看官方的的文档。iOS 如何引入一个 SDK

2.1.3 安装或更新依赖

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

2.1.4 打开工程

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

三、添加 SDK 头文件

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

#import <FinApplet/FinApplet.h>

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

#import <FinAppletExt/FinAppletExt.h>

当然,最方便的方式是在 pch 文件中添加以上代码,这样在使用的地方就不用再引用了。

四、初始化 SDK

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

NSMutableArray *storeArrayM = [NSMutableArray array];
FATStoreConfig *storeConfig = [[FATStoreConfig alloc] init];
storeConfig.sdkKey = @"您的sdkKey信息";
storeConfig.sdkSecret = @"您的sdkSecret信息";
storeConfig.apiServer = @"服务器域名";
storeConfig.apmServer = @"apm统计事件的域名";
[storeArrayM addObject:storeConfig];
    
FATStoreConfig *storeConfig2 = [[FATStoreConfig alloc] init];
storeConfig2.sdkKey = @"您的sdkKey信息";
storeConfig2.sdkSecret = @"您的sdkSecret信息";
storeConfig2.apiServer = @"服务器域名";
storeConfig2.apmServer = @"apm统计事件的域名";
storeConfig2.cryptType = FATApiCryptTypeSM;
[storeArrayM addObject:storeConfig2];
 
FATConfig *config = [FATConfig configWithStoreConfigs:storeArrayM];
[[FATClient sharedClient] initWithConfig:config error:nil];

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

// 微信扩展SDL初始化
[FATWXExtComponent registerComponent:@"微信appid" universalLink:@"universalLink"];

并在 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<UIUserActivityRestoring>> * _Nullable))restorationHandler {
  return [WXApi handleOpenUniversalLink:userActivity delegate:[FATWXApiManager sharedManager]];
}

五、handleOpenURL 处理

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

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    if ([[FATClient sharedClient] handleOpenURL:url]) {
        return YES;
    }
    return YES;
}
 
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    if ([[FATClient sharedClient] handleOpenURL:url]) {
        return YES;
    }
    return YES;
}

六、打开小程序

FATAppletRequest *request = [[FATAppletRequest alloc] init];
request.appletId = @"小游戏id";
request.apiServer = @"服务器地址";
request.transitionStyle = FATTranstionStyleUp;
request.startParams = startParams;
     
[[FATClient sharedClient] startAppletWithRequest:request InParentViewController:self completion:^(BOOL result, FATError *error) {
    NSLog(@"打开小游戏:%@", error);
} closeCompletion:^{
    NSLog(@"关闭小游戏");
}];

打开效果如下:

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

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

相关文章:

  • [附源码]JAVA毕业设计时间管理系统(系统+LW)
  • k8s master证书更新
  • Java递归算法
  • 《构建中小企业网络V7.1》实验
  • Python均匀分布和三角形分布
  • 【JDBC】----封装工具类和ORM
  • 栾云平,带队到南京德云社演出引发热议
  • Spring Cloud(十五):微服务自动化部署 DevOps CI/CD、Maven打包、ELK日志采集
  • 研究研究 ES_OEMCONVERT 标志
  • 多线程与高并发(一)
  • 一张图让你牢记MySQL主从复制原理|原创
  • CleanMyMac2023一键清除垃圾缓存和恶意广告插件 时刻保持Mac畅快运行
  • PR-39 TFA 是富含脯氨酸和精氨酸的天然抗菌肽
  • HTML学生个人网站作业设计:公益专题扫黑除恶(HTML+CSS)
  • java计算机毕业设计跑腿管理系统源程序+mysql+系统+lw文档+远程调试
  • 给定一个已排序的数组,使用就地算法将重复的数字移除,使数组中的每个元素只出现一次,返回新数组的长度
  • c语言:关键字(二)
  • OpenGL 图像白平衡色温
  • Stable Diffusion模型阅读笔记
  • 三家前装出货超2万台,激光雷达明年「放量」是大概率事件
  • @EnableWebMvc注解让swagger-ui.html无法打开404报错问题及其解决方案(史上最全最详细)
  • Java接口:概述、多实现、多继承、JDK8后接口新增方法
  • 【Java基础】010 -- Java基础综合练习
  • Cesium 和 webgl 加载各类型模型说明
  • 微服务项目(01)
  • 【git】使用技巧
  • Python爬虫(6)-selenium用requests、wget、urllib3这3种方法搞定图片和PDF文件下载
  • 【python学习笔记】:方便好用的自动化脚本
  • 如何使用Python中处理word文档的模块—docx模块
  • 【Python语言基础】——Python 文件处理
  • 2023高三如何选择目标大学 要注意什么
  • 大学军训一般在哪里 军训地点是什么
  • 2023年重庆高考572分能报什么大学 572分能上哪些院校
  • 高考志愿顺序重要吗 需要注意什么
  • 2023高考610分能上985吗 可以上什么大学
  • 2023年贵州高考354分能报什么大学 354分能上哪些院校
  • 2023年广东高考631分能报什么大学 631分能上哪些院校
  • 六级合格线多少分 考多少分算优秀
  • 2023长沙市大学排名最新 好的高校有哪些
  • 怎样学好高中历史 有什么技巧