Skip to main content
Version: 2.0.0

SDK集成

本页向您展示如何下载、导入和配置HaChi Unity Plugin。

tip
  • 接入HaChiSDK 需要 Xcode 14.2 或更高版本
  • 更新新版本SDK最好先将老版本SDK删除，配置文件除外。并且导出新的Xcode或者Android Studio工程，注意不要覆盖导出到老版本SDK导出的工程。

下载最新的Unity插件​

HCSDK_2.3.5_57a32d5.unitypackage（更新日志）


将插件导入Unity
执行以下步骤导入下载的插件:
在Unity中，选择Assets > Import Package > Custom Package…
选择你下载的Unity Plugin文件。
在Import Unity Package对话框中，单击Import。

如何确定当前SDK版本​

SDK Version 可以在 HCNativeInterface.cs 文件中获取，如下图:

Unity Android平台设置​

1、当弹出Enable Android Auto-resolution?时，请勾选 "Disable"​

2、当弹出Enable Android Gradle templates？时，请勾选 "Disable"​

3、Player Setting设置​

  • Mininum API Level 设置为23
  • Target API Level 请设置为33
  • 设置IL2CPP
  • 勾选ARMv7和ARM64

4、勾选配置​

5、Unity版本低于2022.3需要使用自定义gradle配置。​

"工具栏>Settings>Preferences > External Tools", 取消 "Gradle Installed with Unity (recommended)" 同时设置自定义gradle路径。
自定义gradle版本要求大于6.7.1，推荐下载 https://downloads.gradle.org/distributions/gradle-6.7.1-all.zip 并解压。

6、Assets/Plugins/Android/FirebaseApp.androidlib路径不存在或者目录为空的情况下需要检查：​

1、 检查【参数配置】中GoogleService.json(Android)是否已经拷贝进来。
2、重启unity编辑器。

Unity iOS平台设置​

参数配置​

1、将需求文档中配置文件:
GoogleService-Info.plist (iOS项目会有这个文件)
google-services.json (Android项目会有这个文件)
放在 Assets/ 根目录下。（如sdk原来带有该测试文件请删掉，确保用对应游戏的参数文件）

2、将需求文档中配置文件:
52593f719455c63e2c694b6a4329442b(示例，每个项目配置文件不同)
e33da49e299189c9cf85cdc069cb8ee3(示例，每个项目配置文件不同)
放在 Assets/StreamingAssets/ 目录下即可

注：上述文件均可在需求文档中找到，如下图：

项目配置​

FB SDK配置：填入 Facebook AppName(当前游戏名称)、 App Id（需求文档中查找） 以及 Client Token（需求文档中查找）：

初始化SDK​

void Start()
{
    HCSDKManager.Instance.InitializeSdk(InitSdkCallback);
}

private void InitSdkCallback()
{
    // SDK初始化完成回调
}

初始化方法会自动初始化以下部分：

  • AppTrackingTransparency system (iOS ATT弹框)
  • 统计
  • 广告