自有APP都是怎么引入小程序游戏的?

近期,不少开发者都在提问官方FinClip什么时候增设支持微信小游戏的功能。对此,我们也在此作出回应。自从FinClip  诞生,我们已经在去年就把支持微信小游戏的计划做进了产品的 Roadmap。

终于,在2022年底,官方已经成功的在新年前实现了对小游戏的支持!近期FinClip 官方正在举行小游戏支持的功能内测,有兴趣的朋友可以去看看。手动指引:小游戏内测活动【功能内测】FinClip 支持小游戏相关功能上线!诚邀你来体验(内含福利)-FinClip 小程序框架

回归正题,本文将仔细示范,为大家演示将小程序游戏引入自有app的操作步骤。

实现效果

在自有 App 中实现小程序游戏运行

使用技术

FinClip 小程序容器

测试机

iOS

测试demo

飞机大战小游戏

在 iOS 项目中引入 FinClip ,实现小程序游戏在App中运行,操作如下:

一、获取凭据( SDK KEY 及 SDK SECRET)

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

1、创建小程序游戏

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

2、获取 SDK KEY 及 SDK SECRET

新增应用后,可以展开应用名称,在下方的列表中点击「添加 BundleID」,在出现的弹窗中输入需要绑定应用的 BundleID。

完成 BundleID 的填写,并点击确定按钮后,您会看到如上图所示的界面。其中的SDK KEY,SDK SECRET与API SERVER是您在集成小程序 SDK 时需要要到的凭据。

注意:

  • SDK KEY:是合作应用能使用小程序 SDK 的凭证,如果 SDK Key 校验失败,则SDK 的所有 Api 都无法使用。

  • SDK SECERT:是访问服务的安全证书,不要给第三方。

二、集成 SDK

FinClip 小程序 SDK 目前支持pod集成或者手动集成。此次操作仅介绍pod集成方式。更多详细内容可以查看官方文档

1、安装pod环境

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

2.创建Podfile文件

如果你不需要使用扩展 SDK,那么在podfile中只依赖FinApplet.framework即可。如果你需要使用扩展 SDK 中的 API,那么你还需要依赖FinAppletExt.framework.

注意:从2.8.5版本开始,FinClip 小程序 SDK 拆分为多个SDK:FinApplet(核心SDK)、FinAppletExt、FinAppletBDMap、FinAppletGDMap、FinAppletWebRTC、FinAppletBLE、FinAppletAgoraRTC、FinAppletContact、FinAppletClipBoard、FinAppletWXExt。

其中只有FinApplet是必须的,其他扩展 SDK 可根据实际情况选择集成。

3、安装或更新依赖

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

4 打开工程

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

5、增加权限描述

根据您的实际需求,集成响应的SDK,并在工程info.plist文件中增加权限配置

如果您集成所有的 SDK,那么需要配置的权限包括:相册、相机、麦克风、位置、蓝牙、通讯录。这些权限,全都是调用相应的api和组件时才会触发。

三、添加SDK头文件

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

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

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

四、初始化 SDK

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

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

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

五、handleOpenURL处理

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

六、打开小程序

其他关于 FinClip小程序 SDK 的 API介绍,请查看 API 说明文档。

打开效果如下:

各位开发者可以上手试试看,有任何问题都可以向官方提出哦!

猜你喜欢

转载自blog.csdn.net/weixin_62324593/article/details/128479071