Yardım Merkezi HealthyApps
Türkçe
Yardım Merkezi
Ana web sitesi ↗

Yardım konularını ara

Apple Health Verisini MQTT’ye Senkronize Etme

Sağlık verisini bir MQTT aracısına yayınlayın.

Son güncelleme: 31 Ekim 2026

Bu sayfada
Otomasyonu açmaAd, durum ve bildirimlerBağlantıyı kurma
Veri Türü Ayarları Veri Türü Ayarları Sağlık metrikleriAntrenmanlar
Dışa Aktarma Ayarları Dışa Aktarma Ayarları Dışa Aktarma SürümüTarih AralığıVerileri Özetle ve Zaman Gruplaması
Hatırlatıcıları PlanlaSenkronizasyon Sıklığı ve kaydetmeGeçmiş veya kaçırılan veriyi dışa aktarmaSorun giderme

Sağlık dışa aktarımlarını MQTT aracınızdaki bir konuya JSON olarak yayınlayın.

Önemli — otomasyon sınırlamaları: Sağlık verisini okumak için cihazınızın kilidi açık olmalıdır ve iOS seçtiğiniz sıklıkta arka plan çalıştırmalarını garanti etmez. Otomatik dışa aktarmalara güvenmeden önce Otomasyon Sınırlamaları’nı inceleyin.

Otomasyonu açma

iPhone’da Dışa Aktar → Otomatik’i veya iPad kenar çubuğunda Otomasyonlar’ı açın. Yeni Otomasyon’u seçin veya düzenlemek için mevcut bir otomasyonu açın.

Ad, durum ve bildirimler

Bu otomasyonu tanımlayan bir ad girin. Etkin otomatik çalıştırmalara izin verir; hazır olana kadar kapalı bırakın.

İstediğiniz çalıştırma bildirimlerini seçin:

  • Önbellek Güncellemesinde Bildir dışa aktarma verisinin hazırlandığını bildirir.
  • Çalıştığında Bildir aracıya başarılı bir yayını bildirir.

İstendiğinde bildirimlere izin verin. Bu bildirimler etkinliği bildirir; bir çalıştırmayı zamanlamaz.

Bağlantıyı kurma

  1. Otomasyon Türü olarak MQTT’yi seçin.
  2. Aracınızın ana bilgisayar adını veya IP adresini ve bağlantı noktasını girin. Varsayılan bağlantı noktası 1883’tür.
  3. Konu’yu girin, örneğin health/metrics.
  4. Her otomasyon için benzersiz bir İstemci Kimliği ayarlayın ve aracı gerektiriyorsa kullanıcı adı ile parola girin.

Aracı cihazınızdan erişilebilir olmalıdır. Aboneler büyük/küçük harf dahil tam konuyu kullanmalıdır. Bir istemci kimliğini yeniden kullanmak aracı bağlantılarının birbirinin yerini almasına neden olabilir.

Veri Türü Ayarları

Bu otomasyon için bir Veri Türü seçin: Sağlık Metrikleri, Antrenmanlar, Semptomlar, ECG, Kalp Atış Hızı Bildirimleri, Zihin Durumu, Döngü Takibi veya İlaçlar. Zihin Durumu iOS 18 veya sonrası gerektirir; İlaçlar iOS 26 veya sonrası ve ayrı ilaç erişimi gerektirir.

Sağlık metrikleri

Sağlık Metrikleri’ni seçin, ardından Sağlık Metriklerini Seç’i açın ve ihtiyacınız olan ölçümleri seçin.

Okumaları belirli uygulamalar veya cihazlarla sınırlamak için Tercih Edilen Kaynaklar’ı açın, bir metrik seçin ve kaynaklarını seçin. Tümü, hariç tutulmamış her kaynağa izin verir. Bu otomasyonun sağlık metriklerinde bir kaynağı yok saymak için Hariç Tutulan Kaynaklar’ı kullanın. Hariç tutmalar önceliklidir; tercih edilen kaynakta veri yoksa seçilmemiş bir kaynak yerine konmaz. Kaynak seçimlerini uygulamak için Kaydet’i, iptal etmek için İptal’i seçin.

Antrenmanlar

Antrenman kayıtlarını dışa aktarmak için Antrenmanlar’ı seçin. Rota Verisini Dahil Et JSON antrenman verisine kullanılabilir rota noktalarını ekler. Ayrı GPX yüklemeleri oluşturmaz.

Sürüm 2 için kalp atış hızı, aktif enerji ve adımlar gibi okumalar eklemek üzere Antrenman Metriklerini Dahil Et’i açın. Antrenman metriği Zaman Gruplaması için Dakikalar veya Saniyeler’i seçin; saniyeler daha fazla ayrıntı ve daha büyük dışa aktarmalar üretir. Sürüm 1 her zaman antrenman metriklerini içerir.

Dışa Aktarma Ayarları

MQTT yalnızca JSON yayınlar. İletiler ön plan yayını için QoS 0, arka plan yayını için QoS 1 kullanır. İletiler saklanmaz.

Dışa Aktarma Sürümü

Güncel veri yapısı için Sürüm 2’yi seçin. Mevcut bir iş akışı eski biçime bağlıysa Sürüm 1’i kullanın.

Tarih Aralığı

Seçim Dahil edilen veri
Varsayılan Önceki gün ve çalıştırma zamanına kadar bugün
Son Senkronizasyondan Beri Önceki senkronizasyondan çalıştırma zamanına kadar
Bugün Çalıştırma zamanına kadar bugün
Dün Önceki tam gün
Önceki 7 Gün Önceki yedi tam gün

Verileri Özetle ve Zaman Gruplaması

JSON + Sağlık Metrikleri için okumaları zaman gruplarında birleştirmek üzere Verileri Özetle’yi açın veya desteklendiğinde bireysel okumalar için kapatın. Özet metriğe bağlıdır—örneğin adımlar toplanır ve kilo okumaları ortalanır. CSV sağlık metriği dışa aktarmaları özetlenmiş veri kullanır.

Zaman Gruplaması kullanılabilir olduğunda ne kadar ayrıntı tutulacağını seçin. Saatlik veya günlük gruplar, dakika veya saniye gruplarından daha az satır üretir. Kullanılabilir seçimler tarih aralığına ve biçime bağlıdır. Antrenman zaman gruplaması Antrenmanlar altında ayrı yapılandırılır.

Hatırlatıcıları Planla

Kilidi açıp uygulamayı açmanız için bir istem istiyorsanız Hatırlatıcıları Etkinleştir’i açın. Saatlik, Her Gün veya Seçilen Günler’i seçin, ardından geçerli olan dakika, saat ve günleri ayarlayın. İstendiğinde bildirim erişimine izin verin; erişim reddedilirse Bildirim Ayarlarını Aç’ı kullanın.

Bir hatırlatıcı otomasyonu çalıştırmaz veya başarılı bir senkronizasyonu doğrulamaz. Otomasyonu açmak için ona dokunun veya bir çalıştırma istemek için bildirimde Aç ve Senkronize Et’i kullanın. Otomasyon etkin olmalıdır; başarılı bir arka plan çalıştırmasından sonra da bir hatırlatıcı görünebilir. Hatırlatıcı değişiklikleri kaydettiğinizde uygulanır.

Senkronizasyon Sıklığı ve kaydetme

Senkronizasyon Sıklığı altında bir sayı ve Dakikalar, Saatler, Günler veya Haftalar seçin—örneğin her 15 dakika. Bu istenen bir arka plan ritmidir, garantili bir zamanlama değildir.

Sağlık verisi okunurken cihazınızın kilidi açık olmalıdır. Otomatik çalıştırmalar için Health Auto Export’ta Arka Planda Uygulama Yenileme’yi etkinleştirin ve Düşük Güç Modu’nu kapatın. Cihaz etkin değilse veya sistem kaynakları sınırlıysa iOS çalıştırmaları yine de geciktirebilir.

Otomatik çalıştırmalara hazır olduğunuzda Etkin’i açın, ardından otomasyonu kaydetmek için Güncelle’yi seçin. Aşağıdaki adımlarla seçili bir tarih aralığını hemen yükleyebilirsiniz.

Geçmiş veya kaçırılan veriyi dışa aktarma

Otomasyonu ilk kurduğunuzda geçmiş veriyi dışa aktarmak veya daha sonra otomatik senkronizasyonun kaçırdığı tarihleri kapsamak için Manuel Yükleme’yi kullanın. Kurulumunuzu kontrol etmek için de kullanabilirsiniz.

  1. Aracınıza bir MQTT abonesi bağlayın ve yapılandırılmış konuya abone olun.
  2. Health Auto Export’ta otomasyonu açın ve Mevcut Veriyi Dışa Aktar altında Manuel Yükleme’yi seçin.
  3. Başlangıç ve Bitiş tarihlerini ayarlayın, ardından Dışa Aktarmayı Başlat’ı seçin.
  4. Alınan JSON’u ve tarihlerini kontrol edin.

Yük JSON dışa aktarma biçimini izler. Örneğin:

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

Sorun giderme

  • Bağlantı başarısız: Ana bilgisayarı, bağlantı noktasını, ağ erişimini ve aracı bağlantı gereksinimlerini kontrol edin.
  • Kimlik doğrulama başarısız: Kimlik bilgilerini ve konuya yayınlama iznini kontrol edin.
  • İleti yok: Abonenin aynı aracısı ve tam konuyu kullandığını doğrulayın, ardından Etkinlik Günlüklerini inceleyin.
  • İleti çok büyük: Daha az metrik, daha kısa bir aralık veya daha kaba zaman gruplaması seçin.

Bir çalıştırmayı incelemek için otomasyonu açın ve Etkinlik Günlüklerini Görüntüle’yi seçin. Uyarılar yavaş veri alımı gibi olası sorunları işaret eder; hatalar başarısız adımları belirler. Bir sorunu bildirme konusunda yardım için bkz. Yardım Alma.