集成友盟

涂鸦支持友盟第三方通道的消息推送（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) {
    }
});

参数说明

第二步：注册涂鸦 Push

将 aliasId 注册到涂鸦。

参数说明

示例代码

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) {
    }
});

参数说明

发送 Push

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

新增运营 Push

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

新增设备消息

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