Token是每台设备上每个应用的唯一标识,应用调用getToken方法向Push服务端请求Token,当getToken方法返回为空时,Token可通过onNewToken方法返回,因此您必须实现onNewToken方法。您也可以通过SDK的自动初始化能力来自动获取Token。获取到Token后需要将Token上报到您自己的应用服务器。后续您可以调用下行消息API,根据Token来推送消息。
Token与华为帐号不相关,仅与您的App ID相关,因此切换华为帐号后Token不会变化。建议您直接使用推送服务提供的帐号校验功能来开发帐号相关功能,无需通过Token来判断。
Token一般情况不会变化,仅下列场景Token会发生变化。因此,禁止频繁申请Token,尤其严禁常驻应用定期频繁申请Token。
推送服务为了提升安全性,在2020年11月更新了Token的编码规则,用户只要升级了新版的推送服务应用,当您的应用被卸载重装后,重新打开时申请到的Token即为最新的编码格式。
建议在应用启动后首个Activity的onCreate方法中调用getToken方法。
“Java”
private void getToken() {
// 创建一个新线程
new Thread() {
@Override
public void run() {
try {
// 从agconnect-services.json文件中读取APP_ID
String appId = "your APP_ID";
// 输入token标识"HCM"
String tokenScope = "HCM";
String token = HmsInstanceId.getInstance(MainActivity.this).getToken(appId, tokenScope);
Log.i(TAG, "get token success");
// 判断token是否为空
if(!TextUtils.isEmpty(token)) {
sendRegTokenToServer(token);
}
} catch (ApiException e) {
Log.e(TAG, "get token failed, " + e);
}
}
}.start();
}
private void sendRegTokenToServer(String token) {
Log.i(TAG, "sending token to server.");
} “Kotlin”
private fun getToken() {
// 创建一个新线程
object : Thread() {
override fun run() {
try {
// 从agconnect-services.json文件中读取APP_ID
val appId = "your APP_ID"
// 输入token标识"HCM"
val tokenScope = "HCM"
val token = HmsInstanceId.getInstance(this@MainActivity).getToken(appId, tokenScope)
Log.i(TAG, "get token success")
// 判断token是否为空
if (!TextUtils.isEmpty(token)) {
sendRegTokenToServer(token)
}
} catch (e: ApiException) {
Log.e(TAG, "get token failed, $e")
}
}
}.start()
}
private fun sendRegTokenToServer(token: String) {
Log.i(TAG, "sending token to server.")
} “Java”
@Override
public void onNewToken(String token, Bundle bundle) {
// 获取token
Log.i(TAG, "have received refresh token.");
// 判断token是否为空
if (!TextUtils.isEmpty(token)) {
refreshedTokenToServer(token);
}
}
private void refreshedTokenToServer(String token) {
Log.i(TAG, "sending token to server.");
} “Kotlin”
override fun onNewToken(token: String, bundle: Bundle) {
// 获取token
Log.i(TAG, "have received refresh token.")
// 判断token是否为空
if (token.isNotEmpty()) {
refreshedTokenToServer(token)
}
}
private fun refreshedTokenToServer(token: String) {
Log.i(TAG, "sending token to server.")
} 用户拒绝接受您应用的使用协议和隐私声明后,您可以调用deleteToken方法删除Push服务器上对应的Push Token。删除成功后,客户端应用将不再接收到消息。
不建议您调用deleteToken方法删除Push Token,建议您将拒绝应用使用协议和隐私声明用户的Push Token状态设置为无效状态,并控制应用服务端不再向Push Token无效的客户端推送消息,此举可减少应用服务端向Push Kit服务端请求的频率。
注销Push Token方法示例:
“Java”
private void deleteToken() {
// 创建一个新线程
new Thread() {
@Override
public void run() {
try {
// 从agconnect-services.json文件中读取APP_ID
String appId = "your APP_ID";
// 输入token标识"HCM"
String tokenScope = "HCM";
// 注销Token
HmsInstanceId.getInstance(context).deleteToken(appId, tokenScope);
Log.i(TAG, "token deleted successfully");
} catch (ApiException e) {
Log.e(TAG, "delete token failed." + e);
}
}
}.start();
} “Kotlin”
private fun deleteToken() {
// 创建一个新线程
object : Thread() {
override fun run() {
try {
// 从agconnect-services.json文件中读取appId
val appId = "your APP_ID"
// 输入token标识"HCM"
val tokenScope = "HCM"
// 注销token
HmsInstanceId.getInstance(this@MainActivity).deleteToken(appId, tokenScope)
Log.i(TAG, "token deleted successfully")
} catch (e: ApiException) {
Log.e(TAG, "delete token failed, $e")
}
}
}.start()
} Push SDK 4.0版本开始提供了自动生成AAID和获取Push Token的能力。配置本能力后,不需要显式的调用getToken申请Push Token,Push Token以onNewToken回调的方式返回。设置自动初始化的方式如下:
在主Activity类中显式调用setAutoInitEnabled方法,参数enable表示是否启用自动初始化,取值为true或false。该参数值会保存在应用本地的“shared_prefs”目录下的文件中。
“Java” private void setAutoInitEnabled(final boolean isEnable) { if(isEnable){ // 设置自动初始化 HmsMessaging.getInstance(this).setAutoInitEnabled(true); } else { // 禁止自动初始化 HmsMessaging.getInstance(this).setAutoInitEnabled(false); } }
“Kotlin”
private fun setAutoInitEnabled(isEnable: Boolean) {
if (isEnable) {
// 设置自动初始化
HmsMessaging.getInstance(this).isAutoInitEnabled = true
} else {
// 禁止自动初始化
HmsMessaging.getInstance(this).isAutoInitEnabled = false
}
}