लेन-देन की जानकारी पढ़ें
Matter में नोड के साथ इंटरैक्ट करते समय सबसे पहले इस्तेमाल किए जाने वाले उदाहरणों में से एक है, किसी दूसरे नोड से किसी एट्रिब्यूट को पढ़ना. जैसे, सेंसर से लिया गया तापमान की वैल्यू. ऐसे इंटरैक्शन में, सबसे पहले की जाने वाली कार्रवाई, पढ़ने के अनुरोध की कार्रवाई होती है.
![रीड ट्रांज़ैक्शन की कार्रवाइयों का क्रम](https://developers.home.google.com/static/matter/primer/images/primer-im-reading.png?authuser=0&hl=hi)
अनुरोध पर कार्रवाई पढ़ें
डायरेक्शन: शुरू करने वाला -> टारगेट
इस कार्रवाई में, शुरू करने वाला किसी टारगेट से क्वेरी करता है, जो यह देता है:
- एट्रिब्यूट के अनुरोध: टारगेट के शून्य या उससे ज़्यादा एट्रिब्यूट की सूची. इस सूची में टारगेट के अनुरोध किए गए एट्रिब्यूट के शून्य या उससे ज़्यादा पाथ हैं.
- इवेंट के अनुरोध: टारगेट के लिए अनुरोध किए गए इवेंट के शून्य या उससे ज़्यादा पाथ की सूची.
टारगेट को, डेटा पढ़ने का अनुरोध मिलने के बाद, यह मांगी गई जानकारी के साथ रिपोर्ट डेटा ऐक्शन इकट्ठा करेगा.
रिपोर्ट डेटा की कार्रवाई
डायरेक्शन: टारगेट -> शुरू करने वाला
इस कार्रवाई में टारगेट, इसके साथ जवाब देता है:
- एट्रिब्यूट रिपोर्ट: रिपोर्ट किए गए शून्य या उससे ज़्यादा एट्रिब्यूट की सूची, जिनका अनुरोध रीड ऐक्शन रिक्वेस्ट के तहत किया गया है.
- इवेंट रिपोर्ट: रिपोर्ट किए गए शून्य या उससे ज़्यादा इवेंट की सूची.
- सप्रेस रिस्पॉन्स: यह ऐसा फ़्लैग है जो तय करता है कि इस कार्रवाई के लिए स्टेटस रिस्पॉन्स को छिपाया जाना चाहिए या नहीं.
- सदस्यता आईडी: अगर यह रिपोर्ट, सदस्यता वाले किसी लेन-देन का हिस्सा है, तो इसमें एक पूर्णांक शामिल होना चाहिए. इसका इस्तेमाल, सदस्यता के लेन-देन की पहचान करने के लिए किया जाता है.
स्टेटस रिस्पॉन्स कार्रवाई
निर्देश: टारगेट -> इसे शुरू करने वाला या इसे शुरू करने वाला -> टारगेट
जब शुरू करने वाले व्यक्ति को अनुरोध किया गया डेटा मिल जाता है, तब उसे डिफ़ॉल्ट रूप से स्टेटस रिस्पॉन्स ऐक्शन जनरेट करना चाहिए. यह कार्रवाई, रिपोर्ट किया गया डेटा मिलने की सूचना देते हुए, रिपोर्ट शुरू करने वाले व्यक्ति से भेजी जाती है. अगर 'स्थिति जवाब रोकें' फ़्लैग को सेट किया गया है, तो इसे शुरू करने वाले व्यक्ति को स्थिति जवाब की कार्रवाई नहीं भेजनी चाहिए.
स्थिति के हिसाब से कार्रवाई शुरू करने वाले व्यक्ति के भेजे जाने या 'सप्रेस रिस्पॉन्स फ़्लैग' को चालू करके, 'रिपोर्ट डेटा ऐक्शन' शुरू करने पर, क्वेरी पढ़ना/रिपोर्ट करना खत्म हो जाता है.
स्थिति जवाब की कार्रवाई में बस एक status फ़ील्ड होता है, जो कार्रवाई की सफलता को स्वीकार करेगा या विफलता कोड दिखाएगा.
पाबंदियां पढ़ें
'पढ़ें अनुरोध कार्रवाई' और रिपोर्ट डेटा की कार्रवाई Unicast-सिर्फ़ हैं. इसके अलावा, हो सकता है कि इन अनुरोधों के पाथ, नोड के ग्रुप को टारगेट न कर पाएं.
स्टेटस रिस्पॉन्स ऐक्शन सिर्फ़ Unicast के लिए है. इसे ग्रुपकास्ट के रिस्पॉन्स के तौर पर जनरेट नहीं किया जा सकता.
सदस्यता से जुड़ा लेन-देन
![सदस्यता के लेन-देन का क्रम](https://developers.home.google.com/static/matter/primer/images/primer-im-subscribing.png?authuser=0&hl=hi)
सदस्यता लेने के अनुरोध पर कार्रवाई
डायरेक्शन: शुरू करने वाला -> टारगेट
पढ़ने के एक बार किए जाने वाले अनुरोध के अलावा, शुरू करने वाला किसी एट्रिब्यूट या इवेंट के समय-समय पर होने वाले अपडेट की सदस्यता भी ले सकता है. इसलिए, सदस्यता के लेन-देन के बाद, समय-समय पर डेटा अपडेट होने से, रिपोर्ट के लिए यही कार्रवाई जनरेट की जा सकती है.
सदस्यता इंटरैक्शन दो नोड के बीच एक संबंध बनाता है, जिसमें टारगेट समय-समय पर शुरू करने वाले को रिपोर्ट डेटा कार्रवाइयां जनरेट करता है. शुरुआत करने वाला व्यक्ति सदस्य और टारगेट प्रकाशक होता है.
सदस्यता के अनुरोध की कार्रवाई में ये चीज़ें शामिल होती हैं:
- कम से कम इंटरवल फ़्लोर: रिपोर्ट के बीच का कम से कम इंटरवल.
- मैक्स इंटरवल सीलिंग: रिपोर्ट के बीच ज़्यादा से ज़्यादा इंटरवल.
- एट्रिब्यूट रिपोर्ट: रिपोर्ट किए गए शून्य या उससे ज़्यादा एट्रिब्यूट की सूची, जिनका अनुरोध रीड ऐक्शन रिक्वेस्ट के तहत किया गया है.
- इवेंट रिपोर्ट: रिपोर्ट किए गए शून्य या उससे ज़्यादा इवेंट की सूची.
सदस्यता लेने के अनुरोध के बाद, टारगेट, रिपोर्ट डेटा ऐक्शन शुरू करने वाले को जवाब देता है. इसमें रिपोर्ट किए गए डेटा का पहला बैच: पब्लिश किया गया अनुमानित डेटा शामिल होता है.
इसके बाद, शुरू करने वाला व्यक्ति, टारगेट को भेजे गए स्टेटस रिस्पॉन्स ऐक्शन के साथ रिपोर्ट डेटा ऐक्शन को स्वीकार करता है. जब टारगेट को स्थिति से जुड़ी कार्रवाई के तौर पर कोई गड़बड़ी न होने की शिकायत मिलती है, तो वह 'सदस्यता लें' वाली कार्रवाई भेजता है.
टारगेट, बाद में तय किए गए समय-समय पर, रिपोर्ट डेटा से जुड़ी कार्रवाई को भेजेगा. साथ ही, शुरू करने वाला व्यक्ति इन कार्रवाइयों के जवाब तब तक देगा, जब तक कि सदस्यता रद्द नहीं हो जाती या सदस्यता रद्द नहीं हो जाती.
सदस्यता लेने पर मिलने वाली कार्रवाई
डायरेक्शन: टारगेट -> शुरू करने वाला
सदस्यता से जुड़े लेन-देन के लिए यह आखिरी कार्रवाई है. इससे प्रोसेस पूरी होती है. इसमें ये चीज़ें शामिल हैं:
- सदस्यता आईडी: एक पूर्णांक जो सदस्यता की पहचान करता है.
- कम से कम इंटरवल: रिपोर्ट के बीच फ़ाइनल, तय कम से कम इंटरवल.
- मैक्स इंटरवल: रिपोर्ट के बीच फ़ाइनल, तय किया गया ज़्यादा से ज़्यादा इंटरवल.
सदस्यता लेने से जुड़ी पाबंदियां
- सदस्यता के अनुरोध की कार्रवाई और 'सदस्यता का जवाब' कार्रवाई, Unicast सिर्फ़ कार्रवाइयां हैं.
- सदस्यता पर किए जाने वाले इंटरैक्शन में, रिपोर्ट के लिए डेटा से जुड़ी सभी कार्रवाइयों का सदस्यता आईडी एक ही होना चाहिए.
- अगर सदस्य को Actions के बीच, तय किए गए ज़्यादा से ज़्यादा समय में रिपोर्ट डेटा ऐक्शन नहीं मिलता है, तो सदस्यता खत्म कर दी जाएगी.
- पिछले नियम की वजह से, समय-समय पर रिपोर्ट डेटा से जुड़ी कार्रवाइयां भेजकर पब्लिशर को सदस्यता इंटरैक्शन बंद करना पड़ सकता है.
- सदस्य,
INACTIVE_SUBSCRIPTION
स्टेटस कोड के साथ रिपोर्ट डेटा ऐक्शन का जवाब देकर, सदस्यता इंटरैक्शन को बंद कर सकता है.