Συγχρονισμός με MQTT

Οι αυτοματισμοί MQTT σάς επιτρέπουν να δημοσιεύετε αυτόματα τα δεδομένα υγείας σας σε διαμεσολαβητή MQTT. Ιδανικό για ενσωμάτωση με πλατφόρμες IoT, συστήματα αυτοματισμού σπιτιού ή οποιαδήποτε υπηρεσία υποστηρίζει ανταλλαγή μηνυμάτων MQTT.

Επισκόπηση

Οι αυτοματισμοί MQTT δημοσιεύουν τα δεδομένα υγείας σας ως μηνύματα JSON σε καθορισμένο θέμα MQTT σε διαμεσολαβητή MQTT. Τα δεδομένα αποστέλλονται όταν εκτελείται ο αυτοματισμός σύμφωνα με τις ρυθμίσεις ρυθμού συγχρονισμού.

Περιπτώσεις χρήσης:

• Ενσωμάτωση με πλατφόρμες IoT (Home Assistant, OpenHAB κ.λπ.)
• Δημοσίευση δεδομένων υγείας σε πίνακες ελέγχου βασισμένους σε MQTT
• Συστήματα παρακολούθησης υγείας σε πραγματικό χρόνο
• Προσαρμοσμένες ενσωματώσεις αυτοματισμού σπιτιού
• Πλατφόρμες καταγραφής και αναλυτικών δεδομένων

Βασικά χαρακτηριστικά:

• Μόνο μορφή JSON (βελτιστοποιημένη για MQTT)
• Υποστήριξη ταυτοποιημένων και ανώνυμων συνδέσεων
• Ρυθμιζόμενη δομή θεμάτων
• Διαχείριση αναγνωριστικού πελάτη
• Προαιρετικός έλεγχος ταυτότητας με όνομα χρήστη/κωδικό

Περιορισμοί

• Πρόσβαση σε δεδομένα υγείας: Οι εφαρμογές δεν επιτρέπεται να έχουν πρόσβαση σε δεδομένα υγείας όσο το iPhone είναι κλειδωμένο. Οι αυτοματισμοί εκτελούνται μόνο όταν η συσκευή σας είναι ξεκλείδωτη. Αυτό μπορεί να επηρεάσει την επικαιρότητα των δεδομένων. Δείτε τις οδηγίες για χειροκίνητο συγχρονισμό.

• Επεξεργασία στο παρασκήνιο: Το iOS περιορίζει την επεξεργασία στο παρασκήνιο για την εξοικονόμηση μπαταρίας. Οι αυτοματισμοί βασίζονται στην Ανανέωση εφαρμογών στο παρασκήνιο και ενδέχεται να μην εκτελούνται αμέσως αν:

  • Η Ανανέωση εφαρμογών στο παρασκήνιο είναι απενεργοποιημένη για την εφαρμογή
  • Η συσκευή είναι σε λειτουργία χαμηλής κατανάλωσης ενέργειας
  • Η συσκευή έχει μείνει ανενεργή για παρατεταμένα διαστήματα
  • Οι πόροι του συστήματος είναι περιορισμένοι
  • Πολλές εφαρμογές ανταγωνίζονται για χρόνο εκτέλεσης στο παρασκήνιο

• Μόνο μορφή JSON (δεν αλλάζει)

• Απαιτείται διαμεσολαβητής MQTT (τοπικός ή στο cloud)

Προαπαιτούμενα

• Διαμεσολαβητής MQTT (π.χ. Mosquitto, HiveMQ, AWS IoT Core κ.λπ.)
• Σύνδεση δικτύου προς τον διαμεσολαβητή MQTT
• Διεύθυνση IP ή όνομα κεντρικού υπολογιστή του διαμεσολαβητή
• Αριθμός θύρας
• Προαιρετικά: Όνομα χρήστη και κωδικός αν ο διαμεσολαβητής απαιτεί ταυτοποίηση

Ρύθμιση

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

Όνομα αυτοματισμού

Εισαγάγετε ένα περιγραφικό όνομα (π.χ. «Home Assistant MQTT», «Διαμεσολαβητής MQTT cloud»).

Ειδοποιήσεις

Ρυθμίστε πότε θέλετε να λαμβάνετε ειδοποιήσεις:

• Ειδοποίηση κατά την ενημέρωση κρυφής μνήμης - Όταν ενημερώνονται τα δεδομένα στην κρυφή μνήμη
• Ειδοποίηση κατά την εκτέλεση - Κάθε φορά που ο αυτοματισμός δημοσιεύει δεδομένα

Ρύθμιση διαμεσολαβητή

Διεύθυνση IP

Εισαγάγετε τη διεύθυνση IP ή το όνομα κεντρικού υπολογιστή του διαμεσολαβητή MQTT.

Παραδείγματα:

• 192.168.1.100 (τοπική διεύθυνση IP)
• mqtt.example.com (όνομα κεντρικού υπολογιστή)
• broker.hivemq.com (διαμεσολαβητής MQTT cloud)
• localhost (αν εκτελείται στην ίδια συσκευή· δεν συνιστάται για iOS)

Σημείωση: Χρησιμοποιήστε διευθύνσεις IP για τοπικούς διαμεσολαβητές στο δίκτυό σας ή ονόματα κεντρικών υπολογιστών για διαμεσολαβητές cloud. Βεβαιωθείτε ότι ο διαμεσολαβητής είναι προσβάσιμος από τη συσκευή σας.

Θύρα

Εισαγάγετε τον αριθμό θύρας του διαμεσολαβητή MQTT.

Σημείωση: Η προεπιλεγμένη θύρα είναι 1883.

Θέμα

Εισαγάγετε το θέμα MQTT όπου θα δημοσιεύονται τα δεδομένα υγείας. Αυτό είναι το θέμα που θα χρησιμοποιούν οι συνδρομητές για λήψη των δεδομένων.

Παραδείγματα θεμάτων:

• health/data
• home/health/metrics
• user/health/export
• hae/όνομα-αυτοματισμού

Βέλτιστες πρακτικές θεμάτων:

• Χρησιμοποιήστε κάθετους (/) για ιεραρχία θεμάτων
• Χρησιμοποιήστε περιγραφικά ονόματα που δείχνουν τον τύπο δεδομένων
• Αποφύγετε κενά και ειδικούς χαρακτήρες
• Εξετάστε να συμπεριλάβετε το όνομα αυτοματισμού για πολλαπλούς αυτοματισμούς

Σημείωση: Το όνομα θέματος είναι ευαίσθητο σε πεζά/κεφαλαία. Οι συνδρομητές πρέπει να χρησιμοποιούν ακριβώς το ίδιο όνομα.

Αναγνωριστικό πελάτη

Εισαγάγετε ένα μοναδικό αναγνωριστικό πελάτη για αυτή τη σύνδεση MQTT. Προσδιορίζει τη συσκευή σας στον διαμεσολαβητή.

Παραδείγματα αναγνωριστικού πελάτη:

• health-export-iphone
• hae-client-001
• ios-health-app

Όνομα χρήστη (προαιρετικό)

Εισαγάγετε το όνομα χρήστη για ταυτοποίηση στον διαμεσολαβητή. Αφήστε κενό αν δεν απαιτείται.

Κωδικός πρόσβασης (προαιρετικό)

Εισαγάγετε τον κωδικό για ταυτοποίηση στον διαμεσολαβητή. Αφήστε κενό αν δεν απαιτείται.

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

Τύπος δεδομένων

Επιλέξτε ποιον τύπο δεδομένων υγείας θα εξάγετε:

• Μετρήσεις υγείας - Βήματα, καρδιακός ρυθμός, ύπνος και άλλες μετρήσεις
• Προπονήσεις - Άσκηση και δραστηριότητες ευεξίας
• Συμπτώματα - Συμπτώματα και καταστάσεις υγείας
• ΗΚΓ - Καταγραφές ηλεκτροκαρδιογραφήματος
• Ειδοποιήσεις καρδιακού ρυθμού - Συμβάντα υψηλού/χαμηλού καρδιακού ρυθμού
• Κατάσταση διάθεσης - Καταχωρήσεις διάθεσης και ψυχικής κατάστασης (iOS 18.0+)
• Παρακολούθηση κύκλου - Δεδομένα κύκλου και αναπαραγωγικής υγείας
• Φάρμακα - Καταγραφές φαρμάκων και συμμόρφωση (iOS 26.0+)

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

Όταν επιλέγονται οι Μετρήσεις υγείας:

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

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

Προτιμώμενες πηγές - Ρυθμίστε ποιες πηγές έχουν προτεραιότητα όταν πολλές παρέχουν την ίδια μέτρηση.

Ρύθμιση προπόνησης

Όταν επιλέγονται οι Προπονήσεις:

Συμπερίληψη δεδομένων διαδρομής - Ενεργοποιήστε για διαδρομές σε προπονήσεις με τοποθεσία.

Συμπερίληψη μετρήσεων προπόνησης - Ενεργοποιήστε για μετρήσεις υγείας κατά την προπόνηση (καρδιακός ρυθμός, θερμίδες κ.λπ.).

Ομαδοποίηση χρόνου (μετρήσεις προπόνησης) - Με Έκδοση εξαγωγής 2 και ενεργοποιημένη Συμπερίληψη μετρήσεων προπόνησης:

• Λεπτά - Ομαδοποίηση ανά λεπτό
• Δευτερόλεπτα - Ομαδοποίηση ανά δευτερόλεπτο

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

Μορφή εξαγωγής

Σημείωση: Οι αυτοματισμοί MQTT υποστηρίζουν μόνο μορφή JSON. Αυτή η ρύθμιση δεν αλλάζει και ορίζεται αυτόματα σε JSON.

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

Επιλέξτε έκδοση εξαγωγής για δεδομένα προπόνησης:

• Έκδοση 1 - Παλαιότερη μορφή
• Έκδοση 2 - Τρέχουσα μορφή με ενισχυμένα δεδομένα προπόνησης

Σημείωση: Η έκδοση εξαγωγής επηρεάζει κυρίως τη δομή δεδομένων προπόνησης αν εξάγετε προπονήσεις.

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

Επιλέξτε πότε θα εξάγονται τα δεδομένα:

• Προεπιλογή - Συγχρονίζει δεδομένα για ολόκληρη την προηγούμενη ημέρα συν δεδομένα μέχρι την τρέχουσα ημερομηνία και ώρα
• Από τον τελευταίο συγχρονισμό - Σε κάθε συγχρονισμό εξάγει όλα τα δεδομένα από την τελευταία εκτέλεση μέχρι τώρα
• Σήμερα - Όλα τα δεδομένα της τρέχουσας ημέρας μέχρι τώρα
• Χθες - Όλα τα δεδομένα της πλήρους προηγούμενης ημέρας
• Προηγούμενες 7 ημέρες - Δεδομένα για τις πλήρεις προηγούμενες επτά ημέρες

Σύνοψη δεδομένων

Όταν χρησιμοποιείτε μορφή JSON με τύπο Μετρήσεις υγείας, ενεργοποιήστε ή απενεργοποιήστε τη Σύνοψη δεδομένων.

• Ενεργό - Συγκεντρωτικές περιλήψεις (προεπιλογή)
• Ανενεργό - Αποσυναρτημένα δεδομένα όπου είναι δυνατόν

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

Όταν η Σύνοψη δεδομένων είναι ενεργή, επιλέξτε πώς θα συγκεντρώνονται τα δεδομένα.

Σύνοψη δεδομένων

Ενεργοποιήστε ή απενεργοποιήστε τη Σύνοψη δεδομένων για Μετρήσεις υγείας.

• Ενεργό - Συγκεντρωτικές περιλήψεις (προεπιλογή)
• Ανενεργό - Αποσυναρτημένα δεδομένα όπου είναι δυνατόν

Σημείωση: Αυτή η ρύθμιση ισχύει μόνο για τον τύπο Μετρήσεις υγείας.

Ρυθμός συγχρονισμού

Ρυθμίστε πόσο συχνά ο αυτοματισμός θα δημοσιεύει δεδομένα στο MQTT:

Επιλέξτε αριθμό και διάστημα.

Δοκιμή και επαλήθευση

Χειροκίνητη δοκιμή

1. Πατήστε Χειροκίνητη εξαγωγή στην οθόνη ρύθμισης του αυτοματισμού
2. Επιλέξτε εύρος ημερομηνιών
3. Πατήστε Εξαγωγή για δημοσίευση μηνύματος
4. Χρησιμοποιήστε πελάτη MQTT για συνδρομή στο θέμα σας και επαληθεύστε τη λήψη

Χρήση πελάτη MQTT

Για επαλήθευση ότι δημοσιεύονται μηνύματα:

1. Ρυθμίστε πελάτη MQTT
2. Συνδεθείτε στον ίδιο διαμεσολαβητή με τα ίδια διαπιστευτήρια
3. Εγγραφείτε στο θέμα σας
4. Ενεργοποιήστε χειροκίνητη εξαγωγή από την εφαρμογή
5. Επαληθεύστε ότι το μήνυμα εμφανίζεται στον πελάτη MQTT

Προβολή καταγραφών δραστηριότητας

1. Πατήστε Προβολή καταγραφών δραστηριότητας στην οθόνη ρύθμισης
2. Ελέγξτε τις πρόσφατες εκτελέσεις
3. Αναζητήστε σφάλματα σύνδεσης ή αποτυχίες δημοσίευσης
4. Επαληθεύστε τις χρονοσφραγίδες δημοσίευσης

Μορφή μηνύματος

Τα μηνύματα MQTT δημοσιεύονται ως JSON. Το φορτίο ακολουθεί την τυπική μορφή εξαγωγής JSON:

{
  "data": {
    "metrics": [...],
    "workouts": [...],
    ...
  }
}

Το μήνυμα δημοσιεύεται με:

• Θέμα: Όπως ρυθμίστηκε στον αυτοματισμό
• QoS: Παράδοση το πολύ μία φορά
• Retain: Τα μηνύματα δεν διατηρούνται
• Φορτίο: Συμβολοσειρά JSON με δεδομένα υγείας

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

Συνηθισμένα ζητήματα

Αποτυχίες σύνδεσης

• Επαληθεύστε ότι η διεύθυνση IP/όνομα κεντρικού υπολογιστή είναι σωστά
• Ελέγξτε ότι η θύρα είναι σωστή και ο διαμεσολαβητής ακούει σε αυτή
• Βεβαιωθείτε για σύνδεση δικτύου προς τον διαμεσολαβητή
• Επαληθεύστε ότι το τείχος προστασίας επιτρέπει συνδέσεις
• Ελέγξτε αν ο διαμεσολαβητής απαιτεί TLS/SSL

Αποτυχίες ταυτοποίησης

• Επαληθεύστε όνομα χρήστη και κωδικό
• Ελέγξτε ότι η ταυτοποίηση είναι ενεργή στον διαμεσολαβητή αν δώσατε διαπιστευτήρια
• Βεβαιωθείτε ότι ο χρήστης έχει άδεια δημοσίευσης στο καθορισμένο θέμα

Δεν λαμβάνονται μηνύματα

• Επαληθεύστε ότι το όνομα θέματος ταιριάζει ακριβώς (ευαισθησία πεζών/κεφαλαίων)
• Ελέγξτε ότι οι συνδρομητές είναι στον ίδιο διαμεσολαβητή
• Βεβαιωθείτε ότι οι συνδρομητές είναι εγγεγραμμένοι στο σωστό θέμα
• Επαληθεύστε ότι ο αυτοματισμός είναι ενεργός
• Ελέγξτε τις Καταγραφές δραστηριότητας για σφάλματα δημοσίευσης

Μεγάλο μέγεθος μηνύματος

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

Συμβουλές και βέλτιστες πρακτικές

1. Αυτόματος συγχρονισμός:

   • Φορτίστε τη συσκευή και χρησιμοποιήστε το Κατοπτρισμό iPhone
     • Όταν η συσκευή φορτίζει, το iOS επιβάλλει λιγότερους περιορισμούς, ώστε τα δεδομένα να συγχρονίζονται συχνότερα
     • Με το Κατοπτρισμό iPhone, η συσκευή συμπεριφέρεται σαν ξεκλείδωτη και τα δεδομένα υγείας είναι προσβάσιμα από το Health Auto Export

2. Οργάνωση θεμάτων:

   • Χρησιμοποιήστε ιεραρχική δομή θεμάτων (π.χ. health/metrics, health/workouts)
   • Συμπεριλάβετε αναγνωριστικά συσκευής ή αυτοματισμού στα θέματα
   • Τεκμηριώστε τη δομή θεμάτων σας

3. Μέγεθος μηνύματος:

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

4. Παρακολούθηση:

   • Χρησιμοποιήστε τις Καταγραφές δραστηριότητας στην εφαρμογή για επιτυχημένες δημοσιεύσεις

5. Διαμεσολαβητές cloud:

   • Όταν χρησιμοποιείτε διαμεσολαβητές MQTT cloud (AWS IoT, HiveMQ Cloud κ.λπ.):
     • Ακολουθήστε τις απαιτήσεις σύνδεσής τους
     • Ελέγξτε όρια μεγέθους μηνύματος και ρυθμού
     • Επαληθεύστε τις συμβάσεις ονοματοδοσίας θεμάτων