Apple Health डेटा को MQTT में सिंक करें

MQTT ऑटोमेशन आपको अपने स्वास्थ्य डेटा को स्वचालित रूप से MQTT ब्रोकर पर प्रकाशित करने की अनुमति देता है। यह IoT प्लेटफॉर्म, होम ऑटोमेशन सिस्टम, या किसी भी सेवा के साथ एकीकरण के लिए आदर्श है जो MQTT मैसेजिंग का समर्थन करता है।

अवलोकन

MQTT ऑटोमेशन आपके स्वास्थ्य डेटा को JSON संदेशों के रूप में MQTT ब्रोकर पर निर्दिष्ट MQTT विषय पर प्रकाशित करता है। डेटा तब भेजा जाता है जब ऑटोमेशन आपकी सिंक कैडेंस सेटिंग्स के अनुसार चलता है।

उपयोग के मामले:

• IoT प्लेटफॉर्म के साथ एकीकरण (Home Assistant, OpenHAB, आदि)
• MQTT-आधारित डैशबोर्ड पर स्वास्थ्य डेटा प्रकाशित करना
• वास्तविक समय स्वास्थ्य निगरानी प्रणाली
• कस्टम होम ऑटोमेशन एकीकरण
• डेटा लॉगिंग और विश्लेषण प्लेटफॉर्म

मुख्य विशेषताएं:

• केवल JSON प्रारूप (MQTT के लिए अनुकूलित)
• प्रमाणित और अनाम कनेक्शन का समर्थन करता है
• कॉन्फ़िगर करने योग्य विषय संरचना
• क्लाइंट ID प्रबंधन
• वैकल्पिक उपयोगकर्ता नाम/पासवर्ड प्रमाणीकरण

सीमाएं

• स्वास्थ्य डेटा पहुंच: iPhone लॉक होने पर ऐप्स को स्वास्थ्य डेटा तक पहुंचने की अनुमति नहीं है। ऑटोमेशन केवल उस अवधि के दौरान चलेगा जब आपका डिवाइस अनलॉक हो। यह डेटा की ताजगी को प्रभावित कर सकता है। डेटा को अप-टू-डेट रखने के लिए मैन्युअल सिंकिंग के निर्देश देखें।

• बैकग्राउंड प्रोसेसिंग: iOS बैटरी जीवन को संरक्षित करने के लिए बैकग्राउंड प्रोसेसिंग को सीमित करता है। ऑटोमेशन बैकग्राउंड ऐप रिफ्रेश पर निर्भर करता है और निम्नलिखित स्थितियों में तुरंत नहीं चल सकता:

  • ऐप के लिए बैकग्राउंड ऐप रिफ्रेश अक्षम है
  • डिवाइस लो पावर मोड में है
  • डिवाइस लंबे समय तक निष्क्रिय रहा है
  • सिस्टम संसाधन सीमित हैं
  • कई ऐप बैकग्राउंड निष्पादन समय के लिए प्रतिस्पर्धा कर रहे हैं

• केवल JSON प्रारूप (बदला नहीं जा सकता)

• MQTT ब्रोकर की आवश्यकता है (स्थानीय या क्लाउड-आधारित)

आवश्यकताएं

• एक MQTT ब्रोकर (उदा. Mosquitto, HiveMQ, AWS IoT Core, आदि)
• आपके MQTT ब्रोकर से नेटवर्क कनेक्टिविटी
• ब्रोकर IP पता या होस्टनाम
• पोर्ट नंबर
• वैकल्पिक: यदि आपका ब्रोकर प्रमाणीकरण की आवश्यकता है तो उपयोगकर्ता नाम और पासवर्ड

कॉन्फ़िगरेशन

मुख्य नेविगेशन से स्वचालित निर्यात स्क्रीन पर नेविगेट करें, फिर "नया ऑटोमेशन" टैप करें और ऑटोमेशन प्रकार के रूप में "MQTT" चुनें।

ऑटोमेशन नाम

अपने ऑटोमेशन के लिए एक वर्णनात्मक नाम दर्ज करें (उदा. "Home Assistant MQTT", "क्लाउड MQTT ब्रोकर")।

सूचनाएं

कॉन्फ़िगर करें कि आप कब सूचनाएं प्राप्त करना चाहते हैं:

• कैश अपडेट पर सूचित करें - कैश किए गए डेटा अपडेट होने पर सूचना प्राप्त करें
• चलने पर सूचित करें - हर बार जब ऑटोमेशन डेटा प्रकाशित करता है तो सूचना प्राप्त करें

ब्रोकर कॉन्फ़िगरेशन

IP पता

अपने MQTT ब्रोकर का IP पता या होस्टनाम दर्ज करें।

उदाहरण:

• 192.168.1.100 (स्थानीय IP पता)
• mqtt.example.com (होस्टनाम)
• broker.hivemq.com (क्लाउड MQTT ब्रोकर)
• localhost (यदि एक ही डिवाइस पर चल रहा है, iOS के लिए अनुशंसित नहीं)

नोट: अपने नेटवर्क पर स्थानीय ब्रोकर के लिए IP पते का उपयोग करें, या क्लाउड-आधारित ब्रोकर के लिए होस्टनाम का उपयोग करें। सुनिश्चित करें कि ब्रोकर आपके डिवाइस से सुलभ है।

पोर्ट

अपने MQTT ब्रोकर के लिए पोर्ट नंबर दर्ज करें।

नोट: डिफ़ॉल्ट पोर्ट 1883 है।

विषय

MQTT विषय दर्ज करें जहां स्वास्थ्य डेटा प्रकाशित किया जाएगा। यह वह विषय है जिसका उपयोग ग्राहक आपके स्वास्थ्य डेटा को प्राप्त करने के लिए करेंगे।

विषय उदाहरण:

• health/data
• home/health/metrics
• user/health/export
• hae/automation-name

विषय सर्वोत्तम प्रथाएं:

• विषय पदानुक्रम बनाने के लिए फॉरवर्ड स्लैश (/) का उपयोग करें
• डेटा प्रकार को इंगित करने वाले वर्णनात्मक नामों का उपयोग करें
• रिक्त स्थान और विशेष वर्णों से बचें
• कई ऑटोमेशन के लिए ऑटोमेशन नाम शामिल करने पर विचार करें

नोट: विषय नाम केस-संवेदी है। सुनिश्चित करें कि ग्राहक बिल्कुल समान विषय नाम का उपयोग करते हैं।

क्लाइंट ID

इस MQTT कनेक्शन के लिए एक अद्वितीय क्लाइंट ID दर्ज करें। यह आपके डिवाइस को MQTT ब्रोकर के लिए पहचानता है।

क्लाइंट ID उदाहरण:

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

उपयोगकर्ता नाम (वैकल्पिक)

MQTT ब्रोकर प्रमाणीकरण के लिए उपयोगकर्ता नाम दर्ज करें। यदि आपका ब्रोकर प्रमाणीकरण की आवश्यकता नहीं है तो खाली छोड़ दें।

पासवर्ड (वैकल्पिक)

MQTT ब्रोकर प्रमाणीकरण के लिए पासवर्ड दर्ज करें। यदि आपका ब्रोकर प्रमाणीकरण की आवश्यकता नहीं है तो खाली छोड़ दें。

डेटा प्रकार सेटिंग्स

डेटा प्रकार

निर्यात करने के लिए स्वास्थ्य डेटा का प्रकार चुनें:

• स्वास्थ्य मेट्रिक्स - कदम, हृदय गति, नींद और अन्य स्वास्थ्य माप
• वर्कआउट - व्यायाम और फिटनेस गतिविधियां
• लक्षण - स्वास्थ्य लक्षण और स्थितियां
• ECG - इलेक्ट्रोकार्डियोग्राम रीडिंग
• हृदय गति सूचनाएं - उच्च/निम्न हृदय गति घटनाएं
• मन की स्थिति - मूड और मानसिक स्थिति प्रविष्टियां (iOS 18.0+)
• चक्र ट्रैकिंग - मासिक धर्म चक्र और प्रजनन स्वास्थ्य डेटा
• दवाएं - दवा लॉग और अनुपालन (iOS 26.0+)

स्वास्थ्य मेट्रिक्स कॉन्फ़िगरेशन

जब स्वास्थ्य मेट्रिक्स चुना जाता है:

स्वास्थ्य मेट्रिक्स चुनें - शामिल करने के लिए कौन से विशिष्ट मेट्रिक्स चुनें। आप सभी उपलब्ध मेट्रिक्स चुन सकते हैं या विशिष्ट चुन सकते हैं।

सुझाव: केवल आवश्यक मेट्रिक्स चुनने से संदेश आकार और प्रसंस्करण समय कम हो जाता है।

पसंदीदा स्रोत - कॉन्फ़िगर करें कि कौन से डेटा स्रोत प्राथमिकता लेते हैं जब कई स्रोत एक ही मेट्रिक प्रदान करते हैं।

वर्कआउट कॉन्फ़िगरेशन

जब वर्कआउट चुना जाता है:

रूट डेटा शामिल करें - स्थान डेटा वाले वर्कआउट के लिए रूट शामिल करने के लिए चालू करें।

वर्कआउट मेट्रिक्स शामिल करें - वर्कआउट के दौरान एकत्र किए गए स्वास्थ्य मेट्रिक्स (हृदय गति, कैलोरी, आदि) शामिल करने के लिए चालू करें।

समय समूहीकरण (वर्कआउट मेट्रिक्स) - निर्यात संस्करण 2 का उपयोग करते समय और वर्कआउट मेट्रिक्स शामिल करें सक्षम है:

• मिनट - वर्कआउट मेट्रिक्स को मिनट द्वारा समूहीकृत करता है
• सेकंड - वर्कआउट मेट्रिक्स को सेकंड द्वारा समूहीकृत करता है

निर्यात सेटिंग्स

निर्यात प्रारूप

नोट: MQTT ऑटोमेशन केवल JSON प्रारूप का समर्थन करता है। यह सेटिंग बदली नहीं जा सकती और स्वचालित रूप से JSON पर सेट हो जाती है।

निर्यात संस्करण

वर्कआउट डेटा के लिए निर्यात संस्करण चुनें:

• संस्करण 1 - पुराना प्रारूप
• संस्करण 2 - बेहतर वर्कआउट डेटा के साथ वर्तमान प्रारूप

नोट: निर्यात संस्करण मुख्य रूप से वर्कआउट डेटा संरचना को प्रभावित करता है यदि आप वर्कआउट निर्यात कर रहे हैं।

तिथि सीमा

चुनें कि डेटा कब निर्यात किया जाना चाहिए:

• डिफ़ॉल्ट - पिछले दिन के पूर्ण डेटा को सिंक करता है और वर्तमान तिथि और समय तक के डेटा
• अंतिम सिंक के बाद से - प्रत्येक सिंक पर, अंतिम बार निर्यात चलने के बाद से वर्तमान तिथि और समय तक के सभी डेटा निर्यात करता है
• आज - वर्तमान तिथि के लिए वर्तमान समय तक के सभी डेटा को सिंक करता है
• कल - पिछले दिन के पूर्ण सभी डेटा को सिंक करता है
• पिछले 7 दिन - पिछले सात पूर्ण दिनों के डेटा को सिंक करता है

डेटा सारांशित करें

स्वास्थ्य मेट्रिक्स डेटा प्रकार के साथ JSON प्रारूप का उपयोग करते समय, डेटा सारांशित करें चालू या बंद करें।

• चालू - एकत्रित डेटा सारांश प्रदान करता है (डिफ़ॉल्ट)
• बंद - जहां संभव हो वहां असंगठित डेटा प्रदान करता है, व्यक्तिगत डेटा बिंदु दिखाता है

समय समूहीकरण

जब डेटा सारांशित करें सक्षम है, तो चुनें कि डेटा को कैसे एकत्रित किया जाना चाहिए।

डेटा सारांशित करें

स्वास्थ्य मेट्रिक्स के लिए डेटा सारांशित करें चालू या बंद करें।

• चालू - एकत्रित डेटा सारांश प्रदान करता है (डिफ़ॉल्ट)
• बंद - जहां संभव हो वहां असंगठित डेटा प्रदान करता है

नोट: यह सेटिंग केवल स्वास्थ्य मेट्रिक्स डेटा प्रकार पर लागू होती है।

सिंक कैडेंस

कॉन्फ़िगर करें कि ऑटोमेशन को MQTT पर कितनी बार डेटा प्रकाशित करना चाहिए:

एक संख्या और अंतराल चुनें।

परीक्षण और सत्यापन

मैन्युअल परीक्षण

1. ऑटोमेशन कॉन्फ़िगरेशन स्क्रीन में "मैन्युअल निर्यात" टैप करें
2. एक तिथि सीमा चुनें
3. संदेश प्रकाशित करने के लिए "निर्यात" टैप करें
4. अपने विषय की सदस्यता लेने और संदेश प्राप्त होने की पुष्टि करने के लिए MQTT क्लाइंट का उपयोग करें

MQTT क्लाइंट का उपयोग करना

यह सत्यापित करने के लिए कि संदेश प्रकाशित किए जा रहे हैं:

1. MQTT क्लाइंट सेट अप करें
2. समान क्रेडेंशियल का उपयोग करके अपने MQTT ब्रोकर से कनेक्ट करें
3. अपने विषय की सदस्यता लें
4. ऐप से मैन्युअल निर्यात ट्रिगर करें
5. सत्यापित करें कि संदेश आपके MQTT क्लाइंट में दिखाई देता है

गतिविधि लॉग देखना

1. ऑटोमेशन कॉन्फ़िगरेशन स्क्रीन में "गतिविधि लॉग देखें" टैप करें
2. हाल की ऑटोमेशन रन की समीक्षा करें
3. कनेक्शन त्रुटियों या प्रकाशन विफलताओं की जांच करें
4. प्रकाशन टाइमस्टैम्प सत्यापित करें

संदेश प्रारूप

MQTT संदेश JSON के रूप में प्रकाशित किए जाते हैं। संदेश पेलोड मानक निर्यात JSON प्रारूप का अनुसरण करता है:

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

संदेश निम्नलिखित के साथ प्रकाशित किया जाता है:

• विषय: ऑटोमेशन में कॉन्फ़िगर किया गया
• QoS: अधिकतम एक बार वितरण
• रखें: संदेश रखे नहीं जाते
• पेलोड: स्वास्थ्य डेटा युक्त JSON स्ट्रिंग

समस्या निवारण

सामान्य समस्याएं

कनेक्शन विफलताएं

• सत्यापित करें कि ब्रोकर IP पता/होस्टनाम सही है
• जांचें कि पोर्ट सही है और ब्रोकर उस पोर्ट पर सुन रहा है
• ब्रोकर से नेटवर्क कनेक्टिविटी सुनिश्चित करें
• सत्यापित करें कि फ़ायरवॉल नियम ब्रोकर से कनेक्शन की अनुमति देते हैं
• जांचें कि क्या ब्रोकर TLS/SSL की आवश्यकता है

प्रमाणीकरण विफलताएं

• सत्यापित करें कि उपयोगकर्ता नाम और पासवर्ड सही हैं
• जांचें कि यदि क्रेडेंशियल प्रदान किए गए हैं तो आपके ब्रोकर पर प्रमाणीकरण सक्षम है
• सुनिश्चित करें कि उपयोगकर्ता के पास निर्दिष्ट विषय पर प्रकाशित करने की अनुमति है

संदेश प्राप्त नहीं हुए

• सत्यापित करें कि विषय नाम बिल्कुल मेल खाता है (केस-संवेदी)
• जांचें कि ग्राहक एक ही ब्रोकर से जुड़े हैं
• सुनिश्चित करें कि ग्राहक सही विषय की सदस्यता ले रहे हैं
• सत्यापित करें कि ऑटोमेशन सक्षम है और चल रहा है
• प्रकाशन त्रुटियों के लिए गतिविधि लॉग जांचें

बड़ा संदेश आकार

• चयनित स्वास्थ्य मेट्रिक्स की संख्या कम करें
• कम विस्तृत एकत्रीकरण विकल्पों का उपयोग करें
• विभिन्न डेटा प्रकारों के लिए कई ऑटोमेशन में विभाजित करने पर विचार करें

सुझाव और सर्वोत्तम प्रथाएं

1. विषय संगठन:

   • पदानुक्रमित विषय संरचनाओं का उपयोग करें (उदा. health/metrics, health/workouts)
   • विषयों में डिवाइस या ऑटोमेशन पहचानकर्ता शामिल करें
   • आसान संदर्भ के लिए अपनी विषय संरचना का दस्तावेजीकरण करें

2. संदेश आकार:

   • MQTT ब्रोकर सीमाओं से बचने के लिए संदेशों को उचित आकार में रखें
   • डेटा मात्रा कम करने के लिए कम विस्तृत एकत्रीकरण का उपयोग करें
   • बड़े डेटासेट को कई संदेशों में विभाजित करने पर विचार करें

3. निगरानी:

   • प्रकाशन सफलता को ट्रैक करने के लिए ऐप में गतिविधि लॉग का उपयोग करें

4. क्लाउड ब्रोकर:

   • क्लाउड MQTT ब्रोकर (AWS IoT, HiveMQ Cloud, आदि) का उपयोग करते समय:
     • उनकी विशिष्ट कनेक्शन आवश्यकताओं का पालन करें
     • उनकी संदेश आकार और दर सीमाओं की जांच करें
     • विषय नामकरण सम्मेलनों को सत्यापित करें