Apple Health डेटा को Home Assistant के साथ सिंक करें

Home Assistant ऑटोमेशन आपको अपने स्वास्थ्य डेटा को Home Assistant में सेंसर स्थितियों के रूप में स्वचालित रूप से सिंक करने की अनुमति देता है। यह एकीकरण आपको Home Assistant ऑटोमेशन, डैशबोर्ड और अन्य एकीकरण में अपने स्वास्थ्य डेटा का उपयोग करने में सक्षम बनाता है।

अवलोकन

Home Assistant ऑटोमेशन आपके स्वास्थ्य मेट्रिक्स को Home Assistant के REST API पर भेजता है, सेंसर स्थितियां बनाता या अपडेट करता है जिनका उपयोग आपके पूरे Home Assistant इंस्टेंस में किया जा सकता है। डेटा विशेष रूप से Home Assistant के /states/ API के लिए फॉर्मेट किया गया है।

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

• Home Assistant डैशबोर्ड पर स्वास्थ्य मेट्रिक्स प्रदर्शित करना
• स्वास्थ्य डेटा के आधार पर ऑटोमेशन बनाना
• स्वास्थ्य डेटा को अन्य स्मार्ट होम उपकरणों के साथ एकीकृत करना
• Home Assistant में समय के साथ स्वास्थ्य रुझानों को ट्रैक करना

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

• स्वचालित सेंसर स्थिति निर्माण
• केवल JSON प्रारूप (Home Assistant के लिए अनुकूलित)
• केवल Health Metrics डेटा प्रकार
• सरल URL कॉन्फ़िगरेशन

सीमाएं

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

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

  • ऐप के लिए App Background Refresh अक्षम है
  • डिवाइस Low Power Mode में है
  • डिवाइस लंबे समय तक निष्क्रिय रहा है
  • सिस्टम संसाधन सीमित हैं
  • कई ऐप बैकग्राउंड निष्पादन समय के लिए प्रतिस्पर्धा कर रहे हैं

• केवल Health Metrics डेटा प्रकार का समर्थन करता है

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

आवश्यकताएं

• आपके नेटवर्क पर चल रहा और सुलभ Home Assistant इंस्टेंस
• Home Assistant API एक्सेस टोकन (लॉन्ग-लिव्ड एक्सेस टोकन)
• आपके Home Assistant इंस्टेंस के लिए नेटवर्क कनेक्टिविटी
• REST API का समर्थन करने वाला Home Assistant संस्करण

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

मुख्य नेविगेशन से Automated Exports स्क्रीन पर नेविगेट करें, फिर "New Automation" टैप करें और Automation Type के रूप में "Home Assistant" चुनें।

ऑटोमेशन नाम

अपने ऑटोमेशन के लिए एक वर्णनात्मक नाम दर्ज करें। इस नाम का उपयोग Home Assistant में सेंसर इकाई ID उत्पन्न करने के लिए किया जाएगा।

नोट: ऑटोमेशन नाम को इकाई ID बनाने के लिए लोअरकेस में बदल दिया जाएगा और रिक्त स्थान हटा दिए जाएंगे। उदाहरण के लिए, "मेरा स्वास्थ्य डेटा" hae.meraswasthyadata बन जाता है।

सूचनाएं

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

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

Home Assistant URL

अपने Home Assistant इंस्टेंस का बेस URL दर्ज करें। यदि आप डिफ़ॉल्ट का उपयोग नहीं कर रहे हैं तो इसमें प्रोटोकॉल और पोर्ट शामिल होना चाहिए।

URL उदाहरण:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

नोट: URL आपके डिवाइस से सुलभ होना चाहिए। यदि आप HTTPS का उपयोग कर रहे हैं, तो सुनिश्चित करें कि आपका प्रमाणपत्र वैध है या एक अपवाद जोड़ें।

स्वचालित रूप से उत्पन्न एंडपॉइंट

ऐप आपके ऑटोमेशन नाम के आधार पर पूर्ण API एंडपॉइंट को स्वचालित रूप से उत्पन्न करता है:

{your_url}/api/states/hae.{automation_name}

उदाहरण के लिए, यदि आपका URL http://homeassistant.local:8123 है और आपका ऑटोमेशन नाम "स्वास्थ्य मेट्रिक्स" है, तो एंडपॉइंट होगा:

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

यह एंडपॉइंट संदर्भ के लिए URL फ़ील्ड के नीचे प्रदर्शित होता है।

अनुरोध टाइमआउट

Home Assistant के लिए HTTP अनुरोधों के लिए एक टाइमआउट अंतराल चुनें।

उपलब्ध टाइमआउट विकल्प:

• 60 सेकंड - डिफ़ॉल्ट, अधिकांश Home Assistant इंस्टेंस के लिए उपयुक्त
• 300 सेकंड (5 मिनट) - धीमे Home Assistant इंस्टेंस के लिए
• 1800 सेकंड (30 मिनट) - बहुत धीमी प्रोसेसिंग के लिए
• 3600 सेकंड (1 घंटा) - अधिकतम अनुशंसित टाइमआउट

HTTP हेडर

Home Assistant API एक्सेस के लिए प्रमाणीकरण हेडर जोड़ें। आपको अपने लॉन्ग-लिव्ड एक्सेस टोकन के साथ एक Authorization हेडर जोड़ना होगा।

आवश्यक हेडर:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

लॉन्ग-लिव्ड एक्सेस टोकन प्राप्त करने के लिए:

1. Home Assistant खोलें
2. अपने प्रोफ़ाइल पर जाएं (बाएं निचले कोने में अपना नाम क्लिक करें)
3. "लॉन्ग-लिव्ड एक्सेस टोकन" तक स्क्रॉल करें
4. "टोकन बनाएं" क्लिक करें
5. इसे एक नाम दें (उदाहरण के लिए, "Health Auto Export")
6. टोकन को कॉपी करें और हेडर मान फ़ील्ड में पेस्ट करें

वैकल्पिक हेडर:
यदि आवश्यक हो तो आप अपने Home Assistant सेटअप के लिए अतिरिक्त हेडर जोड़ सकते हैं।

हेडर जोड़ने के लिए:

1. "हेडर जोड़ें" टैप करें
2. बाएं फ़ील्ड में हेडर कुंजी दर्ज करें
3. दाएं फ़ील्ड में हेडर मान दर्ज करें
4. अतिरिक्त हेडर के लिए दोहराएं

महत्वपूर्ण: प्रत्येक हेडर कुंजी में एक संबंधित मान होना चाहिए। खाली हेडर को अनदेखा कर दिया जाएगा।

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

डेटा प्रकार

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

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

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

सुझाव: केवल उन मेट्रिक्स का चयन करना जिनकी आपको आवश्यकता है, प्रोसेसिंग समय में सुधार कर सकता है और Home Assistant को भेजे गए डेटा के आकार को कम कर सकता है।

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

एक्सपोर्ट सेटिंग्स

एक्सपोर्ट प्रारूप

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

एक्सपोर्ट संस्करण

नोट: एक्सपोर्ट संस्करण Home Assistant ऑटोमेशन के लिए उपलब्ध नहीं है क्योंकि प्रारूप विशेष रूप से Home Assistant के state API के लिए अनुकूलित है।

तारीख सीमा

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

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

नोट: Home Assistant ऑटोमेशन "रियल टाइम", "अंतिम सिंक के बाद से" या "पिछले 7 दिन" विकल्पों का समर्थन नहीं करते हैं।

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

Health Metrics के लिए डेटा सारांशित करें ON या OFF करें।

• ON - एकत्रित डेटा सारांश प्रदान करता है (डिफ़ॉल्ट)
• OFF - जहां संभव हो वहां विघटित डेटा प्रदान करता है

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

समय समूहीकरण

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

• डिफ़ॉल्ट - कोई एकत्रीकरण नहीं, कच्चे डेटा बिंदु
• दिन - दिन के अनुसार डेटा समूहीकृत करता है (अनुशंसित)

सिंक आवृत्ति

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

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

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

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

1. ऑटोमेशन कॉन्फ़िगरेशन स्क्रीन पर "मैन्युअल एक्सपोर्ट" टैप करें
2. एक तारीख सीमा चुनें
3. एक परीक्षण अनुरोध भेजने के लिए "एक्सपोर्ट" टैप करें
4. Home Assistant में जांचें कि सेंसर स्थिति बनाई/अपडेट की गई है

Home Assistant में सत्यापन

1. Home Assistant खोलें
2. Developer Tools > States पर जाएं
3. hae.{your_automation_name} (लोअरकेस, कोई रिक्त स्थान नहीं) खोजें
4. सत्यापित करें कि सेंसर स्थिति आपके स्वास्थ्य डेटा दिखाती है
5. हाल की सिंक की पुष्टि करने के लिए "अंतिम अपडेट" टाइमस्टैम्प जांचें

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

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

Home Assistant लॉग जांचना

यदि डेटा Home Assistant में दिखाई नहीं दे रहा है:

1. Home Assistant खोलें
2. Settings > System > Logs पर जाएं
3. REST API या सेंसर स्थितियों से संबंधित त्रुटियों की तलाश करें
4. प्रमाणीकरण त्रुटियों या अमान्य डेटा प्रारूप की जांच करें

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

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

प्रमाणीकरण त्रुटियां

• सत्यापित करें कि आपका लॉन्ग-लिव्ड एक्सेस टोकन सही है
• सुनिश्चित करें कि Authorization हेडर इस प्रकार फॉर्मेट किया गया है: Bearer YOUR_TOKEN
• जांचें कि टोकन समाप्त नहीं हुआ है या रद्द नहीं किया गया है
• सत्यापित करें कि टोकन में Home Assistant में उपयुक्त अनुमतियां हैं

सेंसर Home Assistant में दिखाई नहीं दे रहा

• जांचें कि ऑटोमेशन नाम में विशेष वर्ण नहीं हैं
• इकाई ID प्रारूप सत्यापित करें: hae.{automation_name} (लोअरकेस, कोई रिक्त स्थान नहीं)
• त्रुटियों के लिए Home Assistant लॉग जांचें
• सुनिश्चित करें कि API अनुरोध सफल था (गतिविधि लॉग जांचें)

डेटा अपडेट नहीं हो रहा

• जांचें कि ऑटोमेशन सक्षम है
• त्रुटियों के लिए गतिविधि लॉग की समीक्षा करें
• Home Assistant के लिए नेटवर्क कनेक्टिविटी सुनिश्चित करें

कनेक्शन टाइमआउट

• सत्यापित करें कि Home Assistant चल रहा है और सुलभ है
• नेटवर्क कनेक्टिविटी जांचें
• यदि Home Assistant धीरे-धीरे प्रतिक्रिया दे रहा है तो अनुरोध टाइमआउट सेटिंग बढ़ाएं
• सत्यापित करें कि URL और पोर्ट सही हैं

त्रुटि संदेश

ऐप त्रुटि संदेश प्रदर्शित करेगा यदि:

• URL अमान्य या पहुंच योग्य नहीं है
• प्रमाणीकरण विफल हो जाता है (Authorization हेडर जांचें)
• Home Assistant एक त्रुटि स्थिति कोड लौटाता है
• नेटवर्क कनेक्टिविटी उपलब्ध नहीं है

HTTP स्थिति कोड और Home Assistant से त्रुटि संदेश सहित विस्तृत त्रुटि जानकारी के लिए गतिविधि लॉग जांचें।

Home Assistant एकीकरण सुझाव

ऑटोमेशन में स्वास्थ्य डेटा का उपयोग करना

एक बार आपका स्वास्थ्य डेटा Home Assistant के साथ सिंक हो जाने के बाद, आप उन्हें ऑटोमेशन में उपयोग कर सकते हैं:

automation:
  - alias: "अच्छी नींद की गुणवत्ता"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "कल रात बहुत अच्छी नींद आई!"

डैशबोर्ड बनाना

अपने Home Assistant डैशबोर्ड में स्वास्थ्य मेट्रिक्स जोड़ें:

1. अपने डैशबोर्ड पर जाएं
2. एक नया कार्ड जोड़ें
3. "Entities" या "Gauge" कार्ड प्रकार चुनें
4. hae.{your_automation_name} सेंसर इकाइयां जोड़ें

सेंसर स्थिति संरचना

Home Assistant में सेंसर स्थिति में शामिल है:

• state: वर्तमान मान या स्थिति
• attributes: अतिरिक्त डेटा सहित:
  • टाइमस्टैम्प जानकारी
  • निर्यात किए गए JSON प्रारूप से मेल खाने वाली डेटा संरचना
  • जहां लागू हो वहां इकाई जानकारी

सुझाव और सर्वोत्तम अभ्यास

1. नामकरण:

   • समस्याएं पैदा कर सकने वाले विशेष वर्णों से बचें

2. डेटा चयन:

   • केवल उन मेट्रिक्स का चयन करें जिनकी आपको आवश्यकता है