Android 極光推送別名與標(biāo)簽方式
Android 極光推送 別名、標(biāo)簽、RegistrationID
說(shuō)明
別名(alias)
為安裝了應(yīng)用程序的用戶,取個(gè)別名來(lái)標(biāo)識(shí)。以后給該用戶 Push 消息時(shí),就可以用此別名來(lái)指定。每個(gè)用戶只能指定一個(gè)別名。
建議:對(duì)于同一個(gè)應(yīng)用內(nèi)部,建議不同用戶設(shè)置不同的別名,保證用戶別名的唯一性。(極光不限制同一個(gè)別名只能對(duì)應(yīng)一個(gè)用戶。當(dāng)一個(gè)別名指定了多個(gè)用戶時(shí),當(dāng)給這個(gè)別名推送消息時(shí),這個(gè)別名對(duì)應(yīng)的多個(gè)用戶都會(huì)收到推送消息)
標(biāo)簽(tag)
給用戶打上標(biāo)簽,主要用于向特定批量用戶推送消息??蔀橐粋€(gè)用戶設(shè)置多個(gè)標(biāo)簽。
registrationId(設(shè)備唯一標(biāo)識(shí))
應(yīng)用程序在第一次成功注冊(cè)到極光服務(wù)器時(shí),極光服務(wù)器會(huì)給客戶端返回一個(gè)唯一的該設(shè)備的標(biāo)識(shí) - RegistrationID。JPush SDK 會(huì)以廣播的形式發(fā)送 RegistrationID 到應(yīng)用程序。
應(yīng)用程序可以把此 RegistrationID 保存以自己的應(yīng)用服務(wù)器上,然后就可以根據(jù) RegistrationID 來(lái)向設(shè)備推送消息或者通知。
setMobileNumber
3.1.1 版本開(kāi)始提供設(shè)置手機(jī)號(hào)碼的接口,用于短信補(bǔ)充功能。
支持的操作
別名與標(biāo)簽,支持增刪改查的操作。
registrationId,只支持查詢的操作。
alias的操作:
Method - setAlias
調(diào)用此 API 來(lái)設(shè)置別名。
這個(gè)接口是覆蓋邏輯,而不是增量邏輯。即新的調(diào)用會(huì)覆蓋之前的設(shè)置。
public static void setAlias(Context context, int sequence, String alias);
參數(shù)定義
sequence
用戶自定義的操作序列號(hào),同操作結(jié)果一起返回,用來(lái)標(biāo)識(shí)一次操作的唯一性。
alias
有效的別名組成:字母(區(qū)分大小寫)、數(shù)字、下劃線、漢字、特殊字符@!#$&*+=.|。
限制:alias 命名長(zhǎng)度限制為 40 字節(jié)。(判斷長(zhǎng)度需采用 UTF-8 編碼)
Method - deleteAlias
調(diào)用此 API 來(lái)刪除別名。
public static void deleteAlias(Context context,int sequence);
Method - getAlias
調(diào)用此 API 來(lái)查詢別名。
public static void getAlias(Context context,int sequence);
tag的操作:
Method - setTags
調(diào)用此 API 來(lái)設(shè)置標(biāo)簽。
需要理解的是,這個(gè)接口是覆蓋邏輯,而不是增量邏輯。即新的調(diào)用會(huì)覆蓋之前的設(shè)置。
public static void setTags(Context context, int sequence,Set tags);
參數(shù)定義
sequence
用戶自定義的操作序列號(hào),同操作結(jié)果一起返回,用來(lái)標(biāo)識(shí)一次操作的唯一性。
tags
有效的標(biāo)簽組成:字母(區(qū)分大小寫)、數(shù)字、下劃線、漢字、特殊字符@!#$&*+=.|。
限制:每個(gè) tag 命名長(zhǎng)度限制為 40 字節(jié),最多支持設(shè)置 1000 個(gè) tag,且單次操作總長(zhǎng)度不得超過(guò) 5000 字節(jié)。(判斷長(zhǎng)度需采用 UTF-8 編碼)
單個(gè)設(shè)備最多支持設(shè)置 1000 個(gè) tag。App 全局 tag 數(shù)量無(wú)限制。
Method - addTags
調(diào)用此 API 來(lái)新增標(biāo)簽。
public static void addTags(Context context, int sequence,Set tags);
Method - deleteTags
調(diào)用此 API 來(lái)刪除指定標(biāo)簽。
public static void deleteTags(Context context, int sequence,Set tags);
Method - cleanTags
調(diào)用此 API 來(lái)清除所有標(biāo)簽。
public static void cleanTags(Context context, int sequence);
Method - getAllTags
調(diào)用此 API 來(lái)查詢所有標(biāo)簽。
public static void getAllTags(Context context, int sequence);
Method - checkTagBindState
調(diào)用此 API 來(lái)查詢指定 tag 與當(dāng)前用戶綁定的狀態(tài)。
public static void checkTagBindState(Context context,int sequence,String tag);
registrationId的操作
SDK 初次注冊(cè)成功后,開(kāi)發(fā)者通過(guò)在自定義的 Receiver 里監(jiān)聽(tīng) Action - cn.jpush.android.intent.REGISTRATION 來(lái)獲取對(duì)應(yīng)的 RegistrationID。
注冊(cè)成功后,也可以通過(guò)函數(shù) public static String getRegistrationID(Context context) 獲取
舉例子:
當(dāng)App端初次注冊(cè)成功后,或注冊(cè)成功后getRegistrantionId接口得到registrationId,app內(nèi)部登錄時(shí)傳參registrationId,服務(wù)器保存當(dāng)前的registrationId,服務(wù)器根據(jù)保存的registrationId推送消息
消息回調(diào)方式說(shuō)明
Class - cn.jpush.android.service.JPushMessageReceiver
新的消息回調(diào)方式中相關(guān)回調(diào)類。
1、新的 tag 與 alias 操作回調(diào)會(huì)在開(kāi)發(fā)者定義的該類的子類中觸發(fā)。
2、手機(jī)號(hào)碼設(shè)置的回調(diào)會(huì)在開(kāi)發(fā)者定義的該類的子類中觸發(fā)。
該類為回調(diào)父類,開(kāi)發(fā)者需要繼承該類并在 Manifest 中配置您對(duì)應(yīng)實(shí)現(xiàn)的類,接口操作的結(jié)果會(huì)在您配置的類中的如下方法中回調(diào)。
Method - onAliasOperatorResult
alias 相關(guān)的操作會(huì)在此方法中回調(diào)結(jié)果。
Method - onTagOperatorResult
tag 增刪查改的操作會(huì)在此方法中回調(diào)結(jié)果。
Method - onCheckTagOperatorResult
查詢某個(gè) tag 與當(dāng)前用戶的綁定狀態(tài)的操作會(huì)在此方法中回調(diào)結(jié)果。
Method - onMobileNumberOperatorResult
設(shè)置手機(jī)號(hào)碼會(huì)在此方法中回調(diào)結(jié)果。
/** * 自定義JPush message 接收器,包括操作tag/alias的結(jié)果返回(僅僅包含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 極光推送別名與標(biāo)簽方式就是小編分享給大家的全部?jī)?nèi)容了,希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
Arduino 數(shù)據(jù)類型轉(zhuǎn)換(單機(jī)片)詳細(xì)介紹
這篇文章主要介紹了Arduino 數(shù)據(jù)類型轉(zhuǎn)換(單機(jī)片)詳細(xì)介紹的相關(guān)資料,需要的朋友可以參考下2016-11-11Android實(shí)現(xiàn)超級(jí)棒的沉浸式體驗(yàn)教程
這篇文章主要給大家介紹了關(guān)于Android如何實(shí)現(xiàn)超級(jí)棒的沉浸式體驗(yàn)的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家學(xué)習(xí)或者使用Android具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2018-11-11android使用Jsoup 抓取頁(yè)面的數(shù)據(jù)
本篇文章主要介紹了android使用Jsoup 抓取頁(yè)面的數(shù)據(jù),jsoup 是一款Java的HTML解析器,有需要的朋友可以了解一下。2016-11-11Android實(shí)現(xiàn)背景可滑動(dòng)登錄界面 (不壓縮背景彈出鍵盤)
這篇文章主要介紹了Android實(shí)現(xiàn)背景可滑動(dòng)登錄界面 (不壓縮背景彈出鍵盤),需要的朋友可以參考下2017-04-04Android開(kāi)發(fā)之串口編程原理和實(shí)現(xiàn)方式
提到串口編程,就不得不提到JNI,不得不提到JavaAPI中的文件描述符類:FileDescriptor;下面我分別對(duì)JNI、FileDescriptor以及串口的一些知識(shí)點(diǎn)和實(shí)現(xiàn)的源碼進(jìn)行分析說(shuō)明,感興趣的朋友可以了解下2013-01-01Android高手進(jìn)階教程(二十六)之---Android超仿Path菜單的功能實(shí)現(xiàn)!
本篇文章主要主要介紹了Android超仿Path菜單的功能實(shí)現(xiàn),現(xiàn)在分享給大家,也給大家做個(gè)參考。感興趣的可以了解一下。2016-11-11Android實(shí)現(xiàn)聯(lián)動(dòng)下拉框二級(jí)地市聯(lián)動(dòng)下拉框功能
這篇文章主要介紹了Android實(shí)現(xiàn)聯(lián)動(dòng)下拉框二級(jí)地市聯(lián)動(dòng)下拉框功能,本文給大家分享思路步驟,給大家介紹的非常詳細(xì),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2018-12-12Android自定義FloatingText仿點(diǎn)贊+1特效
這篇文章主要為大家詳細(xì)介紹了Android自定義FloatingText仿點(diǎn)贊+1特效,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-03-03Flutter源碼分析之自定義控件(RenderBox)指南
寫了兩天的flutter,發(fā)現(xiàn)控件樣式很多,flutter資源很少,本文在于實(shí)用性,可以減少頁(yè)面代碼,下面這篇文章主要介紹了Flutter源碼分析之自定義控件(RenderBox)的相關(guān)資料,需要的朋友可以參考下2021-08-08