Android 極光推送別名與標簽方式

Android 極光推送 別名、標簽、RegistrationID

說明

別名（alias）

為安裝了應用程序的用戶，取個別名來標識。以后給該用戶 Push 消息時，就可以用此別名來指定。每個用戶只能指定一個別名。

建議：對于同一個應用內部，建議不同用戶設置不同的別名，保證用戶別名的唯一性。(極光不限制同一個別名只能對應一個用戶。當一個別名指定了多個用戶時，當給這個別名推送消息時，這個別名對應的多個用戶都會收到推送消息)

標簽（tag）

給用戶打上標簽，主要用于向特定批量用戶推送消息。可為一個用戶設置多個標簽。

registrationId（設備唯一標識）

應用程序在第一次成功注冊到極光服務器時，極光服務器會給客戶端返回一個唯一的該設備的標識 - RegistrationID。JPush SDK 會以廣播的形式發送 RegistrationID 到應用程序。

應用程序可以把此 RegistrationID 保存以自己的應用服務器上，然后就可以根據 RegistrationID 來向設備推送消息或者通知。

setMobileNumber

3.1.1 版本開始提供設置手機號碼的接口，用于短信補充功能。

支持的操作

別名與標簽，支持增刪改查的操作。

registrationId，只支持查詢的操作。

alias的操作：

Method - setAlias

調用此 API 來設置別名。

這個接口是覆蓋邏輯，而不是增量邏輯。即新的調用會覆蓋之前的設置。

public static void setAlias(Context context, int sequence, String alias);

參數定義

sequence

用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性。

alias

有效的別名組成：字母（區分大小寫）、數字、下劃線、漢字、特殊字符@!#$&*+=.|。

限制：alias 命名長度限制為 40 字節。（判斷長度需采用 UTF-8 編碼）

Method - deleteAlias

調用此 API 來刪除別名。

public static void deleteAlias(Context context,int sequence);

Method - getAlias

調用此 API 來查詢別名。

public static void getAlias(Context context,int sequence);

tag的操作：

Method - setTags

調用此 API 來設置標簽。

需要理解的是，這個接口是覆蓋邏輯，而不是增量邏輯。即新的調用會覆蓋之前的設置。

public static void setTags(Context context, int sequence,Set tags);

參數定義

sequence

用戶自定義的操作序列號，同操作結果一起返回，用來標識一次操作的唯一性。

tags

有效的標簽組成：字母（區分大小寫）、數字、下劃線、漢字、特殊字符@!#$&*+=.|。

限制：每個 tag 命名長度限制為 40 字節，最多支持設置 1000 個 tag，且單次操作總長度不得超過 5000 字節。（判斷長度需采用 UTF-8 編碼）

單個設備最多支持設置 1000 個 tag。App 全局 tag 數量無限制。

Method - addTags

調用此 API 來新增標簽。

public static void addTags(Context context, int sequence,Set tags);

Method - deleteTags

調用此 API 來刪除指定標簽。

public static void deleteTags(Context context, int sequence,Set tags);

Method - cleanTags

調用此 API 來清除所有標簽。

public static void cleanTags(Context context, int sequence);

Method - getAllTags

調用此 API 來查詢所有標簽。

public static void getAllTags(Context context, int sequence);

Method - checkTagBindState

調用此 API 來查詢指定 tag 與當前用戶綁定的狀態。

public static void checkTagBindState(Context context,int sequence,String tag);

registrationId的操作

SDK 初次注冊成功后，開發者通過在自定義的 Receiver 里監聽 Action - cn.jpush.android.intent.REGISTRATION 來獲取對應的 RegistrationID。

注冊成功后，也可以通過函數 public static String getRegistrationID(Context context) 獲取

舉例子：

當App端初次注冊成功后，或注冊成功后getRegistrantionId接口得到registrationId，app內部登錄時傳參registrationId，服務器保存當前的registrationId，服務器根據保存的registrationId推送消息

消息回調方式說明

Class - cn.jpush.android.service.JPushMessageReceiver

新的消息回調方式中相關回調類。

1、新的 tag 與 alias 操作回調會在開發者定義的該類的子類中觸發。

2、手機號碼設置的回調會在開發者定義的該類的子類中觸發。

該類為回調父類，開發者需要繼承該類并在 Manifest 中配置您對應實現的類，接口操作的結果會在您配置的類中的如下方法中回調。

Method - onAliasOperatorResult

alias 相關的操作會在此方法中回調結果。

Method - onTagOperatorResult

tag 增刪查改的操作會在此方法中回調結果。

Method - onCheckTagOperatorResult

查詢某個 tag 與當前用戶的綁定狀態的操作會在此方法中回調結果。

Method - onMobileNumberOperatorResult

設置手機號碼會在此方法中回調結果。

/**
 * 自定義JPush message 接收器,包括操作tag/alias的結果返回(僅僅包含tag/alias新接口部分)
 * */
public class MyJPushMessageReceiver extends JPushMessageReceiver {

 @Override
 public void onTagOperatorResult(Context context, JPushMessage jPushMessage) {
  TagAliasOperatorHelper.getInstance().onTagOperatorResult(context,jPushMessage);
  super.onTagOperatorResult(context, jPushMessage);
 }
 @Override
 public void onCheckTagOperatorResult(Context context, JPushMessage jPushMessage){
  TagAliasOperatorHelper.getInstance().onCheckTagOperatorResult(context,jPushMessage);
  super.onCheckTagOperatorResult(context, jPushMessage);
 }
 @Override
 public void onAliasOperatorResult(Context context, JPushMessage jPushMessage) {
  TagAliasOperatorHelper.getInstance().onAliasOperatorResult(context,jPushMessage);
  super.onAliasOperatorResult(context, jPushMessage);
 }

 @Override
 public void onMobileNumberOperatorResult(Context context, JPushMessage jPushMessage) {
  TagAliasOperatorHelper.getInstance().onMobileNumberOperatorResult(context,jPushMessage);
  super.onMobileNumberOperatorResult(context, jPushMessage);
 }
}

以上這篇Android 極光推送別名與標簽方式就是小編分享給大家的全部內容了，希望能給大家一個參考，也希望大家多多支持億速云。