目录

HUAWEI Push Kit主题消息传递功能可让开发者将消息发送至已经选择加入特定主题的多台设备。开发者可以根据需要撰写主题消息，HUAWEI Push负责将消息可靠地传送至正确的设备。

例如，某个天气预报应用的用户可选择加入“天气”主题，并接收关于本地最佳除害虫天气的通知。喜欢旅游的用户可以订阅一些旅游线路，旅游指南等旅游信息。

关于主题，请注意以下事项：

开发者要实现按主题发送消息的功能需要完成如下开发步骤：

1、应用主题订阅，既支持客户端订阅，详细请参考客户端主题管理，同时也支持服务端主题订阅，详细请参考服务端主题管理。

2、当开发者订阅完主题后，就可以根据主题发送消息，详细请参考发送主题消息。

1. 客户端主题管理

客户端应用可以订阅任何现有主题，也可创建新主题。当客户端应用订阅新的主题名称尚不存在时，系统会在HUAWEI Push中使用这个名称创建一个新主题，随后任何客户端都可订阅该主题。

若要订阅某个主题，客户端应用需使用 HMS Core Push SDK的 subscribe 方法。此方法会返回一个 Task，完成侦听器可以使用它来确定订阅是否成功。

  1. public void subscribe(String topic) {
  2.     try {
  3.         HmsMessaging.getInstance(context).subscribe(topic).addOnCompleteListener(new OnCompleteListener<Void>() {
  4.             @Override
  5.             public void onComplete(Task<Void> task) {
  6.                 if (task.isSuccessful()) {
  7.                     Log.i(TAG, "subscribe Complete");
  8.                 } else {
  9.                     Log.e(TAG, "subscribe failed: ret=" + task.getException().getMessage());
  10.                 }
  11.             }
  12.         });
  13.     } catch (Exception e) {
  14.         Log.e(TAG, "subscribe failed: exception=" + e.getMessage());
  15.     }
  16. }

若要退订，客户端应用需使用HMS Core Push SDK的 unsubscribe 方法。

  1. public void unsubscribe(String topic) {
  2.     try {
  3.         HmsMessaging.getInstance(context).unsubscribe(topic).addOnCompleteListener(new OnCompleteListener<Void>() {
  4.             @Override
  5.             public void onComplete(Task<Void> task) {
  6.                 if (task.isSuccessful()) {
  7.                     Log.i(TAG, "unsubscribe Complete");
  8.                 } else {
  9.                     Log.e(TAG, "unsubscribe failed: ret=" + task.getException().getMessage());
  10.                 }
  11.             }
  12.         });
  13.     } catch (Exception e) {
  14.         Log.e(TAG, "unsubscribe failed: exception=" + e.getMessage());
  15.     }
  16. }

2. 服务端主题管理

Push服务端给开发者提供了基本的主题管理API，支持一次1000个以内的Token加入或者退出某个主题，同时每个开发者最多只能存在2000个不同的主题。主题与Token的订阅关系生效需等待一分钟，待订阅关系生效后，发送消息时就可以直接通过指向Topic或者组合Topic条件的方式实现消息批量发送。

开发者在服务器上实现主题管理功能，需要完成如下开发步骤：

1、开发者服务器获取接入令牌AccessToken，获取方法请参考：开放平台鉴权-客户端密码模式。

2、开发者服务器调用Push服务端主题订阅API或主题退订API进行应用主题订阅或退订，实现对应用主题的管理。

调用主题订阅API示例：

HTTPS POST方式调用API，https://push-api.cloud.huawei.com/v1/[appid]/topic:subscribe

请求消息头示例：

Authorization: Bearer CV0kkX7yVJZcTi1i+uk…Kp4HGfZXJ5wSH/MwIriqHa9h2q66KSl5

Content-Type: application/json

请求消息体示例：

  1. {
  2.     "topic": "weather",
  3.     "tokenArray": [
  4.         "AOffIB70WGIqdFJWJvwG7SOB...xRVgtbqhESkoJLlW-TKeTjQvzeLm8Up1-3K7",
  5.         "AKk3BMXyo80KlS9AgnpCkk8l...uEUQmD8s1lHQ0yx8We9C47yD58t2s8QkOgnQ"
  6.     ]
  7. }

调用主题退订API示例：

HTTPS POST方式调用API，https://push-api.cloud.huawei.com/v1/[appid]/topic:unsubscribe

请求消息头示例：

Authorization: Bearer CV0kkX7yVJZcTi1i+uk…Kp4HGfZXJ5wSH/MwIriqHa9h2q66KSl5

Content-Type: application/json

请求消息体示例：

  1. {
  2.     "topic": "weather",
  3.     "tokenArray": [
  4.         "AOffIB70WGIqdFJWJvwG7SOB...xRVgtbqhESkoJLlW-TKeTjQvzeLm8Up1-3K7",
  5.         "AKk3BMXyo80KlS9AgnpCkk8l...uEUQmD8s1lHQ0yx8We9C47yD58t2s8QkOgnQ"
  6.     ]
  7. }

3. 发送主题消息

当创建完主题后，开发者就可以根据主题发送Push消息。可以参考服务端开发指导进行功能开发。需要注意的是，基于HTTP协议开发时，消息发送Message结构体中需要指定发送的主题参数topic。

按主题进行消息推送，服务端发送Push消息的请求示例报文：

  1. {
  2.     "validate_only": false,
  3.     "message": {
  4.         "notification": {
  5.             "title": "message title",
  6.             "body": " message body"
  7.         },
  8.         "android": {
  9.             "notification": {
  10.                 "click_action": {
  11.                     "type": 1,
  12.                     "action": "com.huawei.codelabpush.intent.action.test"
  13.                 }
  14.             }
  15.         },
  16.         "topic": "weather"
  17.     }
  18. }

同时华为推送也支持向主题组合发送消息，即指定目标主题的condition条件表达式，示例请参考基于Condition的消息推送。此时需要注意的是，基于HTTP协议开发时，消息发送Message结构体中需要指定发送的主题参数condition。具体conditon条件表达式规范请参考服务端发送Push消息中关于Condition API的描述。