数据订阅是运动健康类应用中很常见的功能，用户订阅运动记录、健康记录等数据，当这些数据发生变化时，用户能够即时在App上接收到推送通知。

例如某位用户最近正在锻炼身体，为自己设定了每天走1万步，每周达成3次的目标；常规的数据订阅可以做到每天给用户推送当天步数，但用户需要自己进行二次计算才能得知自己是否完成了本周目标。

而场景事件订阅可以弥补这个缺点。场景事件订阅不仅仅是针对某一种数据类型，而是偏重由一种或者多种数据类型组合起来的场景。还是以上面这个情景为例，一周内有任意3天走到1万步就是一个场景，若用户达成了场景目标，才会收到应用的推送提醒。

![](https://oscimg.oschina.net/oscnet/up-ab8ab4470b06dd988edf963120ad780c373.jpg)
 
华为[运动健康服务](https://developer.huawei.com/consumer/cn/?ha_source=hms1)（Health Kit）不仅支持数据事件订阅，新版本还增加了场景事件订阅能力，让运动健康数据订阅更懂用户。那开发者该如何实现该能力呢？以下是详细的集成步骤。

### 集成方法

#### 一、注册成为订阅者

在联盟卡片申请Health Kit服务时，选择已经创建的产品，勾选注册订阅通知能力。可选择HTTP订阅方式，填写回调通知地址，并通过测试连通性来检查回调地址是否连通。目前只支持企业开发者在Healthkit卡片中开启订阅功能。
 
 ![](https://oscimg.oschina.net/oscnet/up-ed5bcd4e6c6ecd86ce6f896359c178e421d.png)
 
如果你的使用场景满足如下条件，也可以选择端侧订阅方式，填写应用包名与Action：

1. 使用端侧订阅方式

2. 订阅事件类型是场景目标事件

3. 使用apk与apk间信息通知

详细准备步骤可参考[扩展能力服务开发指南](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/extended-introduction-0000001050060843?ha_source=hms1)。

#### 二、注册订阅记录

HTTP请求，请参见[新增/更新订阅记录接口](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/subscriber-records-0000001088575341?ha_source=hms1)

```
POST
https://health-api.cloud.huawei.com/healthkit/v1/subscriptions
```

**请求示例**：

```
POST
https://health-api.cloud.huawei.com/healthkit/v1/subscriptions
```

**请求体**：

```
POST
https://health-api.cloud.huawei.com/healthkit/v1/subscriptions
Content-Type: application/json
Authorization: Bearer ***
x-client-id: ***
x-version: ***
x-caller-trace-id: ***
{
  "subscriberId": "08666998-78f6-46b9-8620-faa06cdbac2b",
  "eventTypes": [
        {
            "type": "SCENARIO_GOAL_EVENT",
            "subType": "ACHIEVE",
            "eventType": "SCENARIO_GOAL_EVENT$ACHIEVE",
            "goalInfo": {
                "createTime": 1654660859105,
                "startDay": 20220608,  // 目标开始计算日期，注意需晚于目标创建日期
                "recurrence": {
                    "unit": 1,  // 周期单位：日
                    "count": 30, // 整个周期30天
                    "expectedAchievedCount": 28
                },
                "goals": [
                    {
                        "goalType": 1,
                        "metricGoal": {
                            "value": 10000, // 设置达标值10000步
                            "fieldName": "steps",
                            "dataType": "com.huawei.continuous.steps.total"
                        }
                    }
                ]
            }
        }
    ]
}
```

#### 三、接收达标事件消息通知

**HTTP请求**，请参见[订阅事件通知接口](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/subscriber-event-0000001076878214?ha_source=hms1)

```
POST
https://www.example.com/healthkit/notifications
```

**请求示例**

```
POST
https://www.example.com/healthkit/notifications
```

**请求体**
```
POST
https://lfhealthdev.hwcloudtest.cn/test/healthkit/notifications
Content-Type: application/json
x-notification-signature: ***
[{
	"appId": "101524371",
	"subscriptionId": "3a82f885-97bf-47f8-84d1-21e558fe6e99",
	"periodIndex": 0,
	"periodStartDay": 20220608,
	"periodEndDay": 20220608,
	"goalAchieve": [{
		"goalType": 1,
		"metricGoal": {
			"value": 10000.0,
			"fieldName": "steps",
			"dataType": "com.huawei.continuous.steps.total"
		},
		"achievedFlag": true //已达标
	}
    ]
}
```

#### 四、若需要查询某个场景事件订阅记录，对应的单周期内的目标达成结果值，可使用如下接口查询。（非必要步骤）

**HTTP请求**，请参见[查询场景事件结果](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/subscriber-event-0000001076878214#section79615203919?ha_source=hms1)。

```
GET
https://health-api.cloud.huawei.com/healthkit/v1/subscriptions/3a82f885-97bf-47f8-84d1-21e558fe6e99/achievedRecord
```

**请求示例**

```
GET
https://health-api.cloud.huawei.com/healthkit/v1/subscriptions/3a82f885-97bf-47f8-84d1-21e558fe6e99/achievedRecord
```

**响应体**

```
HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8
[    
    {
	"openId": "MDFAMTAxNTI0MzcxQGQ0Y2M3N2UxZTVmNjcxNWFkMWQ5Y2JjYjlmZDZiaNTY3QDVhNmNkY2FiaMTFhYzc4NDk4NDI0MzJiaNjg0MzViaYmUyMGEzZjZkNzUzYWVjM2Q5ZTgwYWM5NTgzNmY",
	"appId": "101524371",
	"subscriptionId": "3a82f885-97bf-47f8-84d1-21e558fe6e99",
	"periodIndex": 0,
	"periodStartDay": 20220608,
	"periodEndDay": 20220608,
	"goalAchieve": [{
		"goalType": 1,
		"metricGoal": {
			"value": 10000.0,  // 设定的目标值
			"fieldName": "steps",
			"dataType": "com.huawei.continuous.steps.total"
		},
		"achievedResult": "20023",  // 实际值
		"achievedFlag": true // 已达标标记
	}]
    },
    {
	"openId": "MDFAMTAxNTI0MzcxQGQ0Y2M3N2UxZTVmNjcxNWFkMWQ5Y2JjYjlmZDZiaNTY3QDVhNmNkY2FiaMTFhYzc4NDk4NDI0MzJiaNjg0MzViaYmUyMGEzZjZkNzUzYWVjM2Q5ZTgwYWM5NTgzNmY",
	"appId": "101524371",
	"subscriptionId": "3a82f885-97bf-47f8-84d1-21e558fe6e99",
	"periodIndex": 1,
	"periodStartDay": 20220609,
	"periodEndDay": 20220609,
	"goalAchieve": [{
		"goalType": 1,
		"metricGoal": {
			"value": 10000.0,  // 设定的目标值
			"fieldName": "steps",
			"dataType": "com.huawei.continuous.steps.total"
		},
		"achievedResult": "9800",  // 实际值
		"achievedFlag": false // 未达标标记
	}]
    }
]
```

**了解更多详情>>**

访问[华为开发者联盟官网](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
获取[开发指导文档](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
华为移动服务开源仓库地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**关注我们，第一时间了解 HMS Core 最新技术资讯~**

ITPub博客

运动健康服务场景事件订阅，让应用推送“更懂用户”

最新文章