स्मार्ट होम फ़िल ट्रैट स्कीमा

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

डिवाइस ATTRIBUTES

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

विशेषताएं	टाइप	ब्यौरा
availableFillLevels	ऑब्जेक्ट	डिवाइस की जानकारी भरने के अलग-अलग लेवल के बारे में जानकारी देता है.
levels	कैटगरी	ज़रूरी है. लेवल के नामों और भाषा के हिसाब से बने समानार्थी शब्दों की सूची.
[item, ...]	ऑब्जेक्ट	लेवल का नाम और उसकी भाषा के हिसाब से बने समानार्थी शब्द.
level_name	स्ट्रिंग	ज़रूरी है. लेवल का अंदरूनी नाम. ऐसा हो सकता है कि यह लोगों के लिए आसान न हो और इसे सभी भाषाओं में शेयर किया जाए.
level_values	कैटगरी	ज़रूरी है. हर समर्थित भाषा में लेवल के समानार्थी शब्द.
[item, ...]	ऑब्जेक्ट	किसी दी गई भाषा में लेवल के समानार्थी शब्द.
level_synonym	कैटगरी	ज़रूरी है. लेवल का समानार्थी शब्द. इस सूची की पहली स्ट्रिंग का इस्तेमाल उस भाषा में लेवल के कैननिकल नाम के तौर पर किया जाता है.
[item, ...]	स्ट्रिंग	समानार्थी शब्द का नाम.
lang	स्ट्रिंग	ज़रूरी है. भाषा कोड (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
  }
}

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

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

राज्य	टाइप	ब्यौरा
isFilled	बूलियन	ज़रूरी है. अगर डिवाइस किसी भी लेवल पर भरा हुआ है, तो वैल्यू 'सही' होगी. अगर डिवाइस पूरी तरह से खाली हो जाए, तो वैल्यू को गलत माना जाता है.
currentFillLevel	स्ट्रिंग	अगर availableFillLevels एट्रिब्यूट की वैल्यू सेट है, तो इसका इस्तेमाल करना ज़रूरी है. यह, availableFillLevels एट्रिब्यूट से उस मौजूदा level_name की जानकारी देता है जिस पर डिवाइस भरा गया है.
currentFillPercent	Number	अगर supportsFillPercent एट्रिब्यूट की वैल्यू सेट है, तो इसका इस्तेमाल करना ज़रूरी है. मौजूदा फ़िल लेवल का प्रतिशत दिखाता है.

उदाहरण

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

{
  "isFilled": true
}

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

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

डिवाइस COMMANDS

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

action.devices.commands.Fill

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

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
fill	बूलियन	ज़रूरी है. भरने के लिए 'सही', 'खाली करने के लिए 'गलत'.
fillLevel	स्ट्रिंग	availableFillLevels एट्रिब्यूट से सेट करने के लिए level_name को दिखाता है. अगर कोई जानकारी नहीं है, तो डिफ़ॉल्ट लेवल भरें.
fillPercent	Number	अनुरोध किए गए लेवल के प्रतिशत को दिखाता है.

उदाहरण

बैथटब को भरें.

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

डिवाइस ERRORS

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