Smart Home EnergyStorage Trait Schema

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

डिवाइस की ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
queryOnlyEnergyStorage बूलियन

ज़रूरी है.

अगर यह डिवाइस सिर्फ़ सेव किए गए एनर्जी लेवल और चार्जिंग की स्थिति के बारे में क्वेरी करने की सुविधा देता है, तो वैल्यू के तौर पर True सेट करें. हालांकि, चार्जिंग की स्थिति के बारे में क्वेरी करने की सुविधा, isRechargeable एट्रिब्यूट पर निर्भर करती है. अगर यह डिवाइस चार्जिंग शुरू और बंद करने की सुविधा नहीं देता है, तो वैल्यू के तौर पर True सेट करें.
energyStorageDistanceUnitForUX String

(डिफ़ॉल्ट: "KILOMETERS")

इसका इस्तेमाल, उपयोगकर्ता को जवाब देने के लिए किया जाएगा.

इस्तेमाल की जा सकने वाली वैल्यू:

KILOMETERS
MILES
isRechargeable बूलियन

(डिफ़ॉल्ट: false)

अगर यह डिवाइस रीचार्ज किया जा सकता है, तो इसे सही पर सेट करें. इससे पता चलता है कि डिवाइस, capacityUntilFull, isCharging, और ज़रूरत पड़ने पर isPluggedIn की स्थिति की जानकारी दे सकता है. साथ ही, Charge कमांड को स्वीकार कर सकता है.

उदाहरण

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

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

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

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

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

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

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

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

राज्य टाइप ब्यौरा
descriptiveCapacityRemaining String

ज़रूरी है.

एनर्जी कैपेसिटी लेवल के बारे में जानकारी. ध्यान दें कि यह जानकारी तब दी जाती है, जब कैपेसिटी का संख्यात्मक डेटा उपलब्ध न हो. अगर कैपेसिटी का संख्यात्मक डेटा भी उपलब्ध है, तो जानकारी के साथ-साथ इसे भी दिखाया जाएगा.

इस्तेमाल की जा सकने वाली वैल्यू:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining ऐरे

यूनिट/वैल्यू पेयर का कलेक्शन जिसमें डिवाइस की मौजूदा ऊर्जा क्षमता के बारे में जानकारी होती है. उदाहरण के लिए: मेरे <device> में फ़िलहाल कितने मील की दूरी तय की गई है या मेरे <device> में बैटरी का कितना प्रतिशत चार्ज बचा है
[item, ...] ऑब्जेक्ट

यूनिट और वैल्यू पेयर में बची हुई क्षमता.
rawValue Integer

ज़रूरी है.

क्षमता की वैल्यू.
unit String

ज़रूरी है.

क्षमता की इकाई.

इस्तेमाल की जा सकने वाली वैल्यू:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull ऐरे

यूनिट/वैल्यू पेयर की ऐसी कैटगरी जिसमें डिवाइस के पूरी तरह चार्ज होने तक की क्षमता की जानकारी होती है. उदाहरण के लिए: <device> को पूरी तरह से चार्ज होने में कितना समय लगेगा.
[item, ...] ऑब्जेक्ट

चार्ज होने तक की क्षमता.
rawValue Integer

ज़रूरी है.

क्षमता की वैल्यू.
unit String

ज़रूरी है.

क्षमता की इकाई.

इस्तेमाल की जा सकने वाली वैल्यू:

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"
}

डिवाइस के लिए उपलब्ध कमांड

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

action.devices.commands.Charge

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

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

पैरामीटर

पैरामीटर टाइप ब्यौरा
charge बूलियन

ज़रूरी है.

चार्जिंग शुरू करने के लिए, इसे 'सही है' पर सेट करें. चार्जिंग बंद करने के लिए, इसे 'गलत है' पर सेट करें.

उदाहरण

चार्जिंग शुरू करने का निर्देश

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

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

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

डिवाइस से जुड़ी गड़बड़ियां

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

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