Unity

下载
聚焦模式
字号
最后更新时间： 2026-09-21 12:55:27
前提条件
开始接入前，请先完成对应原生平台的推送前提配置：请参见 iOS 前提条件 和 Android 前提条件。
操作步骤
步骤1：集成消息推送插件
完成各原生平台厂商配置后集成推送插件，需调整 Packages/manifest.json 文件，添加相关依赖：
{
  "dependencies": {
    ...
    "com.tencent.timpush.unity": "https://github.com/TencentCloud/TIMSDK.git#push_unity"
  }
}
步骤2：推送参数配置
iOS
Android
请将您在 厂商配置 步骤中，获取到的 iOS APNs 推送证书， 上传至腾讯云 控制台。控制台会为您分配一个证书 ID，见下图：
﻿
您需要在 Assets/Plugins/iOS 目录下创建文件 UnityIMPush.mm（若目录不存在，需要手动创建），并且在文件中实现 businessID 协议方法返回证书 ID 即可，可以参考如下实现：
#import "TPush/TPush.h"
#import "UnityAppController.h"
﻿
@interface UnityAppController (ThirdPartyExtension) <TIMPushDelegate>
- (int)businessID;
﻿
- (NSString *)applicationGroupID;
@end
﻿
@implementation UnityAppController (ThirdPartyExtension)
﻿
#pragma mark - TIMPush
- (int)businessID {
    //上一步控制台给的证书ID，如 1234567
    int  kBusinessID = 1234567;
    return kBusinessID;
}
﻿
- (NSString *)applicationGroupID {
    //AppGroup ID
    return "AppGroup ID";
}
﻿
- (BOOL)onRemoteNotificationReceived:(NSString *)notice {
    // custom navigate
    return NO;
} 
@end
完成 厂商配置 后，下载并添加配置文件到工程。将下载的 timpush-configs.json 文件添加到项目的 Assets/Plugins/Android 目录下，如果该目录不存在，请手动创建。
﻿
步骤3：客户端厂商配置
iOS
Android
iOS 端无需进行此步骤。
可以按照 File > Build Settings > Player Settings 然后在安卓平台的设置中找到 Publishing Settings > Build，勾选下方的三个配置：
﻿
找到 Assets/Plugins/Android/launcherTemplate.gradle 文件，在文件最后新增 dependencies 配置，并根据需要，引入下列全部或部分厂商的推送包。只有引入对应厂商的推送包，才能启用该厂商的原生推送能力。
dependencies {
     // 版本号 “VERSION” 请前往 更新日志 中获取配置。
     // 推送主包必须要集成
     implementation 'com.tencent.timpush:tpush:VERSION'
     // 其他依赖包
     implementation 'androidx.appcompat:appcompat:1.3.0'
     implementation 'com.google.code.gson:gson:2.10.1'
     // 按照需要集成对应厂商
     implementation 'com.tencent.timpush:fcm:VERSION'
}
Google FCM 适配
按照厂商方法，集成对应的 plugin 和 json 配置文件。
1.1 下载配置文件添加到工程根目录 Assets/Plugins/Android/JsonConfigs 目录下，该目录需要手动创建。
Google FCM
配置文件下载位置:
﻿
﻿
﻿
配置文件的放置位置如下所示:
﻿
1.2 在 Assets/Plugins/Android/baseProjectTemplate.gradle 文件中 buildscript > dependencies 下添加以下配置（如果是需要新增 buildscript 建议放在文件最上面）：
Gradle 7.1 及以上版本
Gradle 7.0 版本
Gradle 7.0 以下版本
在 Assets/Plugins/Android/baseProjectTemplate.gradle 文件中 buildscript > dependencies 下添加以下配置：
buildscript {
    dependencies {
        ...
        classpath 'com.google.gms:google-services:4.3.15'
    }
}
在 Assets/Plugins/Android/settingsTemplate.gradle 文件中 buildscript > repositories 和 allprojects > repositories 下添加以下仓库配置：
pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
}
dependencyResolutionManagement {
    ...
    repositories {
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
}
在 Assets/Plugins/Android/baseProjectTemplate.gradle 文件中 buildscript 下添加以下配置：
buildscript {
    repositories {
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
    dependencies {
        ...
        classpath 'com.google.gms:google-services:4.2.0'
    }
}
在 Assets/Plugins/Android/settingsTemplate.gradle 文件中 allprojects > repositories 下添加以下仓库配置：
allprojects {
    ...
    repositories {
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
}
在项目级 build.gradle 文件中 buildscript 和 allprojects 下添加以下配置：
buildscript {
    repositories {
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
    dependencies {
        ...
        classpath 'com.google.gms:google-services:4.2.0'
    }
}
﻿
allprojects {
    repositories {
        mavenCentral()
        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
    }
}
1.3 在 Assets/Plugins/Android/launcherTemplate.gradle 文件中添加下方配置：
apply plugin: 'com.google.gms.google-services'
步骤4：处理消息点击回调，并解析参数
如果您需要自定义解析收到的远程推送，您可按照如下方法实现：
注意：
1. 注册回调时机必须放在程序入口函数中。
2. 控制台中点击后续动作的配置请按如下方式处理，选择打开应用内指定界面，请勿修改使用默认值。
﻿
PushListener listener = new PushListener(onRecvPushMessage: (message) => {
  Debug.Log($"收到推送消息: 标题:{message.title}, 内容:{message.desc}, 透传内容:{message.ext}, 消息 ID:{message.messageID}");
}, onRevokePushMessage: (messageID) => {
  Debug.Log($"撤销推送消息 ID: {messageID}");
}, onNotificationClicked: (ext) => {
  Debug.Log($"点击推送消息: {ext}");
});
﻿
PushManager.AddPushListener(listener);
步骤5：注册推送插件
调用 PushManager.RegisterPush 方法成功后，就可以收到离线推送通知了。
注意：
如果您已经集成 Chat 产品并在 Chat 登录成功后调用该接口，请将 appKey 参数设置为 null，否则会将 Chat 账号下线。
PushManager.RegisterPush(sdkAppId: 您的sdkAppId, appKey: "客户端密钥", new PushCallback(onSuccess: (data) => {
  Debug.Log($"注册推送成功: {data}");
}, onError: (errCode, errMsg, data) => {
  Debug.Log($"注册推送失败: 错误码:{errCode}, 错误信息:{errMsg}");
}));
步骤6：消息推送触达统计
Google FCM 暂不支持推送统计功能。
接入排查
如果接入完成收不到推送，请使用 排查工具 查看具体原因。排查后依然异常，请 联系我们 提交反馈。