ヘルプセンター HealthyApps
日本語
ヘルプセンター
メインサイト ↗

ヘルプを検索

MQTT へ Apple Health データを同期

ヘルスデータを MQTT ブローカーに公開します。

最終更新: 2026年10月31日

このページの内容
自動化を開く名前、状態、通知接続のセットアップ
データタイプ設定 データタイプ設定 ヘルス指標ワークアウト
エクスポート設定 エクスポート設定 エクスポートバージョン日付範囲データの要約と時間グループ化
スケジュールリマインダー同期間隔と保存履歴または漏れたデータをエクスポートするトラブルシューティング

ヘルスエクスポートを JSON として MQTT ブローカーのトピックに公開します。

重要 — 自動化の制限事項: ヘルスデータを読み取るにはデバイスのロック解除が必要で、iOS は選んだ頻度でのバックグラウンド実行を保証しません。自動エクスポートに頼る前に 自動化の制限事項 を確認してください。

自動化を開く

iPhone では エクスポート → 自動化 を、iPad ではサイドバーの 自動化 を開きます。新規自動化 を選ぶか、既存の自動化を開いて編集します。

名前、状態、通知

この自動化を識別する名前を入力します。有効 は自動実行を許可します。準備ができるまではオフのままにします。

必要な実行通知を選びます:

  • キャッシュ更新時に通知 はエクスポートデータの準備完了を報告します。
  • 実行時に通知 はブローカーへの公開成功を報告します。

求められたら通知を許可します。これらの通知はアクティビティを報告するだけで、実行をスケジュールしません。

接続のセットアップ

  1. 自動化の種類 として MQTT を選びます。
  2. ブローカーのホスト名または IP アドレスとポートを入力します。デフォルトポートは 1883 です。
  3. トピック を入力します(例: health/metrics)。
  4. 各自動化に一意の クライアント ID を設定し、ブローカーが要求する場合はユーザー名とパスワードを入力します。

ブローカーはデバイスから到達可能である必要があります。購読者は大文字小文字を含め、正確なトピックを使う必要があります。クライアント ID の再利用は、ブローカー接続が互いに置き換わる原因になります。

データタイプ設定

この自動化の データタイプ を 1 つ選びます: ヘルス指標、ワークアウト、症状、ECG、心拍数通知、心の状態、周期トラッキング、または薬。心の状態は iOS 18 以降、薬は iOS 26 以降と個別の薬アクセスが必要です。

ヘルス指標

ヘルス指標 を選び、ヘルス指標を選択 を開いて必要な測定値を選びます。

特定のアプリやデバイスの測定値に限定するには、優先ソース を開き、指標を選んでソースを選択します。すべて は除外されていないすべてのソースを許可します。除外ソース で、この自動化のヘルス指標全体からソースを無視できます。除外が優先されます。優先ソースにデータがない場合でも、未選択のソースは代用されません。保存 でソース選択を適用し、キャンセル で破棄します。

ワークアウト

ワークアウト を選ぶと、ワークアウト記録をエクスポートします。ルートデータを含める は利用可能なルートポイントを JSON ワークアウトデータに追加します。別個の GPX アップロードは作成しません。

バージョン 2 では、ワークアウト指標を含める をオンにして心拍数、アクティブエネルギー、歩数などの測定値を追加します。ワークアウト指標の 時間グループ化 で 分 または 秒 を選びます。秒の方が詳細でエクスポートが大きくなります。バージョン 1 は常にワークアウト指標を含めます。

エクスポート設定

MQTT は JSON のみを公開します。メッセージはフォアグラウンド公開で QoS 0、バックグラウンド公開で QoS 1 を使います。メッセージは保持されません。

エクスポートバージョン

現在のデータ構造には バージョン 2 を選びます。既存のワークフローが古い形式に依存する場合は バージョン 1 を使います。

日付範囲

選択 含まれるデータ
デフォルト 前日と、実行時刻までの本日
前回の同期以降 前回の同期から実行時刻まで
今日 実行時刻までの本日
昨日 直前の 1 全日
過去 7 日 直前の 7 全日

データの要約と時間グループ化

JSON + ヘルス指標 では、データを要約 をオンにして測定値を時間グループにまとめるか、対応する場合はオフにして個別測定値にします。要約は指標によって異なります。たとえば歩数は合計され、体重の測定値は平均されます。CSV のヘルス指標エクスポートは要約データを使います。

時間グループ化 が利用できる場合は、保持する詳細度を選びます。時間または日のグループは、分または秒のグループより行数が少なくなります。利用できる選択肢は日付範囲と形式によって異なります。ワークアウトの時間グループ化はワークアウト設定で別途行います。

スケジュールリマインダー

ロック解除とアプリ起動の促しが必要な場合は、リマインダーを有効にする をオンにします。毎時、毎日、または 選択した曜日 を選び、必要に応じて分、時刻、曜日を設定します。求められたら通知アクセスを許可し、拒否されている場合は 通知設定を開く を使います。

リマインダーは自動化を実行せず、同期成功も確認しません。タップして自動化を開くか、通知の 開いて同期 で実行を要求します。自動化は有効である必要があります。成功したバックグラウンド実行のあともリマインダーが表示されることがあります。リマインダーの変更は保存時に適用されます。

同期間隔と保存

同期間隔 で数値と 分、時間、日、または 週 を選びます(例: 15 分ごと)。これは希望するバックグラウンドの間隔であり、保証されたスケジュールではありません。

ヘルスデータの読み取り時はデバイスのロック解除が必要です。Health Auto Export のバックグラウンド App の更新を有効にし、自動実行のため低電力モードをオフにします。デバイスが非アクティブだった場合やシステムリソースが限られている場合、iOS が実行を遅らせることがあります。

自動実行の準備ができたら 有効 をオンにし、更新 で自動化を保存します。下記の手順ですぐに選択した日付範囲をアップロードできます。

履歴または漏れたデータをエクスポートする

自動化の初回設定時に履歴データをエクスポートする、またはあとから自動同期で漏れた日付を補うために 手動アップロード を使います。設定確認にも使えます。

  1. MQTT 購読者をブローカーに接続し、設定したトピックを購読します。
  2. Health Auto Export で自動化を開き、既存データをエクスポート の下で 手動アップロード を選びます。
  3. 開始 と 終了 の日付を設定し、エクスポートを開始 を選びます。
  4. 受信した JSON とその日付を確認します。

ペイロードは JSON エクスポート形式 に従います。例:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

トラブルシューティング

  • 接続失敗: ホスト、ポート、ネットワークアクセス、ブローカーの接続要件を確認します。
  • 認証失敗: 資格情報とトピックへの公開権限を確認します。
  • メッセージがない: 購読者が同じブローカーと正確なトピックを使っていることを確認し、アクティビティログを確認します。
  • メッセージが大きすぎる: 指標を減らし、範囲を短くし、またはより粗い時間グループ化を選びます。

自動化を開き アクティビティログを表示 で実行を確認します。警告 はデータ取得の遅延などの潜在的な問題を示し、エラー は失敗したステップを示します。問題の報告方法は ヘルプを得る を参照してください。