Συγχρονισμός δεδομένων Apple Health στο MQTT

Δημοσιεύστε εξαγωγές υγείας ως JSON σε θέμα στον MQTT broker σας.

Σημαντικό — περιορισμοί αυτοματισμών: Η συσκευή σας πρέπει να είναι ξεκλείδωτη για ανάγνωση δεδομένων υγείας και το iOS δεν εγγυάται εκτελέσεις παρασκηνίου στη συχνότητα που επιλέγετε. Ελέγξτε τους Περιορισμούς αυτοματισμών πριν βασιστείτε σε αυτόματες εξαγωγές.

Άνοιγμα του αυτοματισμού

Ανοίξτε Εξαγωγή → Αυτοματοποιημένο σε iPhone ή Αυτοματισμοί στην πλευρική γραμμή iPad. Επιλέξτε Νέος αυτοματισμός ή ανοίξτε υπάρχοντα αυτοματισμό για επεξεργασία.

Όνομα, κατάσταση και ειδοποιήσεις

Εισαγάγετε όνομα που προσδιορίζει αυτόν τον αυτοματισμό. Το Ενεργοποιημένο επιτρέπει αυτόματες εκτελέσεις· αφήστε το απενεργοποιημένο μέχρι να είστε έτοιμοι.

Επιλέξτε τυχόν ειδοποιήσεις εκτέλεσης που θέλετε:

• Το Ειδοποίηση ενημέρωσης προσωρινής αποθήκευσης αναφέρει ότι προετοιμάστηκαν δεδομένα εξαγωγής.
• Το Ειδοποίηση όταν εκτελεστεί αναφέρει επιτυχημένη δημοσίευση στον broker.

Επιτρέψτε ειδοποιήσεις όταν σας ζητηθεί. Αυτές οι ειδοποιήσεις αναφέρουν δραστηριότητα· δεν προγραμματίζουν εκτέλεση.

Ρύθμιση σύνδεσης

1. Επιλέξτε MQTT ως Τύπο αυτοματισμού.
2. Εισαγάγετε το όνομα κεντρικού υπολογιστή ή τη διεύθυνση IP του broker και τη θύρα. Η προεπιλεγμένη θύρα είναι 1883.
3. Εισαγάγετε το Θέμα, για παράδειγμα health/metrics.
4. Ορίστε μοναδικό Αναγνωριστικό πελάτη για κάθε αυτοματισμό και εισαγάγετε όνομα χρήστη και κωδικό πρόσβασης αν το απαιτεί ο broker.

Ο broker πρέπει να είναι προσβάσιμος από τη συσκευή σας. Οι συνδρομητές πρέπει να χρησιμοποιούν το ακριβές θέμα, συμπεριλαμβανομένης της κεφαλαιοποίησης. Η επαναχρησιμοποίηση αναγνωριστικού πελάτη μπορεί να προκαλέσει αντικατάσταση συνδέσεων broker μεταξύ τους.

Ρυθμίσεις τύπου δεδομένων

Επιλέξτε έναν Τύπο δεδομένων για αυτόν τον αυτοματισμό: Μετρήσεις υγείας, Προπονήσεις, Συμπτώματα, ECG, Ειδοποιήσεις καρδιακού ρυθμού, Κατάσταση νου, Παρακολούθηση κύκλου ή Φάρμακα. Η Κατάσταση νου απαιτεί iOS 18 ή νεότερο· τα Φάρμακα απαιτούν iOS 26 ή νεότερο και ξεχωριστή πρόσβαση φαρμάκων.

Μετρήσεις υγείας

Επιλέξτε Μετρήσεις υγείας, μετά ανοίξτε Επιλογή μετρήσεων υγείας και επιλέξτε τις μετρήσεις που χρειάζεστε.

Για περιορισμό των αναγνώσεων σε συγκεκριμένες εφαρμογές ή συσκευές, ανοίξτε Προτιμώμενες πηγές, επιλέξτε μια μέτρηση και επιλέξτε τις πηγές της. Το Όλες επιτρέπει κάθε πηγή που δεν έχει αποκλειστεί. Χρησιμοποιήστε Αποκλεισμένες πηγές για να αγνοήσετε μια πηγή σε όλες τις μετρήσεις υγείας αυτού του αυτοματισμού. Οι αποκλεισμοί έχουν προτεραιότητα· μια μη επιλεγμένη πηγή δεν χρησιμοποιείται ως υποκατάστατο όταν μια προτιμώμενη πηγή δεν έχει δεδομένα. Επιλέξτε Αποθήκευση για εφαρμογή των επιλογών πηγής ή Ακύρωση για απόρριψή τους.

Προπονήσεις

Επιλέξτε Προπονήσεις για εξαγωγή εγγραφών προπόνησης. Το Συμπερίληψη δεδομένων διαδρομής προσθέτει διαθέσιμα σημεία διαδρομής στα δεδομένα προπόνησης JSON. Δεν δημιουργεί ξεχωριστές μεταφορτώσεις GPX.

Για την Έκδοση 2, ενεργοποιήστε Συμπερίληψη μετρήσεων προπόνησης για προσθήκη αναγνώσεων όπως καρδιακός ρυθμός, ενεργή ενέργεια και βήματα. Επιλέξτε Λεπτά ή Δευτερόλεπτα για την Ομαδοποίηση χρόνου μετρήσεων προπόνησης· τα δευτερόλεπτα παράγουν περισσότερη λεπτομέρεια και μεγαλύτερες εξαγωγές. Η Έκδοση 1 περιλαμβάνει πάντα μετρήσεις προπόνησης.

Ρυθμίσεις εξαγωγής

Το MQTT δημοσιεύει μόνο JSON. Τα μηνύματα χρησιμοποιούν QoS 0 για δημοσίευση προσκηνίου και QoS 1 για δημοσίευση παρασκηνίου. Τα μηνύματα δεν διατηρούνται.

Έκδοση εξαγωγής

Επιλέξτε Έκδοση 2 για την τρέχουσα δομή δεδομένων. Χρησιμοποιήστε Έκδοση 1 όταν υπάρχουσα ροή εργασίας εξαρτάται από την παλαιότερη μορφή.

Εύρος ημερομηνιών

Επιλογή	Συμπεριλαμβανόμενα δεδομένα
Προεπιλογή	Η προηγούμενη ημέρα και η σημερινή έως την ώρα εκτέλεσης
Από τον τελευταίο συγχρονισμό	Από τον προηγούμενο συγχρονισμό έως την ώρα εκτέλεσης
Σήμερα	Η σημερινή ημέρα έως την ώρα εκτέλεσης
Χθες	Η προηγούμενη πλήρης ημέρα
Προηγούμενες 7 ημέρες	Οι προηγούμενες επτά πλήρεις ημέρες

Σύνοψη δεδομένων και ομαδοποίηση χρόνου

Για JSON + Μετρήσεις υγείας, ενεργοποιήστε Σύνοψη δεδομένων για συνδυασμό αναγνώσεων σε χρονικές ομάδες ή απενεργοποιήστε για μεμονωμένες αναγνώσεις όπου είναι διαθέσιμες. Η σύνοψη εξαρτάται από τη μέτρηση — για παράδειγμα, τα βήματα αθροίζονται και οι αναγνώσεις βάρους υπολογίζονται ως μέσος όρος. Οι εξαγωγές μετρήσεων υγείας CSV χρησιμοποιούν συνοψισμένα δεδομένα.

Όταν είναι διαθέσιμη η Ομαδοποίηση χρόνου, επιλέξτε πόση λεπτομέρεια θα διατηρηθεί. Οι ωριαίες ή ημερήσιες ομάδες παράγουν λιγότερες γραμμές από τις ομάδες λεπτών ή δευτερολέπτων. Οι διαθέσιμες επιλογές εξαρτώνται από το εύρος ημερομηνιών και τη μορφή. Η ομαδοποίηση χρόνου προπονήσεων ρυθμίζεται ξεχωριστά στις Προπονήσεις.

Προγραμματισμός υπενθυμίσεων

Αν θέλετε προτροπή να ξεκλειδώσετε και να ανοίξετε την εφαρμογή, ενεργοποιήστε Ενεργοποίηση υπενθυμίσεων. Επιλέξτε Ωριαία, Κάθε μέρα ή Επιλεγμένες ημέρες, μετά ορίστε το λεπτό, την ώρα και τις ημέρες όπως ισχύει. Επιτρέψτε πρόσβαση ειδοποιήσεων όταν σας ζητηθεί· αν απορριφθεί, χρησιμοποιήστε Άνοιγμα ρυθμίσεων ειδοποιήσεων.

Η υπενθύμιση δεν εκτελεί τον αυτοματισμό ούτε επιβεβαιώνει επιτυχή συγχρονισμό. Πατήστε την για άνοιγμα του αυτοματισμού ή χρησιμοποιήστε Άνοιγμα και συγχρονισμός στην ειδοποίηση για αίτημα εκτέλεσης. Ο αυτοματισμός πρέπει να είναι ενεργοποιημένος· μια υπενθύμιση μπορεί να εμφανιστεί ακόμη και μετά από επιτυχή εκτέλεση παρασκηνίου. Οι αλλαγές υπενθύμισης ισχύουν όταν αποθηκεύετε.

Συχνότητα συγχρονισμού και αποθήκευση

Στη Συχνότητα συγχρονισμού επιλέξτε αριθμό και Λεπτά, Ώρες, Ημέρες ή Εβδομάδες — για παράδειγμα κάθε 15 λεπτά. Αυτός είναι επιθυμητός ρυθμός παρασκηνίου, όχι εγγυημένο πρόγραμμα.

Η συσκευή πρέπει να είναι ξεκλείδωτη όταν διαβάζονται δεδομένα υγείας. Ενεργοποιήστε την Ανανέωση εφαρμογής στο παρασκήνιο για το Health Auto Export και απενεργοποιήστε τη Λειτουργία χαμηλής κατανάλωσης για αυτόματες εκτελέσεις. Το iOS μπορεί να καθυστερήσει εκτελέσεις όταν η συσκευή ήταν ανενεργή ή οι πόροι συστήματος είναι περιορισμένοι.

Ενεργοποιήστε το Ενεργοποιημένο όταν είστε έτοιμοι για αυτόματες εκτελέσεις, μετά επιλέξτε Ενημέρωση για αποθήκευση του αυτοματισμού. Μπορείτε να μεταφορτώσετε αμέσως επιλεγμένο εύρος ημερομηνιών με τα παρακάτω βήματα.

Εξαγωγή ιστορικών ή χαμένων δεδομένων

Χρησιμοποιήστε Χειροκίνητη μεταφόρτωση όταν ρυθμίζετε για πρώτη φορά τον αυτοματισμό για εξαγωγή ιστορικών δεδομένων ή αργότερα για κάλυψη ημερομηνιών που έχασε ο αυτόματος συγχρονισμός. Μπορείτε επίσης να τη χρησιμοποιήσετε για έλεγχο της ρύθμισης.

1. Συνδέστε συνδρομητή MQTT στον broker και εγγραφείτε στο ρυθμισμένο θέμα.
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}]
      }
    ]
  }
}

Αντιμετώπιση προβλημάτων

• Αποτυχία σύνδεσης: Ελέγξτε τον κεντρικό υπολογιστή, τη θύρα, την πρόσβαση δικτύου και τις απαιτήσεις σύνδεσης του broker.
• Αποτυχία ελέγχου ταυτότητας: Ελέγξτε τα διαπιστευτήρια και την άδεια δημοσίευσης στο θέμα.
• Χωρίς μήνυμα: Επιβεβαιώστε ότι ο συνδρομητής χρησιμοποιεί τον ίδιο broker και το ακριβές θέμα, μετά ελέγξτε τα Αρχεία καταγραφής δραστηριότητας.
• Πολύ μεγάλο μήνυμα: Επιλέξτε λιγότερες μετρήσεις, μικρότερο εύρος ή πιο χονδρική ομαδοποίηση χρόνου.

Ανοίξτε τον αυτοματισμό και επιλέξτε Προβολή αρχείων καταγραφής δραστηριότητας για έλεγχο εκτέλεσης. Οι Προειδοποιήσεις επισημαίνουν πιθανά προβλήματα όπως αργή ανάκτηση δεδομένων· τα σφάλματα προσδιορίζουν αποτυχημένα βήματα. Για αναφορά προβλήματος, δείτε Λήψη βοήθειας.