MTPush-API

              
                  /**
     * 配置應用key，不使用AndroidManifest.xml中的配置
     *
     * 需要在Application.onCreate()方法中調用
     * 請在#init之前調用
     *
     * @param context 不為空
     * @param appKey 不為空
     */
    public static void configAppKey(Context context, String appKey)

            

              
              MTCorePrivatesApi.configAppKey(this,"你的appkey");

            

              
                   /**
         * 配置應用渠道，不使用AndroidManifest.xml中的配置
         * 需要在Application.onCreate()方法中調用
         * 需在init前，並要在Application.onCreate內使用
         *
         * @param context    不為空
         * @param appChannel 不為空
         */
    public static void configAppChannel(Context context, String appChannel)

            

              
              MTCorePrivatesApi.configAppChannel(this,"你的appChannel");

            

              
                  /**
     * 配置數據中心站點名稱，不使用AndroidManifest.xml中的配置
     * 目前可選的節點有Singapore、USA_Virginia、DEU_Frankfurt和HongKong。
     * 需要在Application.onCreate()方法中調用
     * 請在#init之前調用
     *
     * @param context 不為空
     * @param appSiteName 不為空
     */
    public static void configAppSiteName(Context context, String appSiteName)

            

              
              MTCorePrivatesApi.configAppSiteName(this,"你的平台數據中心站點名稱");

            

              
                  /**
     * 設置心跳時間間隔
     *
     * 需要在Application.onCreate()方法中調用
     *
     * @param context 不為空
     * @param heartbeatInterval 時間單位為毫秒、必須大於0、默認值是4分50秒\
     */
    public static void configHeartbeatInterval(Context context, long heartbeatInterval)

            

              
              MTCorePrivatesApi.configHeartbeatInterval(this,3 * 60 * 1000);

            

              
                  /**
     * 設置長連接重試次數
     *
     * 需要在Application.onCreate()方法中調用
     *
     * @param context 不為空
     * @param connectRetryCount 重試的次數、默認值為3、最少3次
     */
    public static void configConnectRetryCount(Context context, int connectRetryCount)

            

              
              MTCorePrivatesApi.configConnectRetryCount(this,10);

            

              
                  /**
     * 設置長連接是否加密，默認不加密
     *
     * 需要在Application.onCreate()方法中調用
     *
     * @param isSSL true加密，false不加密
     */
    public static void setTcpSSl(Context context, boolean isSSL)

            

              
              MTCorePrivatesApi.setTcpSSl(context,true);

            

              
                  /**
     * 設置是否debug模式，debug模式會打印更對詳細日誌
     *
     * 需要在Application.onCreate()方法中調用
     * 
     * @param context 不為空 
     * @param enable 是否調試模式，true為調試模式，false不是
     */
    public static void configDebugMode(Context context, boolean enable)

            

              
                      // 建議應用未上線時設置為true，方便集成
        MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), true);
        
        // 建議應用上線後設置為false
        MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), false);

            

              
                  /**
     * 配置使用國密加密
     *
     * @param context 不為空
     */
    public static void configSM4(Context context)

            

              
                  // 開啟國密加密，不調用則使用默認加密方式
    MTCorePrivatesApi.configSM4(context.getApplicationContext());

            

              
                  /**
     * 獲取當前設備的userId，Engagelab唯一標識，可同於推播
     *
     * @param context 不為空
     * @return userId
     */
    public static String getUserId(Context context)

            

              
              String userId = MTCorePrivatesApi.getUserId(context);

            

              
                  /**
     * 獲取當前設備的registrationId，Engagelab唯一標識，可同於推播
     *
     * @param context 不為空
     * @return registrationId
     */
    public static String getRegistrationId(Context context)

            

              
              String registrationId = MTCorePrivatesApi.getRegistrationId(context);

            

              
                  /**
     * 配置設備遷移功能
     * 如果啟用，當設備型號發生變化時，會清除本地的註冊id、uid資訊，重新註冊
     * 默認為false
     *
     * @param context 不為空
     * @param enable  是否啟用設備遷移，true為啟用，false為禁用
     */
    public static void setEnableResetOnDeviceChange(Context context, boolean enable)

            

              
                      // 啟用設備遷移功能
        MTCorePrivatesApi.setEnableResetOnDeviceChange(this, true);
        
        // 禁用設備遷移功能（默認狀態）
        MTCorePrivatesApi.setEnableResetOnDeviceChange(this, false);

            

              
                  /**
     * 配置push版本號為3.9.X
     *
     * @param context 不為空
     */
    public static void configOldPushVersion(Context context)

            

              
              public class ExampleApplication extends Application {

    @Override
    public void onCreate() {
        // 打開調試模式    
        MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), true);
        // 使用老版本的通知點擊跳轉
        MTPushPrivatesApi.configOldPushVersion(context.getApplicationContext());
        // 初始化
        MTPushPrivatesApi.init(context.getApplicationContext());   
    }
}

            

              
                  /**
     * 配置push通知語言，在MTPushPrivatesApi.init後使用
     *
     * @param context      不為空
     * @param pushLanguage 為空字符串時，恢復使用手機語言
     */
    public static void configUserLanguage(Context context, String pushLanguage)

            

              
                  MTPushPrivatesApi.configUserLanguage(context,"zh-Hans");  

            

              
                  /**
     * 語音播報功能設置,需要導入語音包(mt-sdk-sound-x.x.x.aar)
     *
     * @param context      不為空
     * @param enable true為打開，false為關閉，默認為false
     */
    public static void setEnablePushTextToSpeech(Context context, boolean enable)

            

              
                  MTPushPrivatesApi.setEnablePushTextToSpeech(context,true);   

            

              
                  /**
     * MTPush初始化
     *
     * 建議在Application.onCreate()方法中調用
     * 
     * @param context 不為空，請使用applicationContext對象
     */
    public static void init(Context context)

            

              
              public class ExampleApplication extends Application {

    @Override
    public void onCreate() {
        // 打開調試模式    
        MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), true);
        // 初始化
        MTPushPrivatesApi.init(context.getApplicationContext());   
    }
}

            

              
                  /**
     * 前往通知開關設置頁面
     *
     * @param context 不為空
     */
    public static void goToAppNotificationSettings(Context context)

            

              
                  // 前往通知開關設置頁面，需要客戶手動打開通知開關
    MTPushPrivatesApi.goToAppNotificationSettings(this);
    
    // 繼承MTCommonReceiver後，復寫onNotificationStatus方法，獲取通知開關狀態，如果enable為true說明已經開啟成功
    @Override
    public void onNotificationStatus(Context context, boolean enable) {
                if(enable){
                        // 已設置通知開關為打開
                }	    
    }

            

              
                  /**
     * 開啟 Push 推播，並持久化存儲開關狀態為true，默認是true
     * 
     * @param context 不能為空
     */
    public static void turnOnPush(Context context)

            

              
              // 開啟推播，默認就是打開的
MTPushPrivatesApi.turnOnPush(context);
        
// 繼承MTCommonReceiver後，復寫onConnectStatus方法，獲取長連接的連接狀態，如果enable為true說明已經開啟成功
@Override
public void onConnectStatus(Context context, boolean enable){
    if(enable){
        // 開啟 push 推播成功
    }				
}				

            

              
                  /**
     * 關閉 push 推播，並持久化存儲開關狀態為false，默認是true
     *
     * @param context 不能為空
     */
    public static void turnOffPush(Context context)

            

              
              // 關閉推播，需要再調用turnOnPush才能開啟推播
MTPushPrivatesApi.turnOffPush(context);
        
// 繼承MTCommonReceiver後，復寫onConnectStatus方法，獲取長連接狀態，如果enable為false說明已經關閉成功
@Override
public void onConnectStatus(Context context, boolean enable){
    if(!enable){
        // 關閉 push 推播成功
    }
}		

            

              
                  /**
     * 增加指定tag，累加邏輯，之前設置的標籤依然存在
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     * @param tags     標籤數組，每個tag命名長度限制為40字節，最多支持設置1000個tag，且單次操作總長度不得超過5000字節
     */
    public static void addTag(Context context, int sequence, String... tags)

            

              
                      // 這裏定義一個常量，代表增加指定tag操作
        private static final int SEQUENCE_TAG_ADD = 1;
        // 增加tag:"china","guangdong","shenzhen"
        MTPushPrivatesApi.addTag(context,SEQUENCE_TAG_ADD,"china","guangdong","shenzhen")
            
        // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
        @Override
        public void onTagMessage(Context context, TagMessage tagMessage){
                if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                        // tag操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                        return;
                }
                if(tagMessage.getSequence() == SEQUENCE_TAG_ADD){
                        // 增加指定tag成功，此時可查看操作成功的tag數組
                        String[] tags = tagMessage.getTags();
                }
        }

            

              
                  /**
     * 刪除指定tag，刪除邏輯，會刪除指定的標籤
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     * @param tags     標籤數組，每個tag命名長度限制為40字節，最多支持設置1000個tag，且單次操作總長度不得超過5000字節
     */
    public static void deleteTag(Context context, int sequence, String... tags)

            

              
                  // 這裏定義一個常量，代表刪除指定tag操作
    private static final int SEQUENCE_TAG_DELETE = 2;
    // 刪除tag:"china","guangdong","shenzhen"
    MTPushPrivatesApi.deleteTag(context,SEQUENCE_TAG_DELETE,"china","guangdong","shenzhen")
    
    // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
    @Override
    public void onTagMessage(Context context, TagMessage tagMessage){
            if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // tag操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(tagMessage.getSequence() == SEQUENCE_TAG_DELETE){
                    // 刪除指定tag成功，此時可查看操作成功的tag數組
                    String[] tags = tagMessage.getTags();
            }
    }

            

              
                  /**
     * 更新指定tag，覆蓋邏輯，之前添加的tag會清空
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     * @param tags     標籤數組，每個tag命名長度限制為40字節，最多支持設置1000個tag，且單次操作總長度不得超過5000字節
     */
    public static void updateTag(Context context, int sequence, String... tags)

            

              
                  // 這裏定義一個常量，代表更新指定tag操作
    private static final int SEQUENCE_TAG_UPDATE = 3;
    // 更新tag:"beijing","shanghai","guangzhou","shenzhen"，之前設置的tag會失效
    MTPushPrivatesApi.updateTag(context,SEQUENCE_TAG_UPDATE,"beijing","shanghai","guangzhou","shenzhen")
    
    // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
    @Override
    public void onTagMessage(Context context, TagMessage tagMessage){
            if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // tag操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(tagMessage.getSequence() == SEQUENCE_TAG_UPDATE){
                    // 更新指定tag成功，此時可查看操作成功的tag數組
                    String[] tags = tagMessage.getTags();
            }
    }

            

              
                  /**
     * 查詢指定tag
     * 
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     * @param tag      標籤，每個tag命名長度限制為40字節
     */
    public static void queryTag(Context context, int sequence, String tag)

            

              
                  // 這裏定義一個常量，代表查詢指定tag操作
    private static final int SEQUENCE_TAG_QUERY = 4;
    // 查詢標籤
    MTPushPrivatesApi.queryTag(context,SEQUENCE_TAG_QUERY,"china")
    
    // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
    @Override
    public void onTagMessage(Context context, TagMessage tagMessage){
            if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // tag操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(tageMessage.getSequence() == SEQUENCE_TAG_QUERY){
                    // 查詢指定tag成功，此時可查看操作成功的tag和狀態
                    String tag = 	tagMessage.getQueryTag();
                    boolean valid = tagMessage.isQueryTagValid();
            }
    }	

            

              
                  /**
     * 刪除所有tag，清空邏輯，會刪除所有的標籤
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     */
    public static void deleteAllTag(Context context, int sequence, String... tags)

            

              
                  // 這裏定義一個常量，代表刪除所有tag操作
    private static final int SEQUENCE_TAG_DELETE_ALL = 5;
    // 刪除所有tag
    MTPushPrivatesApi.deleteTag(context,SEQUENCE_TAG_DELETE_ALL)
    
    // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
    @Override
    public void onTagMessage(Context context, TagMessage tagMessage){
            if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // tag操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(tagMessage.getSequence() == SEQUENCE_TAG_DELETE_ALL){
                    // 刪除所有tag成功
            }
    }

            

              
                  /**
     * 查詢所有tag，獲取邏輯，會獲取所有標籤
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     */
    public static void queryAllTag(Context context, int sequence, String... tags)

            

              
                  // 這裏定義一個常量，代表查詢所有tag操作
    private static final int SEQUENCE_TAG_QUERY_ALL = 6;
    // 查詢所有tag
    MTPushPrivatesApi.queryAllTag(context,SEQUENCE_TAG_QUERY_ALL)
    
    // 繼承MTCommonReceiver後，復寫onTagMessage方法，獲取tag操作回調
    @Override
    public void onTagMessage(Context context, TagMessage tagMessage){
            if(tagMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // tag 操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(tagMessage.getSequence() == SEQUENCE_TAG_DELETE_ALL){
                    // 查詢所有tag成功，此時可查看操作成功的tag數組
                    String[] tags = tagMessage.getTags();
            }
    }

            

              
                  /**
     * 設置alias
     * 
     * 同一個應用程序內，對不同的用戶，建議取不同的別名。這樣，盡可能根據別名來唯一確定用戶
     * 
     * 不限定一個別名只能指定一個用戶
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     * @param alias    有效的別名組成：字母（區分大小寫）、數字、下劃線、漢字、特殊字符@!#$&*+=.|。限制：alias命名長度限制為 40 字節（判斷長度需采用 UTF-8 編碼）
     *                             
     */
    public static void setAlias(Context context, int sequence, String alias) 

            

              
                  // 這裏定義一個常量，代表設置alias操作
    private static final int SEQUENCE_ALIAS_SET = 7;
    // 設置alias:"young"
    MTPushPrivatesApi.setAlias(context,SEQUENCE_ALIAS_SET,"young")
    
    // 繼承MTCommonReceiver後，復寫onAliasMessage方法，獲取alias操作回調
    @Override
    public void onAliasMessage(Context context, AliasMessage aliasMessage){
            if(aliasMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // alias操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(aliasMessage.getSequence() == SEQUENCE_ALIAS_SET){
                    // 設置alias成功，此時可查看操作成功的alias
                    String alias = 	aliasMessage.getAlias();
            }
    }	

            

              
                  /**
     * 獲取alias
     * 
     * 同一個應用程序內，對不同的用戶，建議取不同的別名。這樣，盡可能根據別名來唯一確定用戶
     * 
     * 不限定一個別名只能指定一個用戶
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     */
    public static void getAlias(Context context, int sequence)

            

              
                  // 這裏定義一個常量，代表獲取alias操作
    private static final int SEQUENCE_ALIAS_GET = 8;
    // 獲取alias
    MTPushPrivatesApi.getAlias(context,SEQUENCE_ALIAS_GET)
    
    // 繼承MTCommonReceiver後，復寫onAliasMessage方法，獲取alias操作回調
    @Override
    public void onAliasMessage(Context context, AliasMessage aliasMessage){
            if(aliasMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // alias 操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(aliasMessage.getSequence() == SEQUENCE_ALIAS_GET){
                    // 獲取alias成功，此時可查看操作成功的alias
                    String alias = 	aliasMessage.getAlias();
            }
    }	

            

              
                  /**
     * 清除alias
     *
     * 同一個應用程序內，對不同的用戶，建議取不同的別名。這樣，盡可能根據別名來唯一確定用戶
     * 
     * 不限定一個別名只能指定一個用戶
     *
     * @param context  不能為空
     * @param sequence 用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性
     */
    public static void clearAlias(Context context, int sequence)

            

              
                  // 這裏定義一個常量，代表清除alias操作
    private static final int SEQUENCE_ALIAS_CLEAR = 7;
    // 清除alias
    MTPushPrivatesApi.clearAlias(context,SEQUENCE_ALIAS_CLEAR)
    
    // 繼承MTCommonReceiver後，復寫onAliasMessage方法，獲取alias操作回調
    @Override
    public void onAliasMessage(Context context, AliasMessage aliasMessage){
            if(aliasMessage.getCode != MTPushPrivatesApi.Code.Success){
                    // alias操作失敗，詳細錯誤信息可查看MTPushPrivatesApi.Code
                    return;
            }
            if(aliasMessage.getSequence() == SEQUENCE_ALIAS_CLEAR){
                    // 清除alias成功
            }
    }	

            

              
                  /**
     * 設置通知展示時間，默認任何時間都展示
     *
     * @param context   不為空
     * @param beginHour 允許通知展示的開始時間（ 24 小時制，範圍為 0 到 23 ）
     * @param endHour   允許通知展示的結束時間（ 24 小時制，範圍為 0 到 23 ），beginHour不能大於等於endHour
     * @param weekDays  允許通知展示的星期數組（ 7 日制，範圍為 1 到 7），空數組代表任何時候都不展示通知
     */
    public static void setNotificationShowTime(Context context, int beginHour, int endHour, int... weekDays)

            

              
                  // 設置通知展示時間為每周1/3/5/7的早上9點到晚上9點
    MTPushPrivatesApi.setNotificationShowTime(context, 9, 21, 1,3,5,7);

            

              
                  /**
     * 重置通知展示時間，默認任何時間都展示
     *
     * @param context 不為空
     */
    public static void resetNotificationShowTime(Context context)

            

              
                  // 重置通知展示時間，默認任何時間都展示
    MTPushPrivatesApi.resetNotificationShowTime(context);

            

              
                  /**
     * 設置通知靜默時間，默認任何時間都不靜默
     *
     * @param context     不為空
     * @param beginHour   允許通知靜默的開始時間，單位小時（ 24 小時制，範圍為 0 到 23 ）
     * @param beginMinute 允許通知靜默的開始時間，單位分鐘（ 60 分鐘制，範圍為 0 到 59 ）
     * @param endHour     允許通知靜默的結束時間，單位小時（ 24 小時制，範圍為 0 到 23 ）
     * @param endMinute   允許通知靜默的結束時間，單位分鐘（ 60 分鐘制，範圍為 0 到 59 ）
     */
    public static void setNotificationSilenceTime(Context context, int beginHour, int beginMinute, int endHour, int endMinute)

            

              
                  // 設置通知靜默時間為每天晚上9點半到第二天早上9點半
    MTPushPrivatesApi.setNotificationSilenceTime(context, 21, 30, 9, 30);

            

              
                  /**
     * 重置通知靜默時間，默認任何時間都不靜默
     *
     * @param context 不為空
     */
    public static void resetNotificationSilenceTime(Context context)

            

              
                  // 重置通知靜默時間，默認任何時間都不靜默
    MTPushPrivatesApi.resetNotificationSilenceTime(context);

            

              
                  /**
     * 設置自定義通知布局，默認使用系統通知布局
     *
     * @param context            不為空
     * @param builderId          構建id
     * @param notificationLayout 自定義通知布局的對象，不為空
     */
    public static void setNotificationLayout(Context context, int builderId, NotificationLayout notificationLayout)

            

              
                      // 這裏定義一個常量，代表構建id
        private static final int BUILDER_ID = 11;
        
        // 構建出一個notificationLayout
    NotificationLayout notificationLayout = new NotificationLayout()
            .setLayoutId(R.layout.custom_notification_layout)        // 布局layout_id
            .setIconViewId(R.id.iv_notification_icon)                // 通知圖標view_id
            .setIconResourceId(R.drawable.mtpush_notification_icon)   // 通知圖標source_id
            .setTitleViewId(R.id.tv_notification_title)              // 通知標題view_id
            .setContentViewId(R.id.tv_notification_content)          // 通知內容view_id
            .setTimeViewId(R.id.tv_notification_time);               // 通知時間view_id
 
    // 設置構建id為BUILDER_ID的自定義布局，下發通知時指定builderId為BUILDER_ID，即可改變通知布局        
    MTPushPrivatesApi.setNotificationLayout(this.getApplicationContext(), BUILDER_ID, notificationLayout);

            

              
                  /**
     * 重置自定義通知布局，默認使用系統通知布局
     *
     * @param context   不為空
     * @param builderId 自定義通知布局的id
     */
    public static void resetNotificationLayout(Context context, int builderId)

            

              
                      // 這裏定義一個常量，代表構建id
        private static final int BUILDER_ID = 11;
        
    // 重置構建id為BUILDER_ID的自定義布局，下發通知時指定builderId為BUILDER_ID，將使用系統默認布局
    MTPushPrivatesApi.resetNotificationLayout(context,BUILDER_ID);

            

              
                  /**
     * 設置通知欄的通知數量，默認數量為5
     *
     * @param context 不為空
     * @param count   限制通知欄的通知數量，超出限制數量則移除最老通知，不能小於等於0
     */
    public static void setNotificationCount(Context context, int count)

            

              
                  // 設置通知欄通知數量為50
    MTPushPrivatesApi.setNotificationCount(context,50);

            

              
                  /**
     * 重置通知欄的通知數量，默認數量為5
     *
     * @param context 不為空
     */
    public static void resetNotificationCount(Context context)

            

              
                  // 重置通知欄的通知數量，默認數量為5
    MTPushPrivatesApi.resetNotificationCount(context);

            

              
                  /**
     * 設置應用角標數量，默認0（僅華為/榮耀生效）
     *
     * @param context 不為空
     * @param badge   應用角標數量
     */
    public static void setNotificationBadge(Context context, int badge)

            

              
                  // 設置應用角標數量為1
    MTPushPrivatesApi.setNotificationBadge(context,1);

            

              
                  /**
     * 重置應用角標數量，默認0（僅華為/榮耀生效）
     *
     * @param context 不為空
     */
    public static void resetNotificationBadge(Context context) {

            

              
                  // 重置應用角標數量，默認0
    MTPushPrivatesApi.resetNotificationBadge(context);

            

              
                  /**
     * 展示通知
     *
     * @param context             不為空
     * @param notificationMessage 構建的通知對象，不為空
     */
    public static void showNotification(Context context, NotificationMessage notificationMessage)

            

              
                  // 構建一個基礎的通知，其中messageId和content是必須，否則通知無法展示
    NotificationMessage notificationMessage = new NotificationMessage()
            .setMessageId("12345")
            .setNotificationId(12345)
            .setTitle("custom_notification_title")
            .setContent("custom_notification_content");    
    // 展示通知
    MTPushPrivatesApi.showNotification(context,notificationMessage);

            

              
                  /**
     * 清除指定notifyId的通知
     *
     * @param context  不為空
     * @param notifyId 通知id
     */
    public static void clearNotification(Context context, int notifyId)

            

              
                  // 清除指定notifyId的通知
    MTPushPrivatesApi.clearNotification(context,12345);

            

              
                  /**
     * 上報廠商通道通知到達
     * 
     * 走http/https上報
     *
     * @param context           不為空
     * @param messageId         Engagelab訊息id，不為空
     * @param platform          廠商，取值範圍（1:mi、2:huawei、3:meizu、4:oppo、5:vivo、7:honor、8:google）
     * @param platformMessageId 廠商訊息id，可為空
     */
    public static void reportNotificationArrived(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  // 上報廠商通知到達，messageId為“12345”，廠商為小米，廠商messageId為“MI-6476RHT25”
    MTPushPrivatesApi.reportNotificationArrived(context,“12345”,MTPushPrivatesApi.PLATFORM_XIAOMI,"MI-6476RHT25");

            

              
                  /**
     * 上報廠商通道通知點擊
     * 
     * 走http/https上報
     *
     * @param context           不為空
     * @param messageId         Engagelab訊息id，不為空
     * @param platform          廠商，取值範圍（1:mi、2:huawei、3:meizu、4:oppo、5:vivo、7:honor、8:google）
     * @param platformMessageId 廠商訊息id，可為空
     */
    public static void reportNotificationClicked(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  // 上報廠商通知點擊，messageId為“12345”，廠商為小米，廠商messageId為“MI-6476RHT25”
    MTPushPrivatesApi.reportNotificationClicked(context,“12345”,MTPushPrivatesApi.PLATFORM_XIAOMI,"MI-6476RHT25");

            

              
                  /**
     * 上報廠商通道通知刪除
     * 
     * 走http/https上報
     *
     * @param context           不為空
     * @param messageId         Engagelab訊息id，不為空
     * @param platform          廠商，取值範圍（1:mi、2:huawei、3:meizu、4:oppo、5:vivo、7:honor、8:google）
     * @param platformMessageId 廠商訊息id，可為空
     */
    public static void reportNotificationDeleted(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  // 上報廠商通知刪除，messageId為“12345”，廠商為mi，廠商messageId為“MI-6476RHT25”
    MTPushPrivatesApi.reportNotificationDeleted(context,“12345”,MTPushPrivatesApi.PLATFORM_XIAOMI,"MI-6476RHT25");

            

              
                  /**
     * 上報廠商通道通知打開
     * 
     * 走http/https上報
     *
     * @param context           不為空
     * @param messageId         Engagelab訊息id，不為空
     * @param platform          廠商，取值範圍（1:mi、2:huawei、3:meizu、4:oppo、5:vivo、7:honor、8:google）
     * @param platformMessageId 廠商訊息id，可為空
     */
    public static void reportNotificationOpened(Context context, String messageId, byte platform, String platformMessageId)

            

              
                  Bundle bundle = intent.getExtras();
    String platformMessage = "";
    // huawei
    if (intent.getData() != null) {
        platformMessage = intent.getData().toString();
    }
    // 其他廠商
    if (TextUtils.isEmpty(platformMessage) && intent.getExtras() != null) {
        if (bundle.containsKey("JMessageExtra")) {
             platformMessage = bundle.getString("JMessageExtra");
        }else {
             platformMessage = bundle.getString("MTMessageExtra");
        }
    }
    if (TextUtils.isEmpty(platformMessage)) {
        return;
    }
    JSONObject messageJson = new JSONObject(platformMessage);
    tvMessage.setText(toLogString(messageJson));
    // 解析
    String messageId = messageJson.optString("msg_id");
    byte platform = (byte) messageJson.optInt("rom_type");
    String title = messageJson.optString("n_title");
    String content = messageJson.optString("n_content");
    // 上報通知點擊activity打開，建議所有廠商跳轉都加上，僅MTPush4.0.0以下版本需要
    MTPushPrivatesApi.reportNotificationOpened(this, messageId, platform, ""); 

            

              
                  /**
     * 上傳廠商token
     * 
     * 走tcp上傳
     *
     * @param context  不為空
     * @param platform 廠商，取值範圍（1:mi、2:huawei、3:meizu、4:oppo、5:vivo、7:honor、8:google）
     * @param token    廠商返回的token，不為空
     * @param region    海外版小米和oppo需要設置region，國際版填:"GLOBAL",非海外版的填:"NULL"
     */
    public static void uploadPlatformToken(Context context, byte platform, String token, String region)

            

              
                  // 上報廠商token，廠商為mi，廠商token為“MI-6476s-afs-afs-afaR-HT25”
    MTPushPrivatesApi.uploadPlatformToken(context,MTPushPrivatesApi.PLATFORM_XIAOMI,"MI-6476s-afs-afs-afaR-HT25","NULL");

            

              
                  /**
     * 清除token，調用此接口後，只能通過uploadPlatformToken上報token，sdk不會再主動獲取token上報，冷啟動後重置
     * 通過回調onPlatformToken監聽，回調platform為-128時，表示清除成功。
     * 
     * 需tcp連接
     *
     * @param context  不為空
     */
    public static void clearPlatformToken(Context context)

            

              
                  MTPushPrivatesApi.clearPlatformToken(context);

            

              
                  /**
     * @param context           不為空
     * @param fragmentName      Fragment頁面完整類名（this.getClass().getCanonicalName()）
     */
    public static void onFragmentResume(Context context, String fragmentName)

            

              
                  /**
     * @param context           不為空
     * @param fragmentName      Fragment頁面完整類名（this.getClass().getCanonicalName()
     */
    public static void onFragmentPause(Context context, String fragmentName)

            

              
                  /**
     * 應用通知開關狀態回調
     *
     * @param context 不為空
     * @param enable  通知開關是否開，true為打開，false為關閉
     */
    @Override
    public void onNotificationStatus(Context context, boolean enable)

            

              
                  /**
     * 長連接是否連接成功
     *
     * 在初始化後會進行長連接，連接成功/失敗均會回調此方法
     *
     * @param context 不為空
     * @param enable  長連接是否連接成功，true為成功；false為失敗   
     */		
        public void onConnectStatus(Context context, boolean enable)

            

              
                  /**
     * 通知訊息送達
     *
     * 推播的通知訊息送達會回調此方法
     *
     * @param context 						不為空
     * @param notificationMessage 通知訊息  
     */				
    public void onNotificationArrived(Context context, NotificationMessage notificationMessage)

            

              
                  /**
     * 通知訊息在前台不顯示
     *
     * @param context             不為空
     * @param notificationMessage 通知訊息
     */
    @Override
    public void onNotificationUnShow(Context context, NotificationMessage notificationMessage)

            

              
                  /**
     * 通知訊息點擊
     *
         * 推播的通知訊息點擊會回調此方法
         *
     * @param context 						不為空
     * @param notificationMessage 通知訊息  
     */				
    public void onNotificationClicked(Context context, NotificationMessage notificationMessage)

            

              
                  /**
     * 通知訊息刪除
     * 
         * 推播的通知訊息刪除會回調此方法
         *
     * @param context 						不為空
     * @param notificationMessage 通知訊息  
     */				
    public void onNotificationDeleted(Context context, NotificationMessage notificationMessage)

            

              
                  /**
     * 自定義訊息送達
     *
     * 自定義訊息送達時會回調此方法
     *
     * @param context 			不為空
     * @param customMessage 自定義訊息  
     */				
    public void onCustomMessage(Context context, CustomMessage customMessage)

            

              
                  /**
     * tag操作訊息
     *
     * @param context    不為空
     * @param tagMessage 標籤信息
     */		
    public void onTagMessage(Context context, TagMessage tagMessage)

            

              
                  /**
     * alias操作訊息
     *
     * @param context      ApplicationContext對象
     * @param aliasMessage 別名訊息
     */
    public void onAliasMessage(Context context, AliasMessage aliasMessage)

            

              
                  /**
     * 廠商操作訊息
     *
     * @param context         ApplicationContext對象
     * @param platformMessage 廠商token訊息
     */
    public void onPlatformToken(Context context, PlatformTokenMessage platformMessage)

            

              
                  /**
     * 
     *
     * @param context         ApplicationContext對象
     * @param inAppMessage 應用內訊息
     */
    public void onInAppMessageShow(Context context, InAppMessage inAppMessage)

            

              
                  /**
     * 
     *
     * @param context         ApplicationContext對象
     * @param inAppMessage 應用內訊息
     */
    public void onInAppMessageClick(Context context, InAppMessage inAppMessage)

            

              
                  private void initChannel(){if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {NotificationManager nm = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
            if (nm != null){NotificationChannelGroup notificationChannelGroup = new NotificationChannelGroup("MyGroupId", "自定義通知組");
                nm.createNotificationChannelGroup(notificationChannelGroup);

                NotificationChannel notificationChannel = new NotificationChannel("MyChannelId", "自定義通知", NotificationManager.IMPORTANCE_HIGH);
                notificationChannel.setGroup("MyGroupId");
                notificationChannel.enableLights(true);
                notificationChannel.enableVibration(true);
                notificationChannel.setSound("android.resource:// 包名 /raw/ 鈴聲文件", null);    // 設置自定義鈴聲

                nm.createNotificationChannel(notificationChannel);
            }
        }
    }