简介这份资源是面向Unity开发者与手游客户端工程师的华为HMS SDK接入示例工程聚焦在Unity项目中集成华为账号、游戏服务与推送等能力时遇到的配置与调用问题适合已具备Unity基础、需要落地华为渠道适配的中级开发者参考。压缩包为rar格式共约2000个文件整体28.82MB其中bin、info、class、java、xml等构成Android侧工程与清单配置jar、dll、cs、meta对应SDK库文件、C#脚本与Unity资源元数据另有png、gif等界面素材和log、txt等运行记录完整保留了示例工程的原貌。资源已有1843人学习下载经过一定规模的实践检验。读者可直接获得可运行的HuaweiSdkDemo工程结构对照其中的初始化、登录与功能接口调用写法理解IL2CPP后端设置、权限声明与打包测试的完整链路并借助示例代码快速排查版本兼容与集成报错减少从零搭建的时间成本。1. 拿到一个 Unity 接华为 SDK 的 demo先别急着双击打开上周有个做休闲游戏的朋友甩给我一个压缩包说 Unity 里接华为 SDK 折腾了两天登录回调死活不触发问我能不能看看。我解压一看是个挺典型的接入 demoUnity 工程 一个 Android 原生模块 若干 jar/aar 依赖目录结构还算规整。这类资源对做安卓渠道发行的团队来说价值很直接——它把「Unity 侧怎么调、原生侧怎么回、清单怎么配」这条链路完整摆出来了省掉大量翻文档和试错的时间。但它不是那种解压即用的成品你得先搞清楚它依赖什么环境、哪些配置是占位符、哪些回调是异步的。这篇就按我实际拆包复现的顺序写从工程结构、环境准备、关键代码到踩坑排查适合已经会写 C#、但对 Android 原生交互不太熟的同学照着走一遍。2. 拆开 demo 看结构Unity 工程与原生模块是怎么拼起来的拿到任何跨平台接入 demo我第一件事不是打开 Unity而是用文件管理器把目录树过一遍。因为 Unity 和 Android 的边界在哪里决定了后面所有调试的入口。这个 demo 的骨架大致是三层Unity 的 Assets 层、Plugins/Android 下的原生层、以及 Gradle 构建配置层。三层各管各的混在一起看很容易晕。2.1 目录分层与各层职责我拆的这个包核心目录长这样不同版本命名会有出入但职责基本一致路径职责改动频率Assets/Scripts/C# 调用封装、回调分发高Assets/Plugins/Android/aar/jar、AndroidManifest.xml、res 资源中Assets/Plugins/Android/libs/华为 SDK 的 jar/aar 依赖低Assets/Plugins/Android/AndroidManifest.xml权限、Activity、meta-data 配置中原生模块源码目录若有Java/Kotlin 桥接层中这里最关键的一点Unity 打包 Android 时Plugins/Android下的内容会被原样塞进 APKAndroidManifest.xml会和 Unity 自动生成的清单做合并。所以你在 demo 里看到的清单不是最终清单最终清单是合并后的结果。很多人改了半天清单不生效就是因为没意识到合并规则——比如application节点的android:name冲突、activity的exported属性、meta-data的覆盖顺序都是合并阶段决定的。我一般会先确认两件事一是libs下到底有哪些依赖是不是缺了某个基础库二是清单里有没有application级别的自定义类。前者决定编译能不能过后者决定运行时初始化会不会被跳过。2.2 依赖清单与版本对齐华为 SDK 这类资源依赖通常不是一个 aar 打天下而是一组基础框架、账号、支付、推送各是各的。demo 里如果只放了账号相关的你接支付时就得自己补。我拆包时会先把libs下的文件名列出来对照官方文档的模块划分缺哪个补哪个。版本对齐是另一个高频翻车点。Unity 版本、Android Gradle Plugin 版本、SDK 的minSdkVersion/targetSdkVersion、以及 JDK 版本这四者要能凑到一起。常见做法是先看 demo 里build.gradle或mainTemplate.gradle写的compileSdkVersion和minSdkVersion再对照你本机 Unity 的 Android 支持范围。如果 demo 是给较老 Unity 版本做的你直接拿到新版 Unity 里打开Gradle 模板可能对不上报错往往出现在构建阶段而不是代码阶段。提示不要一上来就升级所有依赖。先把 demo 原样跑通一次确认链路是通的再逐个替换成你项目需要的版本。一次改一个变量出问题才知道是谁的锅。2.3 桥接层的两种写法Unity 调 Android 原生demo 里通常两种写法之一一种是纯AndroidJavaObject/AndroidJavaClass反射调用不写 Java 代码另一种是写一个 Java 桥接类Unity 通过AndroidJavaClass拿到它再由它去调 SDK。前者上手快但难维护后者多一层但边界清晰。我偏好后者原因很实际SDK 的初始化、登录、回调这些逻辑放在 Java 层出问题可以用 Android Studio 的 Logcat 直接看堆栈如果全塞在 C# 里反射异常信息会被吞掉大半排查起来像开盲盒。demo 如果用的是纯反射写法我一般会建议至少把初始化和回调注册抽到 Java 层。3. 环境准备与工程导入把 demo 跑起来的最小闭环结构看明白了下一步是让它在你机器上编译通过。这一步的目标不是功能全通而是「能打出 APK 并装上」。很多接入问题其实卡在环境不在代码。3.1 Unity 侧环境与 Android 构建支持先确认 Unity 装了 Android Build Support包括 SDK、NDK、OpenJDK 三件套。Unity Hub 里可以勾选安装也可以用本机已有的。我一般用 Unity 自带的省得版本对不上。然后在Edit Preferences External Tools里确认 JDK、SDK、NDK 路径都指向有效目录。接着看Player Settings里几个关键项Package Name必须改成你自己的demo 里的占位包名直接打包可能和已安装应用冲突。Minimum API Level不能低于 SDK 要求的下限常见是 21 或 23 起步具体看依赖。Target API Level建议对齐当前主流太低会在新系统上有兼容问题。Scripting Backend选 IL2CPPARM64 勾上。华为渠道对 64 位有要求这个别省。改完这些先做一次空场景构建确认能出包。这一步能过说明环境没问题后面报错就大概率是代码或配置。3.2 清单合并与权限配置AndroidManifest.xml是接入里最容易出玄学的地方。demo 给的清单通常包含权限声明、application节点、以及 SDK 需要的activity或meta-data。你要做的是把它和 Unity 的模板对齐而不是直接覆盖。常见做法是把 demo 清单里的必要节点摘出来合并进Plugins/Android/AndroidManifest.xml。重点看这几类!-- 权限按 SDK 实际需要保留不要照抄全部 -- uses-permission android:nameandroid.permission.INTERNET / uses-permission android:nameandroid.permission.ACCESS_NETWORK_STATE / application !-- 如果 SDK 要求自定义 Application这里要写全类名 -- meta-data android:namecom.example.sdk.APP_ID android:value你的应用标识 / /application上面这段是示意实际字段名以你拿到的 demo 为准。逻辑说明uses-permission决定运行时能不能拿到对应能力缺了会在调用时静默失败或抛安全异常meta-data是 SDK 初始化时读取的配置值写错或键名拼错初始化会直接返回失败但不一定报错。参数上android:value里的应用标识是占位符必须换成你在开发者后台登记的值这个值通常和包名、签名绑定换包名要同步换。注意清单合并冲突时构建会报Manifest merger failed日志里会指出哪个属性冲突。别急着加tools:replace先想清楚哪个值才是对的盲目替换可能把 SDK 需要的配置覆盖掉。3.3 首次构建与安装验证环境就绪后用Build And Run打真机。第一次跑我只看三件事应用能不能启动、Logcat 里有没有 SDK 初始化的日志、有没有明显的ClassNotFoundException或NoSuchMethodError。如果启动就崩优先看adb logcat里的AndroidRuntime段。ClassNotFoundException多半是依赖没打进包检查libs是否被正确识别NoSuchMethodError多半是版本不匹配调用的方法在旧版依赖里不存在。这两类错误在接入初期占比很高先把它们清掉再谈功能。4. 核心调用链初始化、登录与回调的代码落地环境通了进入正题。这一章按调用顺序拆先初始化再登录最后处理回调。每一步我都给出可抄的骨架并说明参数和失败时的观察点。4.1 初始化时机与线程SDK 初始化一般要在应用启动后尽早做但不宜在Awake里同步阻塞。常见做法是在第一个场景的启动脚本里发起用回调确认结果。using UnityEngine; public class SdkBootstrap : MonoBehaviour { private AndroidJavaClass _bridge; void Start() { // 拿到 Java 桥接类类名以 demo 实际为准 _bridge new AndroidJavaClass(com.example.bridge.SdkBridge); // 传入当前 Activity 上下文很多 SDK 初始化需要 using (var activity new AndroidJavaClass(com.unity3d.player.UnityPlayer) .GetStaticAndroidJavaObject(currentActivity)) { _bridge.CallStatic(init, activity, 你的应用标识); } } // 由 Java 层通过 UnityPlayer.UnitySendMessage 回调 public void OnInitResult(string result) { Debug.Log($SDK init result: {result}); } }逻辑说明AndroidJavaClass是反射入口类名必须和 Java 侧完全一致包名错一个字母就是ClassNotFoundException。currentActivity是 Unity 播放器的 Activity 实例SDK 初始化常需要它来注册生命周期回调。CallStatic调的是 Java 静态方法参数类型要匹配传string对应 Java 的String传AndroidJavaObject对应对象引用。参数上应用标识是占位符换成后台登记值如果 SDK 还要求传渠道号或回调对象按 demo 的方法签名补。失败时看 Logcat 里 Java 层的异常堆栈C# 侧只能拿到一个笼统的失败结果真正的错误在原生侧。4.2 登录调用与结果回传登录是异步的调用后不能立刻拿结果。demo 里通常用两种回传方式UnitySendMessage或注册一个 Java 回调接口。前者简单后者灵活。public void Login() { // 触发登录结果通过 OnLoginResult 回传 _bridge.CallStatic(login); } public void OnLoginResult(string json) { // json 里通常包含状态码、用户标识、令牌等字段 Debug.Log($login callback: {json}); // 解析后做业务处理注意在主线程更新 UI }逻辑说明login是发起动作真正的结果在OnLoginResult里。UnitySendMessage的机制是 Java 层按「GameObject 名 方法名」找到 C# 对象并调用所以 GameObject 名和方法名必须严格匹配大小写都不能错。参数是一个字符串复杂数据一般序列化成 JSON 传过来。这里有个容易忽略的点回调可能在非主线程触发直接在里面改 UI 会崩。稳妥做法是把结果存下来在Update里消费或者用主线程调度器切回去。另外登录回调可能多次触发比如用户取消后重试业务侧要做幂等别一收到就重复发奖励。4.3 回调注册与生命周期对齐如果 demo 用的是接口回调而不是UnitySendMessage那就要在 Java 层注册一个实现类把结果转发回 Unity。这种写法在需要连续回调支付、推送时更稳。// Java 桥接层示意 public class SdkBridge { public static void login() { SdkApi.login(new LoginCallback() { Override public void onResult(String json) { // 转发到 UnityGameObject 名与方法名要和 C# 侧一致 UnityPlayer.UnitySendMessage(SdkManager, OnLoginResult, json); } }); } }逻辑说明匿名内部类实现 SDK 的回调接口在回调里调UnitySendMessage。SdkManager是场景里挂载接收脚本的 GameObject 名OnLoginResult是它的公开方法。这两个名字是硬约定改一处就要同步改另一处。生命周期对齐是另一个坑如果接收回调的 GameObject 在场景切换时被销毁回调就丢了。常见做法是把接收脚本挂在DontDestroyOnLoad的对象上或者用单例管理。SDK 的初始化、登录状态也要跟着应用生命周期走别在OnDestroy之后还期待回调。5. 避坑与排查五条血泪经验接入过程里真正耗时间的往往不是写代码而是那些「看起来该通却没通」的问题。下面五条是我和周围人反复踩过的按现象、原因、解决写清楚。5.1 登录回调不触发现象点了登录界面没反应Logcat 里也没有回调日志。原因通常是三选一UnitySendMessage的 GameObject 名或方法名拼错接收对象在回调前被销毁Java 层回调根本没注册成功。解决先在 Java 回调里打一行日志确认原生侧收到了结果再核对 Unity 侧名字最后确认接收对象常驻。三步能定位到具体哪一环断的。5.2 构建报清单合并失败现象Manifest merger failed提示某属性冲突。原因demo 清单和 Unity 模板对同一节点写了不同值比如application的android:name或activity的exported。解决看合并报告里指出的具体属性判断哪个值是对的用tools:replace只替换必要属性别整节点覆盖。改完重新构建确认报告里没有残留冲突。5.3 真机报 ClassNotFoundException现象启动即崩日志指向某个 SDK 类找不到。原因依赖没打进 APK常见于 aar 放错目录、或 Gradle 没识别到libs。解决确认 aar/jar 在Plugins/Android/libs下检查构建后的 APK 里有没有对应类可用解包工具看classes.dex。如果是 Gradle 依赖方式引入确认仓库地址和坐标写对。5.4 初始化成功但功能调用失败现象初始化日志正常调登录或支付却返回错误码。原因多半是应用标识、签名、包名三者不一致后台校验不通过。解决核对后台登记信息和当前构建配置签名要用正式签名调试debug 签名常被拒。错误码要对照文档查别猜。5.5 回调线程导致的偶发崩溃现象功能时好时坏崩溃堆栈指向 UI 操作。原因回调在非主线程触发直接改了 Unity 对象。解决回调里只做数据落地UI 更新切回主线程或者统一用消息队列消费。这类问题复现不稳定日志里加线程标识能帮助定位。6. 进阶把 demo 改造成可维护的接入层demo 跑通只是起点真正上线前得把它变成项目里能长期维护的一层。我的做法是加一个薄封装C# 侧定义统一接口Java 侧按 SDK 分模块回调统一走一个分发器。这样换渠道或升级 SDK 时改动被限制在桥接层业务代码不动。具体来说C# 侧建一个ISdkService接口声明Init、Login、Pay等方法实现类内部持有AndroidJavaClass。回调统一注册到一个SdkCallbackDispatcher按消息类型分发业务侧只订阅自己关心的类型。Java 侧把初始化和各功能拆成独立类共用同一个UnitySendMessage出口。验证方法上我习惯做两轮第一轮在编辑器里用 mock 实现跑业务逻辑确认回调分发和幂等没问题第二轮真机跑全链路重点看弱网、取消操作、重复点击这三种场景。弱网下回调可能延迟或丢失取消操作要能回到初始态重复点击要防重入。验证场景观察点通过标准弱网登录回调延迟、超时提示有明确失败反馈可重试用户取消状态是否复位可再次发起无残留状态重复点击是否重复回调只处理一次无重复发奖从那以后我每次接新渠道 SDK都强制先跑一遍「空工程 最小调用」的闭环确认初始化、一次成功回调、一次失败回调都正常再往业务里接。这个习惯帮我省掉了不少上线前夜的返工。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/2 11:23:55 · 阅读 1.2k Unity接入华为SDK实战：从Demo拆解到可维护接入层
简介这份资源是面向Unity开发者与手游客户端工程师的华为HMS SDK接入示例工程聚焦在Unity项目中集成华为账号、游戏服务与推送等能力时遇到的配置与调用问题适合已具备Unity基础、需要落地华为渠道适配的中级开发者参考。压缩包为rar格式共约2000个文件整体28.82MB其中bin、info、class、java、xml等构成Android侧工程与清单配置jar、dll、cs、meta对应SDK库文件、C#脚本与Unity资源元数据另有png、gif等界面素材和log、txt等运行记录完整保留了示例工程的原貌。资源已有1843人学习下载经过一定规模的实践检验。读者可直接获得可运行的HuaweiSdkDemo工程结构对照其中的初始化、登录与功能接口调用写法理解IL2CPP后端设置、权限声明与打包测试的完整链路并借助示例代码快速排查版本兼容与集成报错减少从零搭建的时间成本。1. 拿到一个 Unity 接华为 SDK 的 demo先别急着双击打开上周有个做休闲游戏的朋友甩给我一个压缩包说 Unity 里接华为 SDK 折腾了两天登录回调死活不触发问我能不能看看。我解压一看是个挺典型的接入 demoUnity 工程 一个 Android 原生模块 若干 jar/aar 依赖目录结构还算规整。这类资源对做安卓渠道发行的团队来说价值很直接——它把「Unity 侧怎么调、原生侧怎么回、清单怎么配」这条链路完整摆出来了省掉大量翻文档和试错的时间。但它不是那种解压即用的成品你得先搞清楚它依赖什么环境、哪些配置是占位符、哪些回调是异步的。这篇就按我实际拆包复现的顺序写从工程结构、环境准备、关键代码到踩坑排查适合已经会写 C#、但对 Android 原生交互不太熟的同学照着走一遍。2. 拆开 demo 看结构Unity 工程与原生模块是怎么拼起来的拿到任何跨平台接入 demo我第一件事不是打开 Unity而是用文件管理器把目录树过一遍。因为 Unity 和 Android 的边界在哪里决定了后面所有调试的入口。这个 demo 的骨架大致是三层Unity 的 Assets 层、Plugins/Android 下的原生层、以及 Gradle 构建配置层。三层各管各的混在一起看很容易晕。2.1 目录分层与各层职责我拆的这个包核心目录长这样不同版本命名会有出入但职责基本一致路径职责改动频率Assets/Scripts/C# 调用封装、回调分发高Assets/Plugins/Android/aar/jar、AndroidManifest.xml、res 资源中Assets/Plugins/Android/libs/华为 SDK 的 jar/aar 依赖低Assets/Plugins/Android/AndroidManifest.xml权限、Activity、meta-data 配置中原生模块源码目录若有Java/Kotlin 桥接层中这里最关键的一点Unity 打包 Android 时Plugins/Android下的内容会被原样塞进 APKAndroidManifest.xml会和 Unity 自动生成的清单做合并。所以你在 demo 里看到的清单不是最终清单最终清单是合并后的结果。很多人改了半天清单不生效就是因为没意识到合并规则——比如application节点的android:name冲突、activity的exported属性、meta-data的覆盖顺序都是合并阶段决定的。我一般会先确认两件事一是libs下到底有哪些依赖是不是缺了某个基础库二是清单里有没有application级别的自定义类。前者决定编译能不能过后者决定运行时初始化会不会被跳过。2.2 依赖清单与版本对齐华为 SDK 这类资源依赖通常不是一个 aar 打天下而是一组基础框架、账号、支付、推送各是各的。demo 里如果只放了账号相关的你接支付时就得自己补。我拆包时会先把libs下的文件名列出来对照官方文档的模块划分缺哪个补哪个。版本对齐是另一个高频翻车点。Unity 版本、Android Gradle Plugin 版本、SDK 的minSdkVersion/targetSdkVersion、以及 JDK 版本这四者要能凑到一起。常见做法是先看 demo 里build.gradle或mainTemplate.gradle写的compileSdkVersion和minSdkVersion再对照你本机 Unity 的 Android 支持范围。如果 demo 是给较老 Unity 版本做的你直接拿到新版 Unity 里打开Gradle 模板可能对不上报错往往出现在构建阶段而不是代码阶段。提示不要一上来就升级所有依赖。先把 demo 原样跑通一次确认链路是通的再逐个替换成你项目需要的版本。一次改一个变量出问题才知道是谁的锅。2.3 桥接层的两种写法Unity 调 Android 原生demo 里通常两种写法之一一种是纯AndroidJavaObject/AndroidJavaClass反射调用不写 Java 代码另一种是写一个 Java 桥接类Unity 通过AndroidJavaClass拿到它再由它去调 SDK。前者上手快但难维护后者多一层但边界清晰。我偏好后者原因很实际SDK 的初始化、登录、回调这些逻辑放在 Java 层出问题可以用 Android Studio 的 Logcat 直接看堆栈如果全塞在 C# 里反射异常信息会被吞掉大半排查起来像开盲盒。demo 如果用的是纯反射写法我一般会建议至少把初始化和回调注册抽到 Java 层。3. 环境准备与工程导入把 demo 跑起来的最小闭环结构看明白了下一步是让它在你机器上编译通过。这一步的目标不是功能全通而是「能打出 APK 并装上」。很多接入问题其实卡在环境不在代码。3.1 Unity 侧环境与 Android 构建支持先确认 Unity 装了 Android Build Support包括 SDK、NDK、OpenJDK 三件套。Unity Hub 里可以勾选安装也可以用本机已有的。我一般用 Unity 自带的省得版本对不上。然后在Edit Preferences External Tools里确认 JDK、SDK、NDK 路径都指向有效目录。接着看Player Settings里几个关键项Package Name必须改成你自己的demo 里的占位包名直接打包可能和已安装应用冲突。Minimum API Level不能低于 SDK 要求的下限常见是 21 或 23 起步具体看依赖。Target API Level建议对齐当前主流太低会在新系统上有兼容问题。Scripting Backend选 IL2CPPARM64 勾上。华为渠道对 64 位有要求这个别省。改完这些先做一次空场景构建确认能出包。这一步能过说明环境没问题后面报错就大概率是代码或配置。3.2 清单合并与权限配置AndroidManifest.xml是接入里最容易出玄学的地方。demo 给的清单通常包含权限声明、application节点、以及 SDK 需要的activity或meta-data。你要做的是把它和 Unity 的模板对齐而不是直接覆盖。常见做法是把 demo 清单里的必要节点摘出来合并进Plugins/Android/AndroidManifest.xml。重点看这几类!-- 权限按 SDK 实际需要保留不要照抄全部 -- uses-permission android:nameandroid.permission.INTERNET / uses-permission android:nameandroid.permission.ACCESS_NETWORK_STATE / application !-- 如果 SDK 要求自定义 Application这里要写全类名 -- meta-data android:namecom.example.sdk.APP_ID android:value你的应用标识 / /application上面这段是示意实际字段名以你拿到的 demo 为准。逻辑说明uses-permission决定运行时能不能拿到对应能力缺了会在调用时静默失败或抛安全异常meta-data是 SDK 初始化时读取的配置值写错或键名拼错初始化会直接返回失败但不一定报错。参数上android:value里的应用标识是占位符必须换成你在开发者后台登记的值这个值通常和包名、签名绑定换包名要同步换。注意清单合并冲突时构建会报Manifest merger failed日志里会指出哪个属性冲突。别急着加tools:replace先想清楚哪个值才是对的盲目替换可能把 SDK 需要的配置覆盖掉。3.3 首次构建与安装验证环境就绪后用Build And Run打真机。第一次跑我只看三件事应用能不能启动、Logcat 里有没有 SDK 初始化的日志、有没有明显的ClassNotFoundException或NoSuchMethodError。如果启动就崩优先看adb logcat里的AndroidRuntime段。ClassNotFoundException多半是依赖没打进包检查libs是否被正确识别NoSuchMethodError多半是版本不匹配调用的方法在旧版依赖里不存在。这两类错误在接入初期占比很高先把它们清掉再谈功能。4. 核心调用链初始化、登录与回调的代码落地环境通了进入正题。这一章按调用顺序拆先初始化再登录最后处理回调。每一步我都给出可抄的骨架并说明参数和失败时的观察点。4.1 初始化时机与线程SDK 初始化一般要在应用启动后尽早做但不宜在Awake里同步阻塞。常见做法是在第一个场景的启动脚本里发起用回调确认结果。using UnityEngine; public class SdkBootstrap : MonoBehaviour { private AndroidJavaClass _bridge; void Start() { // 拿到 Java 桥接类类名以 demo 实际为准 _bridge new AndroidJavaClass(com.example.bridge.SdkBridge); // 传入当前 Activity 上下文很多 SDK 初始化需要 using (var activity new AndroidJavaClass(com.unity3d.player.UnityPlayer) .GetStaticAndroidJavaObject(currentActivity)) { _bridge.CallStatic(init, activity, 你的应用标识); } } // 由 Java 层通过 UnityPlayer.UnitySendMessage 回调 public void OnInitResult(string result) { Debug.Log($SDK init result: {result}); } }逻辑说明AndroidJavaClass是反射入口类名必须和 Java 侧完全一致包名错一个字母就是ClassNotFoundException。currentActivity是 Unity 播放器的 Activity 实例SDK 初始化常需要它来注册生命周期回调。CallStatic调的是 Java 静态方法参数类型要匹配传string对应 Java 的String传AndroidJavaObject对应对象引用。参数上应用标识是占位符换成后台登记值如果 SDK 还要求传渠道号或回调对象按 demo 的方法签名补。失败时看 Logcat 里 Java 层的异常堆栈C# 侧只能拿到一个笼统的失败结果真正的错误在原生侧。4.2 登录调用与结果回传登录是异步的调用后不能立刻拿结果。demo 里通常用两种回传方式UnitySendMessage或注册一个 Java 回调接口。前者简单后者灵活。public void Login() { // 触发登录结果通过 OnLoginResult 回传 _bridge.CallStatic(login); } public void OnLoginResult(string json) { // json 里通常包含状态码、用户标识、令牌等字段 Debug.Log($login callback: {json}); // 解析后做业务处理注意在主线程更新 UI }逻辑说明login是发起动作真正的结果在OnLoginResult里。UnitySendMessage的机制是 Java 层按「GameObject 名 方法名」找到 C# 对象并调用所以 GameObject 名和方法名必须严格匹配大小写都不能错。参数是一个字符串复杂数据一般序列化成 JSON 传过来。这里有个容易忽略的点回调可能在非主线程触发直接在里面改 UI 会崩。稳妥做法是把结果存下来在Update里消费或者用主线程调度器切回去。另外登录回调可能多次触发比如用户取消后重试业务侧要做幂等别一收到就重复发奖励。4.3 回调注册与生命周期对齐如果 demo 用的是接口回调而不是UnitySendMessage那就要在 Java 层注册一个实现类把结果转发回 Unity。这种写法在需要连续回调支付、推送时更稳。// Java 桥接层示意 public class SdkBridge { public static void login() { SdkApi.login(new LoginCallback() { Override public void onResult(String json) { // 转发到 UnityGameObject 名与方法名要和 C# 侧一致 UnityPlayer.UnitySendMessage(SdkManager, OnLoginResult, json); } }); } }逻辑说明匿名内部类实现 SDK 的回调接口在回调里调UnitySendMessage。SdkManager是场景里挂载接收脚本的 GameObject 名OnLoginResult是它的公开方法。这两个名字是硬约定改一处就要同步改另一处。生命周期对齐是另一个坑如果接收回调的 GameObject 在场景切换时被销毁回调就丢了。常见做法是把接收脚本挂在DontDestroyOnLoad的对象上或者用单例管理。SDK 的初始化、登录状态也要跟着应用生命周期走别在OnDestroy之后还期待回调。5. 避坑与排查五条血泪经验接入过程里真正耗时间的往往不是写代码而是那些「看起来该通却没通」的问题。下面五条是我和周围人反复踩过的按现象、原因、解决写清楚。5.1 登录回调不触发现象点了登录界面没反应Logcat 里也没有回调日志。原因通常是三选一UnitySendMessage的 GameObject 名或方法名拼错接收对象在回调前被销毁Java 层回调根本没注册成功。解决先在 Java 回调里打一行日志确认原生侧收到了结果再核对 Unity 侧名字最后确认接收对象常驻。三步能定位到具体哪一环断的。5.2 构建报清单合并失败现象Manifest merger failed提示某属性冲突。原因demo 清单和 Unity 模板对同一节点写了不同值比如application的android:name或activity的exported。解决看合并报告里指出的具体属性判断哪个值是对的用tools:replace只替换必要属性别整节点覆盖。改完重新构建确认报告里没有残留冲突。5.3 真机报 ClassNotFoundException现象启动即崩日志指向某个 SDK 类找不到。原因依赖没打进 APK常见于 aar 放错目录、或 Gradle 没识别到libs。解决确认 aar/jar 在Plugins/Android/libs下检查构建后的 APK 里有没有对应类可用解包工具看classes.dex。如果是 Gradle 依赖方式引入确认仓库地址和坐标写对。5.4 初始化成功但功能调用失败现象初始化日志正常调登录或支付却返回错误码。原因多半是应用标识、签名、包名三者不一致后台校验不通过。解决核对后台登记信息和当前构建配置签名要用正式签名调试debug 签名常被拒。错误码要对照文档查别猜。5.5 回调线程导致的偶发崩溃现象功能时好时坏崩溃堆栈指向 UI 操作。原因回调在非主线程触发直接改了 Unity 对象。解决回调里只做数据落地UI 更新切回主线程或者统一用消息队列消费。这类问题复现不稳定日志里加线程标识能帮助定位。6. 进阶把 demo 改造成可维护的接入层demo 跑通只是起点真正上线前得把它变成项目里能长期维护的一层。我的做法是加一个薄封装C# 侧定义统一接口Java 侧按 SDK 分模块回调统一走一个分发器。这样换渠道或升级 SDK 时改动被限制在桥接层业务代码不动。具体来说C# 侧建一个ISdkService接口声明Init、Login、Pay等方法实现类内部持有AndroidJavaClass。回调统一注册到一个SdkCallbackDispatcher按消息类型分发业务侧只订阅自己关心的类型。Java 侧把初始化和各功能拆成独立类共用同一个UnitySendMessage出口。验证方法上我习惯做两轮第一轮在编辑器里用 mock 实现跑业务逻辑确认回调分发和幂等没问题第二轮真机跑全链路重点看弱网、取消操作、重复点击这三种场景。弱网下回调可能延迟或丢失取消操作要能回到初始态重复点击要防重入。验证场景观察点通过标准弱网登录回调延迟、超时提示有明确失败反馈可重试用户取消状态是否复位可再次发起无残留状态重复点击是否重复回调只处理一次无重复发奖从那以后我每次接新渠道 SDK都强制先跑一遍「空工程 最小调用」的闭环确认初始化、一次成功回调、一次失败回调都正常再往业务里接。这个习惯帮我省掉了不少上线前夜的返工。希望帮到你。本文还有配套的精品资源点击获取