tencent cloud

文档反馈

快速接入

最后更新时间:2025-01-02 11:38:44

    效果展示

    小米 11 Pro(与 CallKit 融合)
    
    
    
    iPhone 13
    
    
    
    三星 Galaxy A23 海外版(Google FCM 推送)
    
    
    

    集成 TencentCloud-Push

    HBuilderX 4.29 有 bug,请使用 HBuilderX 4.36 或更高版本,并升级 uni-app 腾讯云推送服务(Push)到 1.1.0 或更高版本。

    步骤1:下载插件并导入 HBuilderX

    1. 打开 uni-app 腾讯云推送服务(Push) ,单击下载插件并导入HBuilderX,将插件导入 HBuilderX 工程中。
    
    2. 选择需要集成的工程并单击确定
    
    3. 集成后效果如下图所示:
    

    步骤2:离线推送配置

    说明:
    1. HBuilderX 4.36 发布了不向下兼容的更新,如果您使用的是 HBuilderX 4.36 或者更高版本,且需要 vivo/荣耀 的厂商推送,请升级推送版本到 1.1.0 或更高版本,并参考文档正确配置 manifestPlaceholders.jsonmcs-services.json
    2. 您需在 nativeResources 目录下进行推送配置。若项目根目录尚未创建该文件夹,请新建一个名为 nativeResources 的文件夹。
    3. 确保您用 HBuilderX 打开的项目中 nativeResources 目录存在,且与 uni_modules 目录平级。
    Android
    iOS
    1. 新建 nativeResources/android/assets 目录。
    2. 配置timpush-configs.json(在 推送 > 接入设置 > 一键式快速配置 下载),到 nativeResources/android/assets/ 目录下。如图所示:
    
    
    
    
    3. 华为、荣耀、vivo、FCM。
    FCM
    华为
    荣耀
    vivo
    1. 配置 com.google.gms.google-servicesuni_modules/TencentCloud-Push/utssdk/app-android/config.json project.plugins 中,如下所示:
    "project": {
    "plugins": [
    ...
    "com.google.gms.google-services"
    ],
    "dependencies": [
    "com.huawei.agconnect:agcp:1.9.1.301",
    "com.google.gms:google-services:4.3.15",
    "com.hihonor.mcs:asplugin:2.0.1.300"
    ]
    }
    
    2. 配置 google-services.json 文件到 nativeResources/android/ 目录下(注意!请勿配置到 nativeResources/android/asstes 目录下)。如图所示:
    
    配置agconnect-services.json (此文件获取详见 厂商配置 > uniapp > 华为 > 步骤4:获取应用信息)到 nativeResources/android/assets/ 目录下。如图所示:
    
    1. 编辑 uni_modules/TencentCloud-Push/utssdk/app-android/config.jsondependencies,添加 "com.tencent.timpush:honor:8.3.6498"
    {
    ...
    "dependencies": [
    ...
    "com.tencent.timpush:honor:8.3.6498"
    ]
    }
    2. 配置 mcs-services.json 文件到 nativeResources/android (此文件获取详见 厂商配置 > uniapp > 荣耀 > 步骤3.2:进入应用详情, 绑定应用包名,下载 mcs-services.json 文件)目录下。如图所示:
    
    3. 配置 appIDnativeResources/android/manifestPlaceholders.json 中的 "HONOR_APPID"
    
    
    
    {
    "HONOR_APPID": ""
    }
    1. 编辑 uni_modules/TencentCloud-Push/utssdk/app-android/config.jsondependencies,添加 "com.tencent.timpush:vivo:8.3.6498"
    {
    ...
    "dependencies": [
    ...
    "com.tencent.timpush:vivo:8.3.6498"
    ]
    }
    2. 配置 appIDappKeynativeResources/android/manifestPlaceholders.json 中的 VIVO_APPKEYVIVO_APPID
    
    
    
    {
    "VIVO_APPKEY": "",
    "VIVO_APPID": "",
    }
    1. 新建 nativeResources/ios/Resources 目录;
    2. nativeResources/ios/Resources 中新建 timpush-configs.json 文件;
    3. 并将在 控制台 > 推送 > 接入设置 获取的证书ID,补充到 timpush-configs.json 文件中。如下所示:
    {
    "businessID":"xxx"
    }
    
    
    

    步骤3:引入并注册腾讯云推送服务(Push)

    SDKAppID appKey 替换为您在 控制台 获取的应用的信息。如图所示:
    
    
    
    import { TUILogin } from '@tencentcloud/tui-core';
    import { TUIConversationService } from '@tencentcloud/chat-uikit-engine';
    import * as Push from '@/uni_modules/TencentCloud-Push';
    
    const SDKAppID = 0; // 您的 SDKAppID
    const appKey = ''; // 客户端密钥
    const userID = ''; // 您的 userID
    const userSig = ''; // 您 userID 的密钥
    
    let vueVersion = 2;
    // #ifdef VUE3
    vueVersion = 3;
    // #endif
    
    TUILogin.login({
    SDKAppID,
    userID,
    userSig,
    useUploadPlugin: true,
    framework: `vue${vueVersion}`,
    }).then(() => {
    if (Push) {
    Push.setRegistrationID(userID, () => {
    console.log('setRegistrationID ok', userID);
    Push.registerPush(SDKAppID, appKey, (data) => {
    console.log('registerPush ok', data);
    Push.getRegistrationID((registrationID) => {
    console.log('getRegistrationID ok', registrationID);
    });
    }, (errCode, errMsg) => {
    console.error('registerPush failed', errCode, errMsg);
    }
    );
    });
    // 监听通知栏点击事件,获取推送扩展信息
    Push.addPushListener(Push.EVENT.NOTIFICATION_CLICKED, (res) => {
    console.log('notification clicked', res);
    // 解析扩展信息,跳转到相应的会话(代码仅供参考,发布前需要完善)
    try {
    const data = JSON.parse(res.data);
    const conv_type = data?.entity?.chatType === 1 ? 'C2C' : 'GROUP';
    // 根据推送信息拼的 conversationID
    const conversationID = `${conv_type}${data.entity.sender}`;
    // 切换会话
    TUIConversationService.switchConversation(conversationID);
    const chatPath = '/TUIKit/components/TUIChat/index';
    uni.navigateTo({ url: chatPath });
    } catch (error) {
    console.log('error', error);
    }
    });
    // 监听在线推送
    Push.addPushListener(Push.EVENT.MESSAGE_RECEIVED, (res) => {
    // res 为消息内容
    console.log('message received', res);
    });
    // 监听在线推送被撤回
    Push.addPushListener(Push.EVENT.MESSAGE_REVOKED, (res) => {
    // res 为被撤回的消息 ID
    console.log('message revoked', res);
    });
    }
    });

    步骤4: 使用云端证书,生成自定义基座

    单击 HBuilderX 的运行 > 运行到手机或模拟器 > 制作自定义调试基座,使用云端证书制作 Android 或 iOS 自定义调试基座。
    
    

    步骤5. 体验您的第一次推送

    在测试推送前,请务必打开通知和状态栏。进入 推送服务 Push > 接入测试 发送您的第一条推送。
    
    

    推送结果回调

    开启推送服务后,推送结果可以通过配置基础回调的方式,将结果转发给 App 后台,详见:

    设备通知栏设置

    推送的直观表现就是通知栏提示,所以同其他通知一样受设备通知相关设置的影响,以华为为例:
    “手机设置-通知-锁屏通知-隐藏或者不显示通知”,会影响锁屏状态下推送通知显示。
    “手机设置-通知-更多通知设置-状态栏显示通知图标”,会影响状态栏下推送通知的图标显示。
    “手机设置-通知-应用的通知管理-允许通知”,打开关闭会直接影响推送通知显示。
    “手机设置-通知-应用的通知管理-通知铃声” 和 “手机设置-通知-应用的通知管理-静默通知”,会影响推送通知铃音的效果。
    

    厂商推送限制

    1. 国内厂商都有消息分类机制,不同类型也会有不同的推送策略。如果想要推送及时可靠,需要按照厂商规则设置自己应用的推送类型为高优先级的系统消息类型或者重要消息类型。反之,推送消息会受厂商推送消息分类影响,与预期会有差异。
    2. 另外,一些厂商对于应用每天的推送数量也是有限制的,可以在厂商控制台查看应用每日限制的推送数量。 如果推送消息出现推送不及时或者偶尔收不到情况,需要考虑下这里:
    华为
    vivo
    OPPO
    小米
    魅族
    FCM
    将推送消息分为服务与通讯类和资讯营销类,推送效果和策略不同。另外,消息分类还和自分类权益有关:
    无自分类权益,推送消息厂商还会进行二次智能分类 。
    有申请自分类权益,消息分类会按照自定义的分类进行推送。 具体请参见 厂商描述
    将推送消息分为系统消息类和运营消息类,推送效果和策略不同。系统消息类型还会进行厂商的智能分类二次修正,若智能分类识别出不是系统消息,会自动修正为运营消息,如果误判可邮件申请反馈。另外,消息推送也受日推总数量限制,日推送量由应用在厂商订阅数统计决定。 具体请参见 厂商描述1厂商描述2
    将推送消息分为私信消息类和公信消息类,推送效果和策略不同。其中私信消息是针对用户有一定关注度,且希望能及时接收的信息,私信通道权益需要邮件申请。公信通道推送数量有限制。 具体请参见 厂商描述1厂商描述2
    将推送消息分为重要消息类和普通消息类,推送效果和策略不同。其中重要消息类型仅允许即时通讯消息、个人关注动态提醒、个人事项提醒、个人订单状态变化、个人财务提醒、个人状态变化、个人资源变化、个人设备提醒这8类消息推送,可以在厂商控制台申请开通。普通消息类型推送数量有限制。 具体请参见 厂商描述1厂商描述2
    推送消息数量有限制。 具体请参见 厂商描述
    推送上行消息频率有限制。 具体请参见厂商描述
    
    
    
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持