Overview
提示
OmniSDK Unity 采用 Unity Package Manager 作为 Package 手动导入到 Unity。
暂不支持 Unity Asset Packages 导入方式。
Environment
Unity 2018.x or later
推荐 Unity 2021.1+
Platform Features
- Android
- iOS
- Windows
Limitations
- API Compatibility 最低
.NET Standard 2.0
- Android SDK 仅支持 Android 5.0 (API level 21) 及以上版本
- 仅支持 IL2CPP
- 仅支持 ARM64
- Gradle 仅支持 7.0 以下(不包含 7.0)版本
- Gradle Build Tool 仅支持 4.2.0 到 7.0 之间(包含 4.2.0,不包含 7.0)版本,详见 Android Gradle 插件版本说明
- 导出 Android 工程后需要使用 KSSYOmniSDKTools 进行 SDK 初始化参数配置
Limitations
- API Compatibility 最低
.NET Standard 2.0
- 仅支持 IL2CPP
- 仅支持 ARM64
- 仅支持 Unity 2018.x 及以上版本
- 仅支持 Xcode >= 14.0
- 仅支持 iOS >= 12.0
- 不支持 iOS Simulator
- 需要在 Xcode 工程中按需拖入 XCFrameworks 组件
- 需要在 Xcode 工程中自行配置 SDK 初始化参数
Limitations
- API Compatibility 最低
.NET Standard 2.0
- Windows 分辨率最低支持
1024 x 768
- 支持 IL2CPP 和 Mono
- 仅支持 Unity 2018.x 及以上版本
Render
- 兼容
NGUI
- OmniSDK Prefab 内部使用的是 UGUI,Canvas 的
Render Mode
是Screen Space - Overlay
,会直接覆盖在屏幕最上层 - OmniSDK 的 UI 会屏蔽事件传递 (游戏侧无法捕获点击事件)
警告
如果接入方也使用的是 UGUI 且 Screen Space - Overlay
,建议将 OmniSDK Prefab 的 Sort Order
调整为最高 32767
Storage
Cache Config**
[Application.temporaryCachePath]/com.seayoo.omnisdk/*
User Info**
[PlayerPref]/omnisdk_*
Dependency
只依赖 com.unity.nuget.newtonsoft-json@3.0.2
Prefabs
信息
- 所有的 Prefab 会在关闭时调用
Destroy
, 不会长久保留在场景内 (也不会跨场景)
- SeayooToaster
- SeayooAlert
- SeayooAccount (世游通行证)
Package
OmniSDK
该目录包含 OmniSDK 对外接口、接口数据结构以及 Android、iOS、Windows 平台的接口实现文件
Editor
该目录内包含 Unity MenuItem
(例如创建 OmniSDK Settings 配置文件) 以及 Android 与 iOS 平台的 PostprocessBuild
文件
Plugins
该目录包含
OmniSDK Android 平台桥接代码
OmniSDK iOS 平台桥接代码
OmniSDK Windows 平台所需要的业务代码及资源文件 (Prefab 所挂载的 Script 也包含在 DLL 内)
DLL 组件描述 OmniSDK-Windows.dll OmniSDK Windows 核心功能 (包含 API) OmniSDK-Foundation.dll OmniSDK 基础功能库 (包含 SDK 内部常用的功能库) OmniSDK-SeayooAccount.dll 世游通行证
Demo
我们提供了一个示例 Demo 工程,供接入 OmniSDK Unity 的研发团队参考。
- 代码仓库:https://github.com/kingsoftgames/omnisdk-unity-demo
- 需要手动集成 OmniSDK 到 Demo 工程中,添加方式见:集成 SDK