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

Δημοσιεύστε μετρήσεις υγείας στο Home Assistant ως ξεχωριστές καταστάσεις οντοτήτων. Αυτός ο προορισμός υποστηρίζει μόνο μετρήσεις υγείας.

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

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

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

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

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

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

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

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

Σύνδεση Home Assistant

1. Επιλέξτε Home Assistant ως Τύπο αυτοματισμού.
2. Εισαγάγετε τη βασική διεύθυνση URL της παρουσίας Home Assistant, για παράδειγμα http://homeassistant.local:8123.
3. Δημιουργήστε Long-Lived Access Token στο προφίλ Home Assistant.
4. Κάτω από Κεφαλίδες HTTP, προσθέστε Authorization με τιμή Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Η παρουσία Home Assistant πρέπει να είναι προσβάσιμη από το iPhone ή το iPad. Για HTTPS, χρησιμοποιήστε πιστοποιητικό που εμπιστεύεται η συσκευή σας.

Ρυθμίσεις μετρήσεων υγείας

Ανοίξτε Επιλογή μετρήσεων υγείας και επιλέξτε τις αναγνώσεις προς δημοσίευση.

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

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

Το Home Assistant χρησιμοποιεί τη δική του μορφή κατάστασης οντότητας JSON· δεν υπάρχει επιλογή μορφής αρχείου ή έκδοσης εξαγωγής.

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

• Προεπιλογή: Περιλαμβάνει την προηγούμενη ημέρα και τη σημερινή έως την ώρα εκτέλεσης.
• Σήμερα: Περιλαμβάνει τη σημερινή ημέρα έως την ώρα εκτέλεσης.
• Χθες: Περιλαμβάνει την προηγούμενη πλήρη ημέρα.

Ομαδοποίηση χρόνου

Επιλέξτε Προεπιλογή για μη ομαδοποιημένες αναγνώσεις ή Ημέρες για ημερήσιες συνόψεις. Το Home Assistant δεν έχει διακόπτη Σύνοψη δεδομένων.

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

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

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

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

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

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

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

Δημοσιευμένες οντότητες

Κάθε επιλεγμένη μέτρηση μπορεί να παράγει μία ή περισσότερες οντότητες. Το αναγνωριστικό ξεκινά με πρόθεμα hae., ακολουθούμενο από το όνομα αυτοματισμού με πεζά χωρίς κενά, μετά τη μέτρηση και τυχόν όνομα στοιχείου.

Για παράδειγμα, ένας αυτοματισμός με όνομα Health Metrics μπορεί να δημοσιεύσει βήματα στη διεύθυνση:

http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count

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

Όταν μια ημέρα δεν έχει δεδομένα, τα σύνολα όπως βήματα και ώρες ορθοστασίας δημοσιεύουν 0. Άλλες αναγνώσεις, όπως βάρος ή καρδιακός ρυθμός, δεν ενημερώνονται μέχρι να υπάρχουν δεδομένα, επομένως το Home Assistant μπορεί να συνεχίσει να εμφανίζει την τελευταία τιμή που έλαβε. Νωρίς την ημέρα, τα σύνολα μπορεί να παραμείνουν 0 μέχρι τα δεδομένα Watch να φτάσουν στο iPhone.

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

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

1. Ανοίξτε τον αυτοματισμό και επιλέξτε Χειροκίνητη μεταφόρτωση κάτω από Εξαγωγή υπαρχόντων δεδομένων.
2. Ορίστε τις ημερομηνίες Έναρξη και Λήξη, μετά επιλέξτε Έναρξη εξαγωγής.
3. Στο Home Assistant, ανοίξτε Developer Tools → States και αναζητήστε το πρόθεμα hae. του αυτοματισμού σας.
4. Ελέγξτε τις τιμές οντοτήτων και τις ώρες ενημέρωσης.

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

• Σφάλμα ελέγχου ταυτότητας: Ελέγξτε το token και την κεφαλίδα Authorization: Bearer ....
• Αποτυχία σύνδεσης: Ελέγξτε τη βασική URL, τη θύρα, την πρόσβαση δικτύου και την εμπιστοσύνη πιστοποιητικού.
• Λείπουν ορισμένες αναγνώσεις: Ελέγξτε την επιλεγμένη ημέρα, τις πηγές και τα Αρχεία καταγραφής δραστηριότητας. Μια εκτέλεση μπορεί να ενημερώσει ορισμένες οντότητες ενώ άλλες αποτυγχάνουν.

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