Pusat bantuan HealthyApps
Bahasa Melayu
Pusat bantuan
Laman utama ↗

Cari topik bantuan

Senaman - Format Eksport JSON

Dokumentasi untuk struktur senaman dalam eksport JSON

Kemas kini terakhir: 31 Oktober 2026

Pada halaman ini
Versi Eksport
Senaman Versi 2 Senaman Versi 2 Struktur AsasMedan WajibMedan PilihanPengumpulan Masa Metrik Senaman
Senaman Versi 1 (Legasi) Senaman Versi 1 (Legasi) Struktur Versi 1
Dokumentasi Berkaitan

Eksport JSON menyimpan senaman dalam tatasusunan workouts.

Versi Eksport

Health Auto Export menyokong dua versi eksport senaman:

  • Versi 2 (Disyorkan): Format yang dipertingkatkan dengan metadata dan data berstruktur yang lebih terperinci
  • Versi 1 (Legasi): Format lama yang dikekalkan untuk keserasian dengan aliran kerja sedia ada

Senaman Versi 2

Versi 2 merangkumi medan wajib berikut dan data pilihan. Contoh menggunakan Setempatkan Unit dimatikan; mendayakannya boleh menukar label unit dalam siri metrik.

Struktur Asas

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "duration": 1800
}

Medan Wajib

  • id (String): Pengecam unik untuk senaman
  • name (String): Nama jenis senaman (cth. "Running", "Cycling", "Swimming")
  • start (Date): Masa mula senaman dalam format yyyy-MM-dd HH:mm:ss Z
  • end (Date): Masa akhir senaman dalam format yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Tempoh senaman dalam saat

Medan Pilihan

Medan pilihan bergantung pada data yang tersedia dan pilihan eksport anda:

Sumber Rakaman

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Aplikasi atau peranti yang merakam senaman, dengan namanya dan pengecam aplikasi. Bacaan metrik individu mempunyai rentetan sumber berasingan dan mungkin datang dari aplikasi atau peranti lain.

Maklumat Lokasi

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): Salah satu daripada "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Sama ada senaman dilakukan di dalam bangunan

Tenaga dan Intensiti

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Kalori aktif yang dibakar semasa senaman
  • totalEnergy (Object): Jumlah kalori (aktif + rehat) yang dibakar
  • intensity (Object): Nilai metabolic equivalent of task (MET)

Jarak dan Kelajuan

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Jumlah jarak yang diliputi
  • speed (Object): Kelajuan purata dikira dari jarak dan tempoh
  • avgSpeed (Object): Kelajuan purata sepanjang senaman
  • maxSpeed (Object): Kelajuan maksimum yang dicapai

Setiap objek termasuk qty dan units.

Elevasi

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Jumlah elevasi yang diperoleh
  • elevationDown (Object): Jumlah elevasi yang hilang

Unit: "ft" (kaki) atau "m" (meter)

Data Persekitaran

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Suhu ambien semasa senaman
  • humidity (Object): Peratusan kelembapan relatif

Unit Suhu: "degF" (Fahrenheit) atau "degC" (Celsius)

Medan Khusus Renang

{
  "lapLength": {
    "qty": 0.025,
    "units": "mi"
  },
  "strokeStyle": "Freestyle",
  "swolfScore": 45,
  "salinity": "Fresh Water",
  "totalSwimmingStrokeCount": {
    "qty": 1200,
    "units": "count"
  },
  "swimCadence": {
    "qty": 30,
    "units": "count/min"
  }
}
  • lapLength (Object): Panjang setiap pusingan
  • strokeStyle (String): Salah satu daripada:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Skor kecekapan renang
  • salinity (String): "Fresh Water" atau "Salt Water"
  • totalSwimmingStrokeCount (Object): Jumlah bilangan kayuhan
  • swimCadence (Object): Kayuhan seminit

Data Langkah dan Kadens

{
  "stepCount": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 5000,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "stepCadence": {
    "qty": 180,
    "units": "count/min"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}
  • stepCount (Array): Tatasusunan ukuran kiraan langkah dari masa ke masa
  • stepCadence (Object): Langkah seminit
  • flightsClimbed (Object): Bilangan tingkat tangga yang didaki

Data Kadar Jantung

{
  "heartRate": {
    "min": {
      "qty": 120,
      "units": "count/min"
    },
    "avg": {
      "qty": 150,
      "units": "count/min"
    },
    "max": {
      "qty": 175,
      "units": "count/min"
    }
  },
  "maxHeartRate": {
    "qty": 175,
    "units": "count/min"
  },
  "avgHeartRate": {
    "qty": 150,
    "units": "count/min"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "Min": 120,
      "Avg": 150,
      "Max": 175,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "heartRateRecovery": [
    {
      "date": "2024-02-06 07:30:00 -0800",
      "Min": 140,
      "Avg": 145,
      "Max": 150,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ]
}
  • heartRate (Object): Ringkasan dengan kadar jantung min, purata, dan maks semasa senaman
  • maxHeartRate (Object): Kadar jantung maksimum semasa senaman
  • avgHeartRate (Object): Kadar jantung purata semasa senaman
  • heartRateData (Array): Ukuran terperinci dari senaman, berakhir apabila senaman berakhir
  • heartRateRecovery (Array): Ukuran berasingan dari dua minit sejurus selepas senaman berakhir

Ringkasan kadar jantung menggunakan nilai senaman yang direkodkan apabila tersedia, kembali kepada bacaan kadar jantung senaman. Bacaan yang dieksport termasuk ukuran yang diambil semasa jeda, jadi puncak dan puratanya mungkin berbeza daripada ringkasan.

Tatasusunan Data Siri Masa

Banyak metrik boleh disertakan sebagai tatasusunan siri masa apabila "Sertakan Metrik Senaman" didayakan:

{
  "activeEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 50,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "basalEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "cyclingCadence": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 90,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "cyclingDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.5,
      "units": "mi",
      "source": "Apple Watch"
    }
  ],
  "cyclingPower": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 200,
      "units": "W",
      "source": "Power Meter"
    }
  ],
  "cyclingSpeed": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 18,
      "units": "mi/hr",
      "source": "Apple Watch"
    }
  ],
  "swimDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 25,
      "units": "yd",
      "source": "Apple Watch"
    }
  ],
  "swimStroke": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "walkingAndRunningDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.25,
      "units": "mi",
      "source": "Apple Watch"
    }
  ]
}

Struktur QuantityData:

  • date (Date): Cap masa ukuran
  • qty (Number): Nilai kuantiti
  • units (String): Unit ukuran
  • source (String, pilihan): Peranti atau aplikasi sumber data

Struktur HeartRateData:

  • date (Date): Cap masa ukuran
  • Min (Number): Kadar jantung minimum
  • Avg (Number): Kadar jantung purata
  • Max (Number): Kadar jantung maksimum
  • units (String): Unit (count/min dengan Setempatkan Unit dimatikan)
  • source (String, pilihan): Peranti atau aplikasi sumber data

Data Laluan

Apabila "Sertakan Data Laluan" didayakan dan senaman mempunyai data GPS:

{
  "route": [
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "altitude": 50.5,
      "course": 45.0,
      "courseAccuracy": 5.0,
      "horizontalAccuracy": 10.0,
      "verticalAccuracy": 15.0,
      "timestamp": "2024-02-06 07:00:00 -0800",
      "speed": 7.0,
      "speedAccuracy": 0.5
    }
  ]
}

Medan Lokasi:

  • latitude (Number): Koordinat latitud GPS
  • longitude (Number): Koordinat longitud GPS
  • altitude (Number): Elevasi dalam meter
  • course (Number): Arah perjalanan dalam darjah (0-360)
  • courseAccuracy (Number): Ketepatan ukuran arah dalam darjah
  • horizontalAccuracy (Number): Ketepatan kedudukan mendatar dalam meter
  • verticalAccuracy (Number): Ketepatan kedudukan menegak dalam meter
  • timestamp (Date): Masa apabila lokasi direkodkan
  • speed (Number): Kelajuan dalam meter sesaat
  • speedAccuracy (Number): Ketepatan ukuran kelajuan dalam m/s

Metadata

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Metadata tersuai tambahan yang dikaitkan dengan senaman

Peristiwa, Aktiviti, dan Split

Eksport JSON dan Markdown Versi 2 mungkin termasuk events, segments, laps, dan activities yang direkodkan oleh aplikasi senaman. Ini kekal tersedia apabila Sertakan Metrik Senaman dimatikan. CSV dan GPX tidak termasuk rekod ini.

Dengan Sertakan Metrik Senaman dihidupkan dan metrik berkaitan dipilih, selang juga mungkin termasuk jarak, tenaga aktif, ringkasan kadar jantung, dan pace atau kelajuan masa aktif. Nilai membezakan ukuran yang direkodkan daripada anggaran; nilai yang tidak tersedia digugurkan.

Dengan jarak dipilih, splits mungkin termasuk anggaran split kilometer dan batu. Ia boleh berbeza daripada split aplikasi rakaman, dan split akhir ditandai separa apabila lebih pendek daripada jarak sasaran. Bacaan jarak yang hilang atau jenis senaman yang tidak disokong boleh menghalang pengiraan split.

Skor Usaha Senaman

Eksport JSON dan Markdown Versi 2 boleh termasuk nilai Skor Usaha Senaman (effortScore) dan Skor Usaha Senaman Dianggarkan (estimatedEffortScore) yang dipilih. Setiap satu ialah objek dengan qty dan units: "appleEffortScore".

Skor memerlukan iOS 18 atau lebih baharu dan akses kepada data sepadan dalam Apple Health. Skor keseluruhan-senaman dan aktiviti adalah berasingan. Ia bebas daripada Pengumpulan Masa dan Sertakan Metrik Senaman; CSV tidak termasuknya.

Dalam Layari → Senaman, buka helaian eksport senarai atau tetapan eksport Versi 2 senaman, kemudian gunakan Pilih Medan Eksport untuk memilih skor usaha sebelum mengeksport.

Pengumpulan Masa Metrik Senaman

Apabila menggunakan Versi Eksport 2 dan "Sertakan Metrik Senaman" didayakan, anda boleh mengawal perincian data siri masa:

  • Minit: Mengumpulkan metrik senaman mengikut minit jam. Minit pertama dan terakhir boleh termasuk beberapa saat sejurus sebelum senaman bermula atau sejurus selepas ia berakhir.
  • Saat: Mengumpulkan metrik senaman mengikut saat jam, dengan setiap cap masa menandakan permulaan saatnya. Saat pertama dan terakhir boleh termasuk pecahan saat di luar senaman. Fail lebih besar daripada pengumpulan minit.

Tenaga aktif dan rehat menggunakan jumlah gabungan yang sama seperti metrik senaman lain dalam setiap kumpulan masa. Bacaan dari lebih daripada satu peranti atau aplikasi disertakan bersama.

Senaman Versi 1 (Legasi)

Versi 1 menggunakan struktur yang lebih ringkas. Untuk eksport baharu, Versi 2 disyorkan.

Struktur Versi 1

{
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "activeEnergy": {
    "qty": 350,
    "units": "kcal"
  },
  "distance": {
    "qty": 3.5,
    "units": "mi"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 150,
      "units": "bpm"
    }
  ],
  "route": [
    {
      "lat": 37.7749,
      "lon": -122.4194,
      "altitude": 50.5,
      "timestamp": "2024-02-06 07:00:00 -0800"
    }
  ]
}

Dokumentasi Berkaitan