स्मार्ट होम एनर्जीस्टोरेज ट्रैट स्कीमा

action.devices.traits.EnergyStorage - यह विशेषता उन डिवाइसों में शामिल है जो बैटरी में ऊर्जा सेव कर सकते हैं और रीचार्ज कर सकते हैं. इसके अलावा, यह उन डिवाइसों में भी होता है जो दूसरे डिवाइस को चार्ज कर सकते हैं.

डिवाइस ATTRIBUTES

इस एट्रिब्यूट वाले डिवाइस, SYNC ऑपरेशन के तहत, यहां दिए गए एट्रिब्यूट रिपोर्ट कर सकते हैं. SYNC इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

विशेषताएं	Type	ब्यौरा
queryOnlyEnergyStorage	बूलियन	ज़रूरी है. अगर यह डिवाइस सिर्फ़ सेव किए गए एनर्जी लेवल से जुड़ी क्वेरी के साथ काम करता है, तो वैल्यू 'सही' होगी. वैकल्पिक तौर पर, यह वैल्यू चालू चार्जिंग की स्थिति (isRechargeable एट्रिब्यूट पर निर्भर) के साथ काम करती है, लेकिन चार्जिंग को शुरू या बंद करने की सुविधा नहीं देती.
energyStorageDistanceUnitForUX	स्ट्रिंग	(डिफ़ॉल्ट: "KILOMETERS") लोगों को जवाब देने के लिए इसका इस्तेमाल किया जाएगा. इस्तेमाल की जा सकने वाली वैल्यू: KILOMETERS MILES
isRechargeable	बूलियन	(डिफ़ॉल्ट: false) अगर इस डिवाइस को रीचार्ज किया जा सकता है, तो 'सही है' पर सेट करें. इससे पता चलता है कि डिवाइस, capacityUntilFull, isCharging, और विकल्प के तौर पर isPluggedIn की स्थिति को रिपोर्ट कर सकता है और Charge निर्देश को स्वीकार कर सकता है.

उदाहरण

रीचार्ज हो सकने वाला डिवाइस

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

रीचार्ज हो सकने वाला डिवाइस, जो मौजूदा चार्जिंग लेवल को मील में दिखाता है

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

रिचार्ज नहीं किया जा सकने वाला ऐसा डिवाइस जिस पर सिर्फ़ मौजूदा शुल्क के लेवल की जानकारी मिलती है

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

डिवाइस की स्थितियां

इस trait वाली इकाइयां QUERY ऑपरेशन के हिस्से के तौर पर, यहां दिए गए स्टेटस की जानकारी दे सकती हैं. QUERY इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	Type	ब्यौरा
descriptiveCapacityRemaining	स्ट्रिंग	ज़रूरी है. ऊर्जा की क्षमता के लेवल की क्वालिटेटिव जानकारी. ध्यान दें कि ऐसा तब होता है, जब क्षमता वाला कोई डेटा मौजूद न हो. अगर संख्या के हिसाब से क्षमता वाला डेटा भी उपलब्ध है, तो जहां तक हो सके वहां ब्यौरे को प्राथमिकता दी जाएगी. इस्तेमाल की जा सकने वाली वैल्यू: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	कैटगरी	यूनिट/वैल्यू पेयर का कलेक्शन, जिनमें डिवाइस की मौजूदा ऊर्जा की क्षमता के बारे में जानकारी होती है. उदाहरण के लिए: फ़िलहाल, मेरे <device> में कितने मील की दूरी तय है या मेरे <device> की बैटरी कितने प्रतिशत चार्ज है
[item, ...]	ऑब्जेक्ट	यूनिट और वैल्यू पेयर में बची हुई कपैसिटी.
rawValue	Integer	ज़रूरी है. कपैसिटी की वैल्यू.
unit	स्ट्रिंग	ज़रूरी है. कपैसिटी यूनिट. इस्तेमाल की जा सकने वाली वैल्यू: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	कैटगरी	यूनिट/वैल्यू पेयर का कलेक्शन, जो डिवाइस के पूरी तरह चार्ज होने तक डिवाइस की क्षमता से जुड़ी जानकारी रखता है. उदाहरण के लिए: <device> के पूरी तरह चार्ज होने में कितना समय लगेगा.
[item, ...]	ऑब्जेक्ट	चार्ज होने तक क्षमता.
rawValue	Integer	ज़रूरी है. कपैसिटी की वैल्यू.
unit	स्ट्रिंग	ज़रूरी है. कपैसिटी यूनिट. इस्तेमाल की जा सकने वाली वैल्यू: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	बूलियन	डिवाइस फ़िलहाल चार्ज हो रहा है या नहीं.
isPluggedIn	बूलियन	डिवाइस फ़िलहाल प्लग-इन है या नहीं. डिवाइस प्लग-इन किया जा सकता है, लेकिन चार्ज नहीं हो रहा है.

उदाहरण

रीचार्ज हो सकने वाला डिवाइस

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

रीचार्ज हो सकने वाला डिवाइस, जो मौजूदा चार्जिंग लेवल को मील में दिखाता है

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

रिचार्ज नहीं किया जा सकने वाला ऐसा डिवाइस जो सिर्फ़ मौजूदा चार्ज लेवल की जानकारी देता है

{
  "descriptiveCapacityRemaining": "LOW"
}

डिवाइस COMMANDS

इस खूबी वाले डिवाइस, EXECUTE कार्रवाई के तहत, नीचे दिए गए निर्देशों का जवाब दे सकते हैं. EXECUTE इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

action.devices.commands.Charge

चार्जिंग शुरू या बंद करें.

इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है:

{
  "isRechargeable": true
}

पैरामीटर

पैरामीटर	Type	ब्यौरा
charge	बूलियन	ज़रूरी है. चार्ज करना शुरू करने के लिए 'सही', चार्जिंग रोकने के लिए 'गलत'.

उदाहरण

कमांड चार्ज करना शुरू करें

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

चार्ज करना बंद करने का निर्देश

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

डिवाइस ERRORS

गड़बड़ियों और अपवादों की पूरी सूची देखें.

deviceUnplugged: उपयोगकर्ता ने ऐसे डिवाइस को चार्ज करने की कोशिश की जो प्लग-इन नहीं है.