Integrate with Umeng

Tuya supports push notifications through third-party channels, such as Google Firebase Cloud Messaging (FCM), Umeng, Xiaomi, Huawei, and MEIZU. To integrate this feature into your app development, you must request app key information from each third-party platform and initialize the SDK as instructed in the documents. This topic describes how to integrate with U-Push to enable push notifications through Umeng.

Configure key information

1. If your push notifications are targeted to mainland China and developed based on U-Push, follow Umeng’s documents to integrate U-Push into your project.

2. Request key information required by push notifications through Umeng. For more information, see Apply for Push Key from Umeng.

3. Log in to the Tuya IoT Development Platform and go to the SDK Development page. On the Certificates tab, copy and paste the requested key information to the Push (Umeng) section.

   
   The configurations must meet the following requirements:

   • The package name on U-Push is the same as the SDK app package name on the Tuya IoT Development Platform.
   • The values of Message Secret and Master Secret must be correct and cannot be exchanged.
   • The checkbox to enable the server IP address on U-Push can only be disabled manually.

Integrate with U-Push

Step 1: Set a user’s alias

After your project is integrated with Umeng, use the Umeng SDK to set the user ID. Push notifications are sent to users by user IDs.

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

Parameters

Step 2: Register alias to cloud

Register aliasId to the Tuya IoT Cloud.

Parameters

Example

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

    @Override
    public void onSuccess() {

    }
});

Step 3: Configure third-party channel

If a third-party channel is used, the activity of the dialog box must be named SpecialPushActivity. For example, to enable push notifications through Umeng, SpecialPushActivity inherits from UmengNotifyClickActivity, and the complete package name path is com.activity.SpecialPushActivity.

Receive push notifications

For more information on how to integrate with custom push notifications through Umeng, see Umeng’s documents. Example:

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

• The content in msg.custom is the received push notification. The content of msg.custom is delivered over the protocol in the following format:

  custom=tuya://message?a=view&ct="title"&cc="content"&p=>{}&link=tuyaSmart%3A%2F%2Fbrowser%3Furl%3Dhttp%253A%252F%252Fwww.baidu.com;
  

• The content is parsed into key information, such as the title, body, and navigation information, using Uri uri = Uri.parse(message);.

Unbind a user

API description

You can call the following Umeng method to remove a registration token. This applies when you want to unbind your app from users in specific scenarios, such as logout.

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

Parameters

Send push notifications

After you integrate with the capabilities of push notifications, you can configure push notifications on the Tuya IoT Development Platform.

Create an operation push notification

Log in to the Tuya IoT Development Platform and go to the Marketing push page. Then, users can receive your in-app message regarding new arrivals, trending information, and more. This can help to build user engagement.

Create a device push notification

To create a device push notification, log in to the Tuya IoT Development Platform, and in the left-side navigation pane, choose Product > Notifications. For more information, see Configure Push Notification.