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

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

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

इस सुविधा का इस्तेमाल करने वाले डिवाइस, 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
  }
}

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

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

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

उदाहरण

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

{
  "isFilled": true
}

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

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

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

इस सुविधा का इस्तेमाल करने वाले डिवाइस, 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"
  }
}

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

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