开始在 visionOS 中使用 HealthKit

探索如何使用 HealthKit 打造能够充分发挥空间画布优势的精彩体验。了解适用于 visionOS 的 HealthKit 功能，探索如何将现有 iPadOS App 移植到 visionOS，并了解有关在客人用户会话期间管理 HealthKit 的特别注意事项。你还将学习如何将 HealthKit 与 SwiftUI、Swift Charts 和 Swift 并发搭配使用，来打造创新满满的用户体验。

章节

资源

相关视频

下载

大家好欢迎各位我叫 Zach 我叫 Sirinda 我们是从事 visionOS 健康体验开发的工程师大家可能都知道 HealthKit 提供了一个集中式加密储存库用于储存用户的健康数据在获得许可的情况下你可以访问这些数据以便打造有助于用户增进健康和保持健康的体验

HealthKit 的功能包括查询和写入健康数据以及汇总和计算一段时间内的统计数据你也可以注册 App 以便在数据发生变化时在前台或后台接收更新 HealthKit 中可以储存众多健康领域的数据包括活动、心脏和睡眠以及临床健康记录例如免疫接种和手术如需进一步了解 HealthKit 请参考我们 2020 年的讲座 “开始使用 HealthKit” 去年随着 iPadOS 17 的发布我们将 HealthKit 引入一个新平台让大家能够在 iPad 上利用储存在 HealthKit 中的数据打造丰富的体验供用户探索比如这个 App“Rise” 没错！而现在随着 visionOS 2 的推出在 Apple Vision Pro 上也可以使用 HealthKit 了空间计算解锁了令人兴奋的可能性让大家有机会构建多种沉浸式和协作式健康体验我们很高兴能够向大家展示为 visionOS 构建由 HealthKit 提供支持的 App 有多么简单在本次讲座中我们将介绍 visionOS 中的 HealthKit 功能然后我们将演示一些方法大家可以采用这些方法来打造完美融入共享空间的体验最后我们将讨论 visionOS 的客人用户功能以及 HealthKit 面向客人用户的运行方式我们首先看看这个框架在新平台上的功能 HealthKit 在 visionOS 中的运行方式与在 iPadOS 中非常相似你的 App 可以读取和写入数据计算统计数据还可以注册以获取更新此外还需要注意以下几件事情与在其他平台上一样用户可以在“设置”App 中查看和编辑每个 App 的健康数据授权用户可通过 iCloud 定期在不同设备间进行数据同步

visionOS 中的 HealthKit 适用于使用 visionOS SDK 的 App 以及针对 iOS 17 或更高版本编译的 iPadOS App 在今天的讲座中我们将开发一款 App 让你能够使用新的 HealthKit 心理状态 API 来记录与日历事件相对应的情绪我想让这款 App 登陆 visionOS 要进一步了解如何使用心理状态 API 请观看今年的讲座 “探索 HealthKit 中的身心健康 API”

我们来了解一下基础知识在采用 HealthKit 时至关重要的一点是你的 App 必须检查健康数据是否可用这可能会因设备和操作系统版本等因素而异如果你希望继续支持之前的 visionOS 版本可以使用 isHealthDataAvailable 函数来相应调整 App 的体验检查完健康数据是否可用后接下来必须请求用户授权以读取或写入 App 需要处理的数据类型

healthDataAccessRequest 函数将触发一条提示请求用户向 App 授予健康数据访问权限最好仅请求你需要的权限并且仅在 App 需要时提出请求

遵循接下来介绍的最佳做法可以非常轻松地更新 iPadOS App 让它能在 visionOS 上运行事实上你什么都不用做！因为我的 App 会使用我列出的 API 来检查健康数据的可用性如果我针对 iOS 17 或更高版本进行编译那么这个 App 无需进行更新即可在 visionOS 2.0 上提供 “专为 iPad 设计”的体验这为我提供了一个绝佳的起点接下来交给 Sirinda 由她为大家介绍一些最佳做法如果你有意开发需要利用空间计算的 HealthKit App 就应该考虑这些最佳做法

谢谢 Zach 我想展示一下为 visionOS 设计 App 有多么简单首先我要确保我们的 App 采用 visionOS 的设计模式和交互模式以便充分利用这个平台的优势还要寻找机会来完善和提升我们的体验以便显示更多信息并在显示的健康数据中增添细微差异

然后花一点时间来寻找灵感设法以更胜以往的方式让 visionOS 上的 HealthKit 体验真正大放异彩我们开始吧

首先我要添加 visionOS 作为 App 的目标平台这样就可以在 visionOS 上运行我们的 App 了选取 Designed for iPad 就可以实现 Zach 刚才演示的体验今天我要选取 Apple Vision 以充分利用 visionOS SDK

我们的 App 将使用与 iPadOS 相同的 HealthKit 数据授权配置搞定！如需进一步了解如何让现有的 App 登陆 visionOS 请观看讲座“将你的窗口 App 提升至空间计算领域” 好了！现在我已经针对 visionOS 构建了我们的 App 它会自动采用标准系统外观 TabView 和 Sheets 等标准 SwiftUI 组件可以完美地转化到 visionOS 上由于健康数据可以跨设备同步现在可以在 Apple Vision Pro 上查看相同的图表和见解由于我们的见解是使用 Swift Charts 配置的因此看起来已经很棒了现在我们的 App 看起来完美适应这个平台接下来我们探索一下如何利用这幅无限宽广的空间画布我已经做了一些更改来提升 visionOS 上的使用体验在这个标签中我让图表可动态调整大小这样一来当我使用“捏合并拖移” 手势展开 App 窗口时就能一目了然地查看更多数据

为此我要使用今年新推出的 SwiftUI API onGeometryChange 来观察图表大小的变化我可以通过增加图表点的数量来响应更大的视图

由于空间画布上还有剩余位置何不将两个图表并排放在一起进行比较？幸好添加多窗口支持非常简单因为我的 iPad App 已经支持分屏浏览了要进一步了解如何配置多窗口支持请查看讲座备注中链接的文档我在代码中创建了一个 Button 它可以使用新图表对应的标识符来调用 openWindow 操作这个操作会在新窗口中打开图表我们还可以实现更多功能！打造完全沉浸式的空间体验非常简单不必重写整个 App

例如我想重新设计情绪记录体验以便充分利用 visionOS 的沉浸式功能假设我刚刚结束了一场集体讨论会议想要反思一下自己的感受

借助 Apple Vision Pro 我可以进入一个沉浸式空间其他 App 处于隐藏状态周围环境透视也会变暗从而营造出一种与工作空间隔离的感觉借助这种不受干扰的方式我可以通过多姿多彩的沉浸式体验来反思最近的日历活动

轻点 Save to HealthKit 后透视的颜色会变淡我的 App 会重新显示这样就可以回到上次离开的位置继续进行得益于所有这些更新我们的 App 能够完美适应 visionOS 我们增强了现有的体验甚至还打造了一些全新体验很好现在你的 App 已经针对 visionOS 进行了自定你还需要做一件事这件事与客人用户有关

客人用户是 visionOS 的一项功能允许其他人设置和试用 Apple Vision Pro 这是体验空间计算的绝佳方式并且提供了能够保护所有者数据和隐私的功能如需详细了解客人用户功能请查看 Apple 支持提供的文章 “让其他人使用你的 Apple Vision Pro”

在客人用户会话期间客人可以使用所有者授权的 App 在大多数情况下使用体验不会变化但在使用 HealthKit 时有一些特别的注意事项如果 App 已经获得了授权则在客人运行 App 时 App 仍然可以访问 HealthKit 数据但是 App 无法向客人请求额外的 HealthKit 授权而且如果提出这样的请求系统也不会显示授权流程而是会返回错误此外客人也无法在 visionOS 设置中编辑授权、隐私或安全选项此外以客人用户身份与健康数据交互时在数据写入方面也存在一项限制在客人用户会话期间无法将健康数据写入 HealthKit 这是为了防止客人生成的数据与所有者的健康数据混淆如果 App 在客人用户会话期间尝试写入数据则 HealthKit 会返回新的错误通过处理这个错误你可以安全地丢弃客人生成的数据确保稍后不会将这些数据存储到所有者的健康数据储存库在这里也可以触发提醒向客人说明数据未保存感谢你详细介绍客人用户功能更新 App 时要牢记这些注意事项正如 Zach 提到的系统不会向客人显示授权表单这意味着在客人用户会话期间对 healthDataAccessRequest 的任何调用都会失败并返回错误我们建议将请求推迟到以后此外客人用户可能还会尝试写入数据但是样本将无法保存到健康数据储存库因此我更新了收到错误信息时的现有处理逻辑正如 Zach 所说收到这条错误信息时我们建议丢弃由客人生成的健康数据样本最后我们需要通知客人用户他们的数据未保存这段代码让用户能够选取一种情绪在这里我修改了这个按钮这样一来每次在客人尝试记录情绪而跳出错误时都会显示一条提醒现在我们已经对 App 进行了配置以便为客人用户提供顺畅无缝的体验接下来我们要确保这些更改能起到预期的效果当我以客人用户身份打开 App 时我不会看到任何健康数据授权提示这是因为客人在运行 App 时会继承所有者给予的授权因此我可以获得和所有者相同的 App 使用体验但是如果尝试记录情绪轻点这个事件然后进行选择完成操作后系统会显示一条提醒通知我以客人用户身份生成的数据未保存这种处理错误的方式能让客人体验 App 的功能同时可以避免将客人的数据添加到所有者的健康数据储存库中现在我已经对 App 进行了配置以便处理客人用户功能接下来我要在 Apple Vision Pro 中与朋友和家人共享我的 App 请牢记以下几项最佳做法客人用户无法进行健康数据访问授权因此请务必更新你的授权调用以便妥善处理这一错误

请务必丢弃客人用户尝试写入的任何健康数据这有助于防止客人生成的数据与所有者的健康数据混淆最后请记住如果所有者已经对 App 进行了授权则 App 可以继续读取健康数据遵循上述最佳做法对于确保客人用户和所有者都能始终享有顺畅无缝的体验至关重要！谢谢 Sirinda 说得太好了总结一下 HealthKit 即将登陆 visionOS 在这个新平台上支持健康数据的读取、写入和观察在 visionOS 上采用 HealthKit 时请借此机会完善并重新设计 App 体验以便充分利用空间计算别忘了根据 HealthKit 面向客人用户的运行方式调整代码如需了解更多信息可以观看以下讲座此外请务必下载我们的示例 App 以查看示例代码我们很高兴能够将 HealthKit 引入 visionOS 期待看到大家构建的各种精彩体验感谢各位的参与！

2:43 - Check whether health data is available

import HealthKit

if HKHealthStore.isHealthDataAvailable() {
    // Configure HealthKit-powered experiences
} else {
    // Omit HealthKit experiences
}

3:03 - Request authorization to read or write data

import HealthKitUI
import SwiftUI

func healthDataAccessRequest(
    store: HKHealthStore,
    shareTypes: Set<HKSampleType>,
    readTypes: Set<HKObjectType>? = nil,
    trigger: some Equatable,
    completion: @escaping (Result<Bool, any Error>) -> Void
) -> some View

5:59 - Update number of chart points based on chart’s size

// Update number of chart points based on chart’s size

import SwiftUI
import HealthKit
import Charts

struct ChartView: View {
    @State var chartBinCount: Int

    var body: some View {
        Chart { ...
            // Chart body
        }
        .onGeometryChange(for: Int.self) { proxy in // Observe for changes to the chart’s size
            Int(proxy.size.width / 80) // 80 points per chart point
        } action: { newValue in
            // Update the number of chart points
            chartBinCount = newValue        
        }
    }
}

6:33 - Open chart as a new window

// Opens chart as a new window
    
struct NewChartViewerButton: View {
    @Environment(\.openWindow) private var openWindow

    var body: some View {
        Button("Open In New Window", systemImage: "plus.rectangle.on.rectangle") {
            openWindow(id: "chart-viewer-window")
        }
    }
}

9:00 - HealthKit returns a new error if a write is attempted during a Guest User session

let sample = HKStateOfMind(date: date, kind: .momentaryEmotion, valence: valence,
                           labels: [label], associations: [association])
do {
    try await healthStore.save(sample)
} catch {
    switch error {
    case HKError.errorNotPermissibleForGuestUserMode:
        // Drop data generated in a Guest User session
    default:
        // Existing error handling
    }
}

9:26 - Request authorization to State of Mind datatype

// Request authorization to State of Mind datatype

@main
struct HKStateOfMindDataSampleApp: App {
    @State var toggleHealthDataAuthorization = false
    @State var healthDataAuthorized: Bool?
    
    var body: some Scene {
        WindowGroup {
            TabView { ... }
                .healthDataAccessRequest(store: healthStore,
                                         shareTypes: [.stateOfMindType()],
                                         readTypes: [.stateOfMindType()],
                                         trigger: toggleHealthDataAuthorization) { result in
                    switch result {
                    case .success: healthDataAuthorized = true
                    case .failure(let error as HKError):
                        switch (error.code) {
                        case .errorNotPermissibleForGuestUserMode:
                            // Defer requests for a later time
                        default:
                            // Existing error handling
                        }
                        ...
                    }
                }
        }
    }
}

9:42 - Save a State of Mind sample from an emoji type

// Saves a State of Mind sample from an emoji type 
public func saveSample(date: Date,
                       association: HKStateOfMind.Association,
                       healthStore: HKHealthStore,
                       didError: Binding<Bool>) async -> SaveDetails? {
    do {
        let sample = createSample(date: date, association: association)
        try await healthStore.save(sample)
    } catch {
        switch error {
        case HKError.errorNotPermissibleForGuestUserMode:
            // Drop data you generate in a Guest User session.
            didError.wrappedValue = true
            return SaveDetails(errorString: "Health data is not saved for Guest Users.")
        default:
            // Existing error handling.
            didError.wrappedValue = true
            return SaveDetails(errorString: "Health data could not be saved: \(error)")
        }
    }
...

9:58 - Present an alert with a message using the given details

// Present an alert with a message using the given details

struct EventView: View {
    @State private var showAlert: Bool = false
    @State private var saveDetails: EmojiType.SaveDetails? = nil

    var body: some View {
        EmojiPicker()
            .alert("Unable to Save Health Data",
                   isPresented: $showAlert,
                   presenting: saveDetails,
                   actions: { _ in }, // default OK button
                   message: { details in
                Text(details.errorString)
            })
   }
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

开始在 visionOS 中使用 HealthKit

章节

资源

相关视频

WWDC24

WWDC23

WWDC20