HealthKitにおける心の健康に関するAPIの詳細

HealthKitにおける心の健康に関するAPIの詳細

HealthKitを使用して、心の健康に関する機能をアプリに取り入れる方法をご紹介します。State of Mind APIに加え、Depression Risk APIやAnxiety Risk APIなど、新しいAPIが提供されています。このセッションでは、感情を扱う科学の原則を詳細に検討し、感情を振り返ることのメリットや、State of Mind APIを使用してさまざまなタイプの気分や感情を表す方法を確認します。

関連する章
- 0:00 - Introduction
- 1:28 - Mental wellbeing APIs
- 2:13 - State of Mind API
- 8:54 - State of Mind predicates
リソース
関連ビデオ

WWDC24
- ジャーナルアプリの提案機能を強化
- visionOSでのHealthKitの導入
WWDC20
- HealthKitを始めましょう
ダウンロード

こんにちはヘルスケア担当ソフトウェアエンジニアのLeahです今日は心の健康について説明し HealthKitに新しく追加された心の健康をサポートするAPIをご紹介します同じくヘルスケア担当ソフトウェアエンジニアのMattです私のチームが開発しているアプリにこれらの機能を導入する際のサポートを担当します現代社会において心の健康はこれまで以上に重要で関連性が高くなっています Appleは心の健康を保つうえでは小さな一歩が大きな影響を与えると信じています Appleは昨年心の健康に焦点を当てた一連の機能を発表しユーザーが様々なデバイスで有意義な実践に簡単に取り組めるようになりましたヘルスケアアプリで自らの気持ちを振り返り心の状態を記録することで心の健康状態をトラッキングできます
心の状態の記録は Apple Watchからもできるのでいつでも簡単に確認できます心の健康状態を詳しく確認するために不安やうつに関する標準化された質問票にヘルスケアアプリから回答できますこれらの機能がすでに多くのユーザーに心の健康への投資を促していることを嬉しく思っておりさらに多くの人がこれらのツールの恩恵を受けてほしいと考えています現在これらの体験を支えるデータ型が APIとして提供されています本セッションでは心の健康の背景にある感情を扱う科学について解説し HealthKitでサンプルを読み書きする方法も説明します
まず用語の意味を確認しましょう GAD-7とPHQ-9は Pfizerが公開している標準化された質問票です世界中の医師や臨床医が心の健康に関するスクリーニングに使用しています GAD-7は不安のリスクを評価する 7つの質問で構成されており PHQ-9はうつのリスクを評価する 9つの質問で構成されています今年の機能強化で GAD-7とPHQ-9の不安とうつに関する質問の結果を読み書きできるようになる予定ですこれらの新しいデータ型により治療の有効性を調べたり医師の診察結果を保存したりできますこれらの評価は Pfizerの標準に従って実施されることが重要です詳細についてはデベロッパ向けドキュメントをご覧ください本セッションではここから 3つ目のデータ型である State of Mindについて詳しく見ていきます State of Mindは気分や感情を表現する手段であり各ユーザーの積極的な振り返りが必要です気分と感情の違いは気持ちが生じる期間です感情は一時的なもので数秒から数分持続しますが気分は長期的な感覚であり数時間から数日持続する場合もあります立ち止まって振り返り現在の感情の状態を理解することには多くのメリットがあります不快な感情を抱いている場合は振り返ることでその気持ちを感じる時間を短くすることができます逆に快い感情を抱いている場合にはその感覚を存分に味わい長い間楽しむことができます快不快どちらでもないといった幅広い感情を経験することは正常で健全なことです自分の感情を言葉で表すという実践は感情認識能力や回復力を長期的に高めていくことができます自分の感情をより具体的に説明できればより大きな臨床上のメリットが得られます Appleはこれらの原則を念頭に置き感情を扱う科学の専門家と密接に協力して State of Mind APIを設計しましたその仕組みをご紹介しましょう State of Mindには 4つのパラメータがあります 1つ目のKindは心の状態の種類です日々の気分または一時的な感情で構成されますアプリでどちらを使うかを決める際はその気持ちのコンテキストを考慮し対象となる気持ちが一時的なものか長期的なものかに基づき判断します次のValenceはどれだけ良いか悪いかの感情の程度を自己申告で測定するものです -1から+1までの連続的なスケールで測定されますとても気分が悪い場合は-1に近い値を選び気分が非常に良い場合は +1に近い値を選びます 0に近いニュートラルな値は様々な気持ちに適しています Labelsは心の状態を表現するラベルで情熱を感じている圧倒されている安堵しているなどから選択します非常に多くの選択肢が用意されており心の状態を十分に表すうえで必要なだけいくつでも指定できます
最後のAssociationsは感情の原因を表します家族アイデンティティ仕事などから選択します Labelsと同様に多数の選択肢がありいくつでも指定できます State of Mindは自身の感情の状態を振り返るための方法として開発され臨床上の真のメリットを提供することを目的としていますただしそのユースケースは心の健康のみに重点を置いたアプリに限定されません State of Mindは様々なアプリで使用でき落ち着いて自己を振り返るためのあらゆる用途において有用です短いシンプルなやり取りを通して振り返りとマインドフルネスをあらゆる体験に組み込むことができますあなたならこのAPIをどのようにチームのアプリで使いますか？ State of Mindについてもう少し詳しく学べば新しいAPIを使ってカレンダーイベントに気持ちを関連づけられると思います背景情報として私は時間の使い方を視覚化するアプリに取り組んでいますその取り組みをお見せしましょう現在アプリはオフィスソーシャルメディアワークアウトのすべてのカレンダーイベントを表示していますこのアプリは時間の使い方を視覚化してインサイトを提供します新しいState of Mind APIを使ってさらに高度な機能を提供したいと思います具体的には心の状態を追加してイベントをどう感じたかを表現できるようにしますこの機能を作成してみましょうまず標準のHealthKit認証フローにより State of Mindのサンプルを読み書きするアクセス権をリクエストします健康データはすべてプライバシーと安全性が確保されますまた認証によりユーザー管理と共有するデータの指定ができます認証の詳細については WWDC20の「Getting started with HealthKit」をご覧ください次はアプリの体験です気分や感情は様々な方法で表現できます個人的には絵文字を使うと気持ちを楽しく手軽に表現できると思うので HealthKitに保存できる State of Mindのサンプルに対応する絵文字のセットを使いますまず 5つの絵文字を選びますそれぞれがState of Mindのラベルに対応します次に考えるのは各々をState of Mindのサンプルにどう反映するかです
EmojiTypeという新しい列挙型を作ってみましょうこれにはサンプルの作成に使う各絵文字が含まれます次にカレンダーイベントとEmojiTypeの State of Mindのサンプルを作成する関数を作ります最近のイベントのサンプルを作成しているので気持ちの種類を表すkindには momentaryEmotionを使います次に快不快の程度を表す valenceの値が必要です新しいvalenceプロパティを持つように作成したemojiType列挙型を修正しますこれにより各絵文字が Doubleで表される valenceにマッピングされます
Leahが説明した State of Mindのラベルを確認した後 emojiTypeに labelという別のプロパティを作成し各絵文字用に選んだ State of Mindのラベルを定義します使用するassociationはイベントカレンダーに基づきイベントから推測することもできます例えばオフィスカレンダーは仕事のassociationにマッピングされますこれで HKStateOfMindイニシャライザによるサンプル作成に必要なものがすべて揃いましたサンプルの保存は healthStoreで既存のsaveメソッドを使うだけで済みます
以上ですチームのスタンドアップイベントにも間に合ってとても幸せな気持ちですその気持ちをアプリに保存してみましょうカレンダーイベントをタップすると新しい絵文字ピッカーが表示されるので絵文字を選択しサンプルをHealthKitに保存します簡単ですねアプリではイベントが終わるたびに気持ちを確認するように促しますこれにより感情認識能力や回復力が身につきます誰でも簡単に心の健康状態を把握でき臨床上の真のメリットが得られます - さて他には何ができますか？ - 今からお見せします
State of Mindのログのメリットは気持ちを振り返るきっかけになることだけではありません過去の気持ちを振り返ると非常に多くの情報が得られます傾向を把握できるかもしれません十分な睡眠がとれていないと気分が優れなかったり積極的に運動すると気分が明るくなったりという傾向ですヘルスケアアプリでは時間の経過に伴う気持ちの変化を確認できますまた友人健康趣味といった生活の各領域との関連に着目して比較ができますエクササイズ時間意識的な時間睡眠時間など他のデータ型との比較も表示できます自分の気持ちをより大局的な観点から理解できると生活を大きく変えることにつながります心身両方の健康により気を配れるようになります State of Mindを使うと気持ちに基づいてコンテキストの中で人生の出来事を把握し各ユーザー固有の状況を反映したインサイトを得られます HealthKitに 4つの新しい述語が導入されます Kindによるクエリを実行して感情と気分を区別でき各時点や日を単位として変化をハイライトできます Valenceの述語を使うと快不快の程度に基づいてサンプルを取得できます特定のラベルを持つ State of Mindのサンプルを検索でき落ち着くストレスを感じるなどの感情がどのような時に生じるか把握できます Associationsの述語を使うとデートや趣味など生活の特定の分野に基づき気持ちに対するクエリを実行できますこれらの述語を使うと必要な情報をすばやく得ることができ説得力のあるインサイトの提供に注力できます最高に良い気持ちになる瞬間をハイライトしたり困難な状況にある時にサポートのためのリソースを提供したりできますこれらを使って何ができますか？その質問を待っていましたクエリです現時点でもアプリで時間の使い方に関するインサイトが提供されています State of Mindの特定のサンプルに対しクエリを実行してより詳細なインサイトを得る方法を説明しますタブにはその週のワークライフバランスのスコアが表示されまた最も有意義なイベントもハイライトされますワークライフバランスは日中のイベントの予定と自由時間の割合を測定して計算しますカレンダーの大部分がミーティングの予定で埋まっている場合ワークライフバランスは良くありませんワークライフバランスの指標は有益ですが人生の大局的な理解に役立つ視点の一つに過ぎません例えば忙しい日ほど充実感が得られることもありますしイベントが楽しいアクティビティであることもありますこの指標を向上させる方法の一つがその日の気持ちを考慮に入れることですそれを測定するには各日についてクエリでassociationのある State of Mindのサンプルを取得しますまずアプリのカレンダーイベントに関連する associationのある特定の日付範囲のサンプルをすべて取得するクエリ述語を作成しますそれを新しい stateOfMindPredicateメソッドに渡して述語に一致するサンプルを見つけます次に HealthKitクエリを作成して結果を取得しますその結果を使ってこれらのサンプルのvalenceプロパティをすべて変換して結合し気持ちの指標を表す割合として valenceの平均を求めますこのCalendar Qualityという新しい指標をタブに追加することで 1週間の気持ちをハイライトできるようになりますそれだけではありませんこのアプリはもう1つのインサイトとしてその週で最も有意義なイベントを提示します現在この指標はその週で最も長いカレンダーイベントをクエリして計算していますよく考えてみると時間の長さではそのイベントの意義を実際に確認することはできません修正しましょう代わりにHealthKitで絵文字ピッカーのいずれかのラベル例えばHappyを取得するクエリを実行しますここではassociationと labelの両方の述語を使って目的のサンプルの型を正確に特定します次に valenceが最も高いサンプルを特定しその期間で一番近いカレンダーイベントを見つけます
これでOKです Happyラベルに加え State of Mindの複数のラベルについてこの手順を行い 1週間の様々なインサイトを示すことができます確実に良くなりますね State of Mindのデータを使ってアプリを強化し気持ちに基づく新たなインサイトを示すことで真にパーソナライズされた体験を実現できますまだ始まったばかりです「Get started with HealthKit in visionOS」ではチームメイトのZachとSirindaが私たちのアプリをVision Proに導入します visionOSの空間キャンバスを活用した体験を HealthKitを使って構築する方法を説明します Vision Proに合わせてアプリの動作を調整する方法も説明しますこれにはゲストユーザーの扱いのサポートも含まれますただ現時点でアプリの状態はだいぶ向上したと思います - あなたはどう思いますか？ - 素晴らしいです 1週間の振り返りとして時間の使い方に加え気持ちを考慮するのは良いアイデアですねすべてのデバイスで心の健康をサポートするために他にも新機能が追加されています「Enhanced suggestions for your journaling app」では同僚のReneがジャーナル記録のパーソナライズされたState of Mindの提案機能を活用する方法を説明します本ビデオでは多くの内容を説明しました State of Mindは感情を扱う科学の原則に基づいており臨床上の真のメリットをもたらしますサンプルの各プロパティはユーザーの気持ちに関する重要な情報を提供しますこれらの新しいAPIにより効果的な体験を簡単に創出できます State of Mindは瞑想や日記その他のマインドフルネスの実践など心の健康の向上に役立つ有用なツールです人は生活のあらゆる場面で様々な気持ちを体験するのでアプリを強化してマインドフルネスをあらゆる体験に取り入れることができます State of Mindをアプリに導入すると説得力のあるインサイトを効果的に提供できます例えば感情の回復力を向上させたりポジティブな瞬間を称えたり生活の中にある重要なパターンを認識する支援ができます最後に留意点をいくつか挙げます心の健康は生活のあらゆる場面で重要ですアプリでの新しいAPIの活用方法を検討してくださいフィードバックアシスタントを使ってご意見をお聞かせくださいヘルスケアと心の健康について詳しくは先ほどご紹介したセッションもご覧ください State of Mindを既存のアプリに組み込むにしても新しいアプリを作るインスピレーションを得るにしてもみなさんがどのようなものを生み出すのかとても楽しみです

5:37 - Request authorization to read and write State of Mind HealthKit samples

// Request authorization to read and write State of Mind HealthKit samples

import HealthKitUI

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

6:26 - EmojiType

// EmojiType

enum EmojiType: CaseIterable {
    case angry
    case sad
    case indifferent
    case satisfied
    case happy
    
    var emoji: String {
        switch self {
        case .angry: return "😡"
        case .sad: return "😢"
        case .indifferent: return "😐"
        case .satisfied: return "😌"
        case .happy: return "😊"
        }
    }
  
}

6:32 - Create State of Mind sample for an event and emoji selection

/// Create State of Mind sample for an event and emoji selection

func createSample(for event: EventModel, emojiType: EmojiType) ->
HKStateOfMind {
    let kind: HKStateOfMind.Kind = .momentaryEmotion
    let valence: Double = emojiType.valence
    let label = emojiType.label
    let association = event.association
    return HKStateOfMind(date: event.endDate,
                         kind: kind,
                         valence: valence,
                         labels: [label],
                         associations: [association])
｝

7:21 - Save State of Mind sample from emoji choice

// Save State of Mind sample from emoji choice

func save(sample: HKSample, healthStore: HKHealthStore) async {
    do {
        try await healthStore.save(sample)
    ｝
    catch {
        // Handle error here.
    }
｝

10:34 - Query State of Mind samples

// Query State of Mind samples

let datePredicate: NSPredicate = { ... }
let associationsPredicate = NSCompoundPredicate (
    orPredicateWithSubpredicates: associations.map {
        HKQuery.predicateForStatesOfMind(with: $0)
    }
)  
let compoundPredicate = NSCompoundPredicate(
    andPredicateWithSubpredicates: [datePredicate, associationsPredicate]
)
let state0fMindPredicate = HKSamplePredicate.stateOfMind(compoundPredicate)

10:49 - Query State of Mind samples

// Query State of Mind samples

let datePredicate: NSPredicate = { ... }
let associationsPredicate = NSCompoundPredicate (
    orPredicateWithSubpredicates: associations.map {
        HKQuery.predicateForStatesOfMind(with: $0)
    }
)  
let compoundPredicate = NSCompoundPredicate(
    andPredicateWithSubpredicates: [datePredicate, associationsPredicate]
)
let stateOfMindPredicate = HKSamplePredicate.stateOfMind(compoundPredicate)

let descriptor = HKSampleQueryDescriptor(predicates: [stateOfMindPredicate],
                                         sortDescriptors: [])
var results: [HKStateOfMind] = []
do {
    // Launch the query and wait for the results.
    results = try await descriptor.result(for: healthStore)
} catch {
    // Handle error here.
｝

10:54 - Query State of Mind samples (continued)

// Adjust each valence value to be from a range of 0.0 to 2.0.
let adjustedValenceResults = results.map { $0.valence + 1.0 }
// Calculate average valence.
let totalAdjustedValence = adjustedValenceResults.reduce (0.0, +)
let averageAdjustedValence = totalAdjustedValence / Double(results.count)
// Convert valence to percentage.
let adjustedValenceAsPercent = Int(100.0 * (averageAdjustedValence / 2.0))

11:33 - Query for relevant State of Mind samples with a specific label

// Query for relevant State of Mind samples with a specific label
let label: HKStateOfMind.Label = .happy

// Configure the query
let datePredicate = HKQuery.predicateForSamples(withStart: dateInterval.start,
                                                end: dateInterval.end)
let associationPredicate = HKQuery.predicateForStatesOfMind(with: association)
let labelPredicate = HKQuery.predicateForStates0fMind(with: label)
let compoundPredicate = NSCompoundPredicate(
    andPredicateWithSubpredicates: [datePredicate, associationPredicate, labelPredicate]
)
let stateOfMindPredicate = HKSamplePredicate.stateOfMind(compoundPredicate)
let descriptor = HKAnchoredObjectQueryDescriptor(predicates: [state0fMindPredicate],
                                                 anchor: nil)

// Fetch the results
let results = descriptor.results(for: healthStore)
let samples: [HKStateOfMind] = try await results.reduce([]) { $1.addedSamples }

11:45 - Process State of Mind sample data

// Process State of Mind sample data

let happiestSample = samples.max { $0.valence < $1. valence }
let happiestEvent: EventModel? = findClosestEvent(startDate: happiestSample?.startDate,
                                                  endDate: happiestSample?.endDate)

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

関連する章

リソース

関連ビデオ

WWDC24

WWDC20