更新记录

1.2.0(2021-02-23)

  1. 修复iOS无法正式打包问题;

1.1.0(2021-02-05)

  1. 新增IOS支持其他区域推送;
查看更多

平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 适用版本区间:9 - 14

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


腾讯云移动推送

为您提供稳定、快速高抵达的 App 推送服务。其接入方便快捷,拥有业内领先的技术实力,稳定可靠的消息推送通道,特有的智能推送通道策略,能有效提升消息抵达率;系统每分钟可容纳1800万推送消息,消息能秒级到达(支撑王者荣耀等腾讯内应用推送工具)。此外,移动推送 TPNS 具备精准用户标签能力,能有效助力 App 的精细化运营。

技术支持

原生模块本身使用复杂,移动推送接入流程步骤较多,造成难度不小。 建议使用前先联系我们的客服,协助接入。

我们的客服微信: ruanyunkeji001或ruanyunkeji002

接口列表

初始化与监听

函数 功能
init 初始化
setTPNSListener 设置监听器
removeTPNSListener 移除监听器

启动与注册

函数 功能
registerPush 注册推送
unregisterPush 注销推送

标签功能

函数 功能
appendTags 绑定标签
delTags 解绑标签
clearTags 清除全部标签
clearAndAppendTags 更新标签

用户属性管理

函数 功能
upsertAttributes 新增用户属性
delAttributes 删除用户属性
clearAttributes 清空已有用户属性
clearAndAppendAttributes 更新用户属性

其他

函数 功能
enableDebug 开启或关闭debug模式
getTPNSToken 获取tpnsToken

快速开始

步骤一: 腾讯云配置

注册或登录腾讯云账号,实名认证后,点击移动推送,开通腾讯移动推送产品功能,并注册应用。

配置步骤繁琐,请联系我们的技术支持。

步骤二: 开始使用模块

module的模块需要加载才能使用:

var tpns = uni.requireNativePlugin("RY-TencentTPNS");
  1. 模块初始化

init({}, ret)

初始化

tpns.init({}, ret => {
    uni.showToast({
        title: JSON.stringify(ret),
        icon: "none"
    });
});

步骤三: 设置监听

setTPNSListener({} ret)

设置监听器, 监听事件回调

ret:

参数 含义
onReisger 注册回调
onUnregister 取消注册回调
tpns.setTPNSListener({}, ret => {
    uni.showToast({
        title: JSON.stringify(ret),
        icon: "none"
    });
});

步骤四: 注册推送

registerPush({params}, ret)

注册推送

params:

参数 含义
accessId 腾讯云后台开通应用得到的accessId
accessKey 腾讯云后台开通应用得到的accessKey
tpns.registerPush({
    accessId: self.ios.accessId, 
    accessKey: self.ios.accessKey,
    xiaomi: self.ios.xiaomi,
    oppo: self.ios.oppo,
    meizu: self.ios.meizu
}, ret => {
    uni.showToast({
        title: JSON.stringify(ret),
        icon: "none"
    });
});

更多功能

获取内测功能和技术支持,请联系我们客户微信: ruanyunkeji001或ruanyunkeji002

  • IM集成

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android: "android.permission.INTERNET", "android.permission.ACCESS_WIFI_STATE", "android.permission.ACCESS_NETWORK_STATE", "android.permission.WAKE_LOCK", "android.permission.VIBRATE", "android.permission.RECEIVE_USER_PRESENT", "android.permission.READ_PHONE_STATE", "android.permission.GET_TASKS" iOS:无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件使用的腾讯云移动推送 SDK会采集数据,详情可参考:https://cloud.tencent.com/document/product/548/36645

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问