स्मार्ट होम में भरने की सुविधा के लिए, एट्रिब्यूट स्कीमा

action.devices.traits.Fill - यह एट्रिब्यूट, उन डिवाइसों पर लागू होता है जिन्हें भरा जा सकता है. जैसे, बाथटब.

डिवाइस के एट्रिब्यूट

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

एट्रिब्यूट टाइप ब्यौरा
availableFillLevels ऑब्जेक्ट

डिवाइस को भरने के अलग-अलग लेवल के बारे में बताता है.
levels ऐरे

ज़रूरी है.

लेवल के नामों और भाषा के हिसाब से मिलते-जुलते शब्दों की सूची.
[item, ...] ऑब्जेक्ट

लेवल का नाम और भाषा के हिसाब से मिलते-जुलते शब्द.
level_name String

ज़रूरी है.

लेवल का इंटरनल नाम. यह नाम, उपयोगकर्ता के लिए काम का नहीं हो सकता. इसे सभी भाषाओं में शेयर किया जाएगा.
level_values ऐरे

ज़रूरी है.

हर उस भाषा में लेवल के मिलते-जुलते शब्द जिसमें यह सुविधा उपलब्ध है.
[item, ...] ऑब्जेक्ट

किसी भाषा में लेवल के मिलते-जुलते शब्द. भाषा के फ़ॉलबैक की सुविधा देने के लिए, कम से कम एक आइटम में lang की वैल्यू en होनी चाहिए.
level_synonym ऐरे

ज़रूरी है.

लेवल का समानार्थी शब्द. इस सूची में मौजूद पहले स्ट्रिंग को, उस भाषा में लेवल के कैननिकल नाम के तौर पर इस्तेमाल किया जाता है.
[item, ...] String

समानार्थी शब्द का नाम. भाषा के फ़ॉलबैक की सुविधा देने के लिए, कम से कम एक आइटम में lang की वैल्यू en होनी चाहिए.
lang String

ज़रूरी है.

भाषा कोड (ISO 639-1). इस्तेमाल होने वाली भाषाएं देखें.
ordered बूलियन

ज़रूरी है.

अगर यह वैल्यू 'सही' है, तो डिवाइस, लेवल बढ़ाने या घटाने के लॉजिक के लिए, व्याकरण से जुड़ी अतिरिक्त जानकारी को मैनेज करता है. इसे levels ऐरे से दिखाया जाता है. उदाहरण के लिए, आधा लेवल.
supportsFillPercent बूलियन

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

अगर यह वैल्यू 'सही' है, तो लेवल को प्रतिशत के हिसाब से अडजस्ट करने के लिए, निर्देश स्वीकार करें.

उदाहरण

ऐसा डिवाइस जिसमें भरने या खाली करने की बुनियादी सुविधाएं हों, लेकिन अलग-अलग लेवल पर भरने की सुविधा न हो.

{}

ऐसा डिवाइस जिसमें अलग-अलग लेवल पर भरने की सुविधा हो.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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

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

राज्य टाइप ब्यौरा
isFilled बूलियन

ज़रूरी है.

अगर डिवाइस किसी भी लेवल पर भरा हुआ है, तो यह वैल्यू 'सही' होगी. अगर डिवाइस पूरी तरह से खाली है, तो यह वैल्यू 'गलत' होगी.
currentFillLevel String

अगर availableFillLevels एट्रिब्यूट सेट है, तो यह वैल्यू ज़रूरी है. यह availableFillLevels एट्रिब्यूट से मौजूदा level_name दिखाता है, जिस पर डिवाइस भरा हुआ है.
currentFillPercent Number

अगर supportsFillPercent एट्रिब्यूट सेट है, तो यह वैल्यू ज़रूरी है. यह मौजूदा फ़िल लेवल का प्रतिशत दिखाता है.

वैल्यू 0 और 100 के बीच होनी चाहिए.

उदाहरण

क्या बाथटब भरा हुआ है?

{
  "isFilled": true
}

क्या बाथटब भरा हुआ है? (लेवल के साथ).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

डिवाइस के निर्देश

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

action.devices.commands.Fill

डिवाइस को भरो या खाली करो.

पैरामीटर

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

ज़रूरी है.

भरने के लिए 'सही' और खाली करने के लिए 'गलत'.
fillLevel String

यह availableFillLevels एट्रिब्यूट से सेट करने के लिए, level_name दिखाता है. अगर कोई लेवल तय नहीं किया गया है, तो डिफ़ॉल्ट लेवल तक भरें.
fillPercent Number

यह अनुरोध किए गए लेवल का प्रतिशत दिखाता है.

वैल्यू 0 और 100 के बीच होनी चाहिए.

उदाहरण

बाथटब भरो.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

बाथटब खाली करो.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

बाथटब आधा भरो.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

बाथटब का लेवल एक से बढ़ाओ (इसके लिए, ordered एट्रिब्यूट की वैल्यू true होनी चाहिए).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

डिवाइस में गड़बड़ियां

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