# Samsung Health 到 FHIR

> 通过 Health Connect 或 Samsung Health Data SDK 获取 Galaxy Watch 数据：真实对比、合作伙伴审批、开发者模式和 FHIR 映射。

Source: https://developers.anpheros.com/zh/guides/samsung-health-fhir

**Galaxy Watch 和 Galaxy Ring 的数据由手机上的 Samsung Health 应用记录，有两种读取方式：通过 Health Connect，Samsung Health 会按自己的计划导出部分数据；或者直接使用 Samsung Health Data SDK，它可以读取 Samsung Health 显示的所有数据，但在应用发布前需要 Samsung 的合作伙伴审批。** 无论您选择哪种方式，这些值都会像 Apple Health 或 Health Connect 数据一样，转换为 FHIR R4 Observations。本页将通过真实手机的测量数据对比这两种方式，并解释每种方式的要求。

## 两种途径

| | 通过 Health Connect | Samsung Health Data SDK |
|---|---|---|
| 读取内容 | Samsung Health 导出到 Health Connect 的内容 | Samsung Health 中的数据：步数、心率、睡眠、血氧、血压、血糖、身体成分、皮肤温度、运动、营养、水分等 |
| 新鲜度 | Samsung Health 导出时，可能存在延迟 | Samsung Health 当前的数据 |
| 要求 | Health Connect 权限，Play Console 声明 | Android 10 (API 29) 或更高版本，Samsung Health 6.30.2 或更高版本，三星设备（不支持模拟器） |
| 发布前 | Google Play 对 Health Connect 声明的审核 | **三星合作伙伴请求和批准**；在此之前，SDK 仅在三星 Health 的开发者模式下可用 |
| 在其他手机上使用相同代码 | 是：一次集成即可用于三星、Pixel、Fitbit、Garmin、Oura | 否：仅限三星设备 |

来源：[Samsung Health Data SDK overview](https://developer.samsung.com/health/data/overview.html) 和 [process](https://developer.samsung.com/health/data/process.html)。

## 在 Galaxy 手机上测量的结果

在构建 Anpheros Daily 时，我们于 2026 年 9 月 27 日同一时间，在一台配有 Galaxy Watch 的 Galaxy S26 Ultra 上比较了两种路径：

| 来源 | 当天步数 | 其他可用数据类型 |
|---|---|---|
| Samsung Health 应用（屏幕显示） | 4,566 | 心率、睡眠、血氧 |
| Health Connect，由 Samsung Health 写入的数据 | 3,211 | 无：仅导出了步数，最后一次批量导出约在 90 分钟前 |
| Samsung Health Data SDK | 4,566 | 当天测试的数据类型是步数；后续测试以同样方式读取了心率、睡眠和锻炼数据 |

Samsung Health 在 Health Connect 中拥有所有写入权限；它只是导出的数据量较少，且导出时间较晚。这只是一个手机和一天的数据，并非规则，但它与用户反馈一致：如果您的用户拥有 Galaxy 手表，并在您的应用和 Samsung Health 中看到不同的数字，那么 Health Connect 路径很可能是原因所在，而应用无法强制 Samsung Health 更频繁地导出数据。

## 使用 SDK 进行测试，直至获得批准

Samsung Health Data SDK 会与 Samsung 确认您的应用（包名和签名证书）是否已获得批准。在获得批准之前：

1. 在测试手机上，打开 Samsung Health › Settings › About Samsung Health，然后反复点击版本号，直到出现开发者选项，然后开启 **Samsung Health Data SDK 的开发者模式**。
2. 您的应用随后便可以读取该手机上的数据。如果没有开启开发者模式，SDK 将会因授权错误而拒绝访问，因此请确保提供 Health Connect 的回退方案。

开发者模式仅用于测试，不应要求用户启用。要发布应用，请向 Samsung 提交合作伙伴请求；获得批准后，Samsung 会注册您的包名和签名。

## 从 Samsung Health 到 FHIR

映射与其他健康存储相同：

| Samsung Health 数据 | LOINC | UCUM |
|---|---|---|
| 步数（每日总计） | 41950-7 | `{steps}` |
| 心率（每日平均、最低、最高） | 8867-4 | `/min` |
| 血氧 | 59408-5 | `%` |
| 睡眠时长和阶段 | 93832-4; 93831-6, 93830-8, 93829-0 | `min` |
| 血压 | 85354-9 with 8480-6 and 8462-4 | `mm[Hg]` |
| 血糖 | 2339-0 | `mg/dL` |
| 体重 | 29463-7 | `kg` |
| 皮肤温度 | 没有通用的腕部温度 LOINC 代码；请使用您自己的代码，并且不要将其标记为体温 | `Cel` |

有两个细节很重要。Samsung Health Data SDK 返回的血糖单位是 mmol/L；请进行转换（Anpheros Daily 存储 mg/dL）或保留报告的单位，但切勿在同一代码下混合使用单位。腕部或皮肤温度不是体温：将其记录在 8310-5 下会误导任何阅读记录的人。

为每个人、每项指标和每一天编写一个 Observation，标记为设备数据，并在同一天再次同步时进行更新。在平台上运行的后端代码位于 [Wearable data in FHIR](https://developers.anpheros.com/zh/guides/wearable-data-fhir)。

## 选择路径

- **大多数应用：** 从 Health Connect 开始。它通过一次集成覆盖了三星和其他所有 Android 厂商，并且存在的不足是三星健康的数据导出行为，而不是您的代码。
- **需要 Galaxy Watch 数据与 Samsung Health 完全一致的应用**（例如步数挑战、人们与三星应用比较的心率趋势）：在三星设备上添加 Samsung Health Data SDK，尽早申请合作，并将 Health Connect 作为备用方案。请仅从一个来源读取每种类型的数据，否则记录将出现重复。

## Anpheros 的定位

Anpheros 平台存储结果 — 每个值都以 FHIR R4 Observation 的形式标记为设备数据，并包含同意、来源和访问日志 — 而不读取 Samsung Health 本身。Anpheros 自有的应用程序 **Anpheros Daily** 通过 Health Connect 读取 Android 上的 Samsung Health 数据，如上所述。

## 常见问题解答

### Samsung Health 是否与 Health Connect 同步？
是的，当用户允许时，Samsung Health 会写入 Health Connect。但它会导出部分类型的数据，并且有自己的同步计划，因此 Health Connect 可能滞后或错过 Samsung Health 显示的某些类型。

### 是否有 Samsung Health REST API？
没有公开的 REST 或 Web API 可以读取用户的 Samsung Health 数据。数据在手机上通过 Health Connect 或 Samsung Health Data SDK 读取，然后您的应用将其发送到服务器。

### 使用 Samsung Health Data SDK 是否需要三星的批准？
发布时需要：三星要求在分发前提交合作伙伴申请并注册已批准的应用。开发阶段，Samsung Health 的开发者模式允许 SDK 在测试手机上运行。

### 我可以在 iPhone 上读取 Galaxy Watch 数据吗？
Galaxy Watch 是为 Android 手机设计的，并将数据记录到 Samsung Health 中；没有支持的路径可以将 Galaxy Watch 的数据导入 Apple Health。

### 为什么我的应用中 Galaxy Watch 的步数比 Samsung Health 中低？
如果您通过 Health Connect 读取数据，Samsung Health 可能尚未导出其最新数据。读取 Health Connect 的聚合总数，在您的应用打开时进行同步，并在必要时添加 Samsung Health Data SDK，可以缩小差距。

## 相关

- [FHIR 中的可穿戴设备数据](https://developers.anpheros.com/zh/guides/wearable-data-fhir)：映射表和后端代码
- [Health Connect 到 FHIR](https://developers.anpheros.com/zh/guides/health-connect-fhir)
- [Apple Health (HealthKit) 到 FHIR](https://developers.anpheros.com/zh/guides/apple-health-fhir)
- [如何构建个人健康记录应用](https://developers.anpheros.com/zh/guides/personal-health-record-app)