自从ZEGO即构发布小游戏平台以来,很多客户都很感兴趣,积极申请接入中,其中有一部分客户已上线,在用户留存与业务增长方面取得亮眼成绩。
本文以Android平台为例,介绍如何接入小游戏SDK。在此之前,简单介绍下 ZEGO 小游戏平台:
小游戏平台(ZEGO MiniGameEngine) 通过 SDK 和服务端 API,为开发者提供小游戏资源和一起玩服务,具有体积小,游戏种类丰富,游戏模式多样,接入快捷等特点。凭借本产品,开发者可以在视频直播、语聊房、语音电台等泛娱乐场景,快速实现单人或多人玩休闲类、竞技类或其他小游戏,增强场景趣味性及互动性,提升用户活跃度,并促进流水上涨。
游戏类型 | 支持程度 | 游戏举例 | |
---|---|---|---|
普通小游戏 | 休闲游戏 | ✔️ | 桌球、碰碰派对、你画我猜等。 |
棋牌类游戏 | ✔️ | 飞行棋、五子棋、斗地主等。 | |
养成类游戏 | ✔️ | 元宇宙养鸡等。 | |
语音类游戏 | ✔️ | 谁是卧底(语音版)等。 | |
弹幕游戏 | PC 端 | ✔️ | 萌宠斗蛋仔、王者战争等。 |
特性指标
特性 | 指标 |
---|---|
增量大小 | 将 ZEGO MiniGameEngine SDK 集成到 App 后,App 的增量大小如下: Android:2 MB; iOS:4.4 MB; H5:390 KB |
服务区域 | 服务全球,提供稳定的游戏服务。 |
接下来我们来介绍一下,ZEGO小游戏SDK的具体接入方式。
准备环境
在开始集成 ZEGO MiniGameEngine SDK 前,请确保开发环境满足以下要求:
- Android Studio 2021.2.1 或以上版本。
- Android SDK 29、Android SDK Build-Tools 29.0.2、Android SDK Platform-Tools 29.x.x 或以上版本。
- Android 5.0 或以上版本且支持音视频的 Android 设备。
- Android 设备已经连接到 Internet。
小游戏 SDK 接入步骤
步骤1 :新建项目(可选)
此步骤以如何创建新项目为例,如果是集成到已有项目,可忽略此步。
- 打开 Android Studio,选择 “File > New > New Project” 菜单。
填写项目名及项目存储路径。
其它按照默认设置,单击 “Next”,最后单击 “Finish” 完成新工程创建。
步骤2:导入 ZEGO Express SDK
ZEGO MiniGameEngine SDK 需要与 ZEGO Express SDK 3.1.1 或以上版本 搭配使用。如果您的项目已集成相关 SDK,可忽略此步骤,否则,请根据您的项目需求,参考以下任一文完成集成:
步骤3:导入 ZEGO MiniGameEngine SDK
开发者可通过以下任意一种方式实现集成 SDK。
方式一:自动集成
1. 在项目的 “setting.gradle” 或 “build.gradle” 文件中的 ·repositories” 节点加上 ZEGO 的私有 maven 仓库地址。
repositories {
...
maven { url "https://storage.zego.im/maven" }
...
}
2. 打开 “app/build.gradle” 文件,在 dependencies
节点下添加以下依赖项:
dependencies {
...
// 以下代码中的 x.y.z 应替换为为小游戏引擎 SDK 的版本号,请参考 [小游戏引擎 - 发布日志](https://doc-zh.zego.im/article/17635)
implementation "im.zego:minigameengine:x.y.z"
...
}
方式二:手动集成
- 请参考 下载 文档,下载最新版本的 SDK 并解压。
- 打开已解压文件夹,将 zegoaminigame.aar 文件,拷贝到您的项目的 “app/libs” 目录下。
- 打开 “app/build.gradle” 文件,在 dependencies 节点下添加以下依赖项:
...
dependencies {
...
implementation fileTree(dir:'libs', include: ['.jar', '.aar'])
...
...
implementation "com.google.code.gson:gson:2.8.8"
...
}
步骤4:设置权限
打开 “/app/src/main/AndroidManifest.xml” 文件,添加如下权限:
<!-- SDK 必须使用的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
具体的权限说明如下:
必要性 | 权限 | 权限说明 | 申请原因 |
---|---|---|---|
必要权限 | INTERNET | 访问网络权限。 | SDK 基本功能都需要在联网的情况下才可以使用。 |
ACCESS_WIFI_STATE | 获取当前 Wi-Fi 状态权限。 | SDK 会根据网络状态的改变执行不同的操作。例如,当网络重连时,SDK 内部会将网络断开时的状态都恢复,用户不需做额外的操作。 | |
ACCESS_NETWORK_STATE | 获取当前网络状态权限。 |
步骤5:设置混淆规则
ZEGO MiniGameEngine SDK 内部已经做了混淆处理,您的项目无需再针对集成 ZEGO MiniGameEngine SDK 增加混淆规则。
下一步
到此为止,您已成功向您的项目接入了相关 SDK。接下来,您可参考 实现小游戏 了解如何构建小游戏 App。
本文为原创稿件,版权归作者所有,如需转载,请注明出处:https://www.nxrte.com/jishu/38140.html