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

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

डिवाइस की विशेषताएं

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

विशेषताएं	टाइप	जानकारी
queryOnlyEnergyStorage	बूलियन	ज़रूरी है. अगर इस डिवाइस में सिर्फ़ सेव किए गए एनर्जी लेवल के बारे में क्वेरी की जाती हैं और विकल्प के तौर पर, चार्जिंग की स्थिति चालू हो, तो यह बात सही है. हालांकि, यह isRechargeable एट्रिब्यूट पर निर्भर करती है. हालांकि, इस डिवाइस से चार्जिंग को शुरू और बंद नहीं किया जा सकता.
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: उपयोगकर्ता ने चार्ज किए गए डिवाइस को चार्ज करने की कोशिश की.