简体中文
简体中文
English
联系我们
注册
登录

集成友盟

更新时间:2023-03-22 01:50:46下载pdf

涂鸦支持友盟第三方通道的消息推送(Push),例如友盟、小米、华为、魅族等平台,在配置 App 项目时,您需要在各个平台申请 App Key,然后根据文档描述完成初始化。本文介绍友盟平台的 Push 集成方法。

配置信息

  1. 如果您的中国大陆地区的 Push 功能是基于友盟推送开发的,请先参考 友盟文档 将友盟集成到项目中。

  2. 将友盟申请方式可以参考文档 友盟推送 Key 申请流程

  3. 登录 涂鸦 IoT 平台,在您的 App SDK 配置页面,将申请到的 App Key 等信息复制到应用配置中。

    集成友盟

    请勿将信息配置错误:

    • 确认友盟后台包名与 SDK 应用包名一致。
    • 友盟 Message Secret 和 App Master Secret 不要配置反了。
    • 友盟平台的 启用服务器 IP 地址 需要手动关闭。

集成步骤

第一步:设置用户别名

在确认友盟已经集成到项目中后,请通过友盟 SDK 设置用户 ID,推送时会按照用户 ID 向用户推送消息:

mPushAgent.setAlias(aliasId, ALIAS_TYPE, new UTrack.ICallBack() {
    @Override
    public void onMessage(boolean isSuccess, String message) {
    }
});

参数说明

参数 说明
aliasId 可以是您的应用为每个用户自动生成的唯一 ID
ALIAS_TYPE 请填写为 TUYA_SMART

第二步:注册涂鸦 Push

aliasId 注册到涂鸦。

参数说明

参数 说明
aliasId 用户别名,将上一步中拿到的别名注册到涂鸦,智能生活 SDK 将会以该别名向 App 推送消息
pushProvider 注册 Push 的类别,友盟需填写为 umeng

示例代码

TuyaHomeSdk.getPushInstance().registerDevice(String aliasId, String pushProvider, new IResultCallback() {
    @Override
    public void onError(String code, String error) {
    }

    @Override
    public void onSuccess() {

    }
});

第三步:第三方通道设置

如果使用了友盟第三方通道,弹窗的 activity 必须命名为 SpecialPushActivity。以友盟为例,SpecialPushActivity 继承自 UmengNotifyClickActivity,并且完整的包名路径为com.activity.SpecialPushActivity

接收 Push

关于如何集成友盟自定义消息请参考 友盟官方接入文档 的自定义消息(消息透传)部分。例如:

UmengMessageHandler messageHandler = new UmengMessageHandler(){
    @Override
    public void dealWithCustomMessage(final Context context, final UMessage msg) {
        new Handler(getMainLooper()).post(new Runnable() {

            @Override
            public void run() {
                Toast.makeText(context, msg.custom, Toast.LENGTH_LONG).show();
            }
        });
    }
};

mPushAgent.setMessageHandler(messageHandler);
  • msg.custom 中的内容就是收到的推送信息,msg.custom 的具体协议格式为:
    custom=tuya://message?a=view&ct="title"&cc="content"&p=>{}&link=tuyaSmart%3A%2F%2Fbrowser%3Furl%3Dhttp%253A%252F%252Fwww.baidu.com;
    
  • 通过 Uri uri = Uri.parse(message); 来对数据进行解析,从而得到 Push 标题、内容、跳转信息等关键信息。

解绑用户

接口说明

在用户退出登录等需要解除应用和用户关系,此时您可以调用友盟的移除别名的方法。

mPushAgent.deleteAlias(aliasId, "TUYA_SMART", new UTrack.ICallBack() {
    @Override
    public void onMessage(boolean isSuccess, String message) {
    }
});

参数说明

参数 说明
aliasId 用户自动生成的唯一 ID
ALIAS_TYPE 请填写为 TUYA_SMART

发送 Push

集成 Push 能力后,您就可以在涂鸦 IoT 平台进行每次的 Push 推送设置。

新增运营 Push

涂鸦 IoT 平台营销推送 页面,新建 App 消息推送。用户会在 App 上接收到您的推送提醒,新品上市推荐或者生活温馨提醒等信息,方便有效营销您的用户。

集成友盟

新增设备消息

涂鸦 IoT 平台消息推送 页面,完成设备信息推送。更多详细操作,请参考 推送设备信息

集成友盟