Android पर आसानी से इस्तेमाल किए जा सकने वाले ट्रैट

इस्तेमाल में आसानी के लिए, कुछ विशेषताओं के आसान वर्शन उपलब्ध हैं. इनका इस्तेमाल, Android पर Automation API के साथ किया जा सकता है.

आसान ट्रेट, स्टैंडर्ड Home API ट्रेट की जगह इस्तेमाल किया जाता है. यह ठीक उसी तरह काम करता है जिस तरह फ़साड पैटर्न काम करता है. सिंप्लिफ़ाइड ट्रेट, ऐसे निर्देश देते हैं जिनसे कुछ खास तरह के डिवाइसों के लिए सामान्य टास्क आसान हो जाते हैं. सिंप्लिफ़ाइड ट्रेट, Home API के ट्रेट होते हैं. अन्य Home API ट्रेट की तरह ही, ये Matter और Cloud-to-cloud, दोनों डिवाइसों के लिए काम करते हैं.

सिंप्लिफ़ाइड ट्रेट, एट्रिब्यूट और कमांड का एक वैकल्पिक सबसेट उपलब्ध कराता है. यह सबसेट, स्टैंडर्ड ट्रेट के मुकाबले डिवाइस के हिसाब से ज़्यादा सटीक होता है. उदाहरण के लिए, स्टैंडर्ड LevelControl ट्रेट एक सामान्य ट्रेट है. इसका इस्तेमाल ऐसे किसी भी डिवाइस के लिए किया जा सकता है जिसमें ऐसी सेटिंग हो जो अंकों वाली वैल्यू की रेंज में लगातार बदलती रहती है. Brightness एक आसान ट्रेट है, जो LevelControl की जगह इस्तेमाल होता है. यह सिर्फ़ वे निर्देश और एट्रिब्यूट उपलब्ध कराता है जिनकी ज़रूरत DimmableLight डिवाइस को होती है. Brightness में एक moveToBrightness कमांड होता है, जो एक brightnessPercent आर्ग्युमेंट लेता है. वहीं, LevelControl में कई move कमांड होते हैं. इनमें से ज़्यादातर में कम से कम चार पैरामीटर होते हैं, ताकि इस्तेमाल के ज़्यादा से ज़्यादा उदाहरणों को शामिल किया जा सके.

यहां दी गई टेबल में, हर आसान विशेषता और उससे जुड़ी स्टैंडर्ड विशेषताओं के बारे में बताया गया है. हर trait का नाम, उससे जुड़े एपीआई दस्तावेज़ से लिंक होता है:

आसान ट्रेट और Discovery API

Discovery API, आसान ट्रेट के साथ-साथ उनसे जुड़े स्टैंडर्ड ट्रेट की जानकारी भी देता है. हालांकि, इसके लिए ज़रूरी है कि दोनों ट्रेट FactoryRegistry में रजिस्टर किए गए हों. उदाहरण के लिए, अगर होम स्ट्रक्चर में कोई DimmableLight डिवाइस मौजूद है और डेवलपर ने FactoryRegistry में LevelControl और Brightness, दोनों ट्रेट रजिस्टर किए हैं, तो Discovery API दोनों ट्रेट की मौजूदगी दिखाएगा. डेवलपर अपने ऑटोमेशन में, इनमें से किसी भी विशेषता का इस्तेमाल कर सकता है.

ज़्यादा जानकारी के लिए, Android पर Discovery API देखें.

आसान ट्रेट के साथ काम करने वाले डिवाइस की जानकारी पाना

Device API का इस्तेमाल करके, किसी स्ट्रक्चर में मौजूद ऐसे डिवाइसों की जानकारी हासिल करते समय जो SimplifiedThermostat जैसी आसान सुविधा के साथ काम करते हैं, has(trait) तरीके का इस्तेमाल नहीं किया जा सकता. इसके बजाय, has(deviceType) वाला तरीका इस्तेमाल करें:

val thermostat = home.devices().list().first { device -> device.has(ThermostatDevice) }