即时通信 IM Unity（跑通 Demo）

一、前置准备（控制台）

跑通 Demo 前，请先在腾讯云控制台完成账号与厂商通道准备：

1. 创建应用：登录即时通信 IM 控制台，在应用列表单击创建应用接入，记录生成的 SDKAppID。

2. 获取密钥：进入目标应用的应用配置，单击查看密钥，拷贝并妥善保管 SDKAppID 与客户端密钥 AppKey。

注意：推送服务的客户端密钥与 Chat 的密钥不同，请勿混用。密钥属于敏感信息，请勿提交到代码仓库。

3. 开通推送并配置厂商通道：在控制台推送服务页开通推送能力，按需配置 Android 厂商通道（小米 / 华为 / 荣耀 / OPPO / vivo / 魅族 / FCM）与 iOS APNs 通道，下载 timpush-configs.json 及各厂商服务配置文件，并记录 APNs 证书 ID。

二、环境要求

项目	要求
引擎	已安装 Unity，并配置好 Android / iOS 构建环境。
测试设备	Android 或 iOS 真机（Editor 无法验证推送，必须真机运行）。

三、工程结构

unity/pushdemo/├── Assets/│ ├── TIMPush/ # TIMPush SDK 源码（PushManager / 各平台实现）│ ├── TIMPushExample/ # Demo 场景（Assets/Scenes/PushDemo.unity）与脚本（PushTest.cs）│ └── Plugins/ # Android gradle 模板、iOS UnityIMPush.mm├── Packages/└── ProjectSettings/

四、步骤 1：打开工程与场景

用 Unity 打开 unity/pushdemo/ 目录，打开场景 Assets/TIMPushExample/Assets/Scenes/PushDemo.unity。TIMPush SDK 已以源码形式集成在 Assets/TIMPush/ 下，无需额外导入。

五、步骤 2：填写 SDKAppID 与 AppKey

两种方式二选一：

·运行 Demo 后，在界面输入框中直接填入 SDKAppID 与 AppKey；

·或修改场景中输入框的默认值。

PushTest.cs 中将读取输入值并调用：

PushManager.RegisterPush(sdkAppId, appKey, new PushCallback(onSuccess, onError));

六、步骤 3：配置 Android 端

1. 在 Assets/Plugins/Android/launcherTemplate.gradle 中启用所需厂商通道（小米 / 华为 / 荣耀 / OPPO / vivo / 魅族 / FCM）。

2. 在 baseProjectTemplate.gradle 与 settingsTemplate.gradle 中添加厂商 classpath / repositories，并填写荣耀 / vivo 的 APPID / APPKEY。

3. 放置配置文件：

·timpush-configs.json → Assets/Plugins/Android/；

·华为 / 荣耀 / FCM 的 json 配置文件 → Assets/Plugins/Android/JsonConfigs/。

4. 在Player Settings > Publishing Settings > Build 中勾选 Custom Main Gradle Template、Custom Base Gradle Template、Custom Gradle Settings Template。

七、步骤 4：配置 iOS 端

1. 在 Assets/Plugins/iOS/UnityIMPush.mm 中实现 businessID（控制台 APNs 证书 ID）与 applicationGroupID。

2. 导出 Xcode 工程后，开启 Push Notifications 能力。

3. 如需触达统计，可配置 Notification Service Extension（可选）。

八、步骤 5：运行验证

构建到真机并运行。注册成功后 Demo 界面显示 RegistrationID；将 App 切至后台，通过控制台推送服务 Push > 接入测试发送一条测试推送，设备收到推送即代表全链路跑通。

九、注意事项

·IM 登录态复用：若已集成 IM 并在 IM 登录成功后调用 RegisterPush，请将 appKey 传 null，否则会把 IM 账号踢下线。

·监听注册时机：AddPushListener 请在程序入口处调用，回调包括 onRecvPushMessage / onRevokePushMessage / onNotificationClicked。

·通知点击跳转：如需点击通知跳转到指定页面，控制台厂商证书的点击后续动作请选择打开应用内指定界面并保持默认填充值不修改。

·触达统计（可选）：华为 / 荣耀 / vivo / 魅族需配置对应回执地址；FCM 暂不支持推送统计。华为推送证书 ID 小于等于 11344 时使用 v2 接口，不支持触达与点击回执，需重新生成并更新证书 ID。

十、常见问题

·Android 构建失败：确认三个 Custom Gradle Template 均已勾选，且模板中的厂商仓库 / classpath 配置完整。

·收不到推送：确认真机厂商与目标厂商通道一致；使用控制台推送排查工具输入 RegistrationID 自查，并按错误码查询失败回调含义。

十一、相关文档

·Unity SDK 接入

·厂商配置索引

·推送排查工具