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

action.devices.traits.Fill - यह विशेषता, उन डिवाइसों पर लागू होती है जिनमें बाथटब भरा हुआ हो.

डिवाइस ATTRIBUTES

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

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

उदाहरण

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

{
  "isFilled": true
}

क्या बाथटब भर गया है? (अलग-अलग लेवल के साथ).

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

डिवाइस COMMANDS

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

action.devices.commands.Fill

डिवाइस में पानी भरें या उसे खाली करें.

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
fill	बूलियन	ज़रूरी है. भरने के लिए सही, खाली करने के लिए गलत.
fillLevel	String	सेट करने के लिए, 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

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