Smart Home EnergyStorage Trait स्कीमा

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

डिवाइस ATTRIBUTES

इस विशेषता वाले डिवाइस ये रिपोर्ट कर सकते हैं 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"
}

डिवाइस COMMANDS

इस विशेषता वाले डिवाइस इन सुविधाओं के लिए काम कर सकते हैं 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
  }
}

डिवाइस ERRORS

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

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