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

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

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

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

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

टेबल: आसान शब्दों में बताई गई विशेषताएं
आसान लक्षण स्टैंडर्ड ट्रेट
SimplifiedThermostatTrait ThermostatTrait
BrightnessTrait LevelControlTrait
SimplifiedOnOffTrait OnOffTrait
VolumeTrait LevelControlTrait
OnOffTrait

आसान बनाए गए एट्रिब्यूट और Discovery API

Discovery API, आसान शब्दों में बताई गई विशेषताओं के साथ-साथ उनकी बुनियादी विशेषताओं की जानकारी भी देता है. हालांकि, इसके लिए ज़रूरी है कि आपके ऐप्लिकेशन के कॉन्फ़िगरेशन में, दोनों विशेषताओं को ReferencedAutomationTypes के तौर पर सही तरीके से कॉन्फ़िगर किया गया हो. उदाहरण के लिए, अगर स्ट्रक्चर में DimmableLightDeviceType डिवाइस मौजूद है और डेवलपर ने LevelControlTrait और BrightnessTrait, दोनों विशेषताओं को रजिस्टर किया है, तो Discovery API दोनों विशेषताओं की मौजूदगी के बारे में बताएगा. डेवलपर, अपने ऑटोमेशन में इनमें से किसी भी ट्रेट का इस्तेमाल कर सकता है.

ज़्यादा जानकारी के लिए, होम कॉन्फ़िगरेशन देखें.