स्मार्ट होम के लिए, OpenClose Trait का स्कीमा

action.devices.traits.OpenClose - यह trait, उन डिवाइसों के लिए है जिन्हें खोला और बंद किया जा सकता है. साथ ही, कुछ मामलों में उन्हें आंशिक रूप से खोला और बंद किया जा सकता है या एक से ज़्यादा दिशाओं में खोला और बंद किया जा सकता है.

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

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

विशेषताएं टाइप ब्यौरा
discreteOnlyOpenClose बूलियन

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

इसे 'सही है' पर सेट करने का मतलब है कि डिवाइस को पूरी तरह से खोला या बंद किया जाना चाहिए. इसका मतलब है कि यह 0% और 100% के बीच की वैल्यू को सपोर्ट नहीं करता.
openDirection ऐरे

उन दिशाओं की सूची जिनमें डिवाइस को खोला या बंद किया जा सकता है. अगर डिवाइस को एक से ज़्यादा दिशाओं में खोला और बंद किया जा सकता है, तो इस एट्रिब्यूट को शामिल करें.
[item, ...] String

वह दिशा जिसमें डिवाइस को खोला या बंद किया जा सकता है.

इस्तेमाल की जा सकने वाली वैल्यू:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose बूलियन

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

इससे पता चलता है कि डिवाइस, एकतरफ़ा (सही है) या दोतरफ़ा (गलत है) कम्यूनिकेशन का इस्तेमाल कर सकता है या नहीं. अगर डिवाइस, इस trait के लिए QUERY इंटेंट या Report State का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को 'सही है' पर सेट करें.
queryOnlyOpenClose बूलियन

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

इससे पता चलता है कि डिवाइस से सिर्फ़ उसकी स्थिति के बारे में क्वेरी की जा सकती है और उसे कंट्रोल नहीं किया जा सकता. ऐसे सेंसर जो सिर्फ़ खुली स्थिति की रिपोर्ट कर सकते हैं उन्हें इस फ़ील्ड को 'सही है' पर सेट करना चाहिए.

उदाहरण

डिवाइस को खोलने और बंद करने का सामान्य उदाहरण.

{
  "discreteOnlyOpenClose": true
}

डिवाइस को ऊपर से नीचे और नीचे से ऊपर की ओर खोलने और बंद करने का उदाहरण. इसे किसी भी दिशा में खोला जा सकता है.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

सिर्फ़ निर्देश से खुलने और बंद होने वाले डिवाइस का उदाहरण.

{
  "commandOnlyOpenClose": false
}

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

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

पेलोड में इनमें से कोई एक स्थिति शामिल होती है:

एक दिशा में खुलने और बंद होने वाले डिवाइस

स्थितियां टाइप ब्यौरा
openPercent Number

ज़रूरी है.

इससे पता चलता है कि डिवाइस कितने प्रतिशत खुला है. इसमें 0 का मतलब है कि डिवाइस बंद है और 100 का मतलब है कि डिवाइस पूरी तरह से खुला है.

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

यह लेवल, डिवाइस के खुलने के प्रतिशत को दिखाता है. यह बताता है कि डिवाइस किस लेवल पर खुलेगा या अपनी जगह में हो रहे बदलाव की वजह से किस लेवल पर खुल रहा है.

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

एक से ज़्यादा दिशाओं में खुलने और बंद होने वाले डिवाइस

स्थितियां टाइप ब्यौरा
openState ऐरे

ज़रूरी है.

हर दिशा में खुलने के लिए, स्थितियों की सूची.
[item, ...] ऑब्जेक्ट

डिवाइस के खुलने की दी गई दिशा के लिए, मौजूदा स्थिति.
openPercent Number

ज़रूरी है.

इससे पता चलता है कि डिवाइस कितने प्रतिशत खुला है. इसमें 0 का मतलब है कि डिवाइस बंद है और 100 का मतलब है कि डिवाइस पूरी तरह से खुला है.

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

यह लेवल, डिवाइस के खुलने के प्रतिशत को दिखाता है. यह बताता है कि डिवाइस किस लेवल पर खुलेगा या अपनी जगह में हो रहे बदलाव की वजह से किस लेवल पर खुल रहा है.

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

ज़रूरी है.

वह दिशा जिसमें डिवाइस को खोला गया है.

इस्तेमाल की जा सकने वाली वैल्यू:

UP
DOWN
LEFT
RIGHT
IN
OUT

उदाहरण

डिवाइस को खोलने और बंद करने का सामान्य उदाहरण.

{
  "openPercent": 100
}

डिवाइस को खोलने और बंद करने का सामान्य उदाहरण. यह डिवाइस फ़िलहाल किसी नई जगह पर खुल रहा है.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

डिवाइस को नीचे की ओर 30% और ऊपर की ओर 50% खोलने का उदाहरण.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

डिवाइस को नीचे की ओर 30% और ऊपर की ओर 50% खोलने का उदाहरण. यह डिवाइस फ़िलहाल ऊपर की ओर 80% खुल रहा है.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

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

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

action.devices.commands.OpenClose

डिवाइस के खुलने और बंद होने की स्थिति सेट करें.

पैरामीटर

पैरामीटर टाइप ब्यौरा
openPercent Number

ज़रूरी है.

इससे पता चलता है कि डिवाइस कितने प्रतिशत खुला है. इसमें 0 का मतलब है कि डिवाइस बंद है और 100 का मतलब है कि डिवाइस पूरी तरह से खुला है.

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

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

इस्तेमाल की जा सकने वाली वैल्यू:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

फ़ॉलो-अप रिस्पॉन्स के लिए, Google की ओर से दिया गया टोकन.

उदाहरण

डिवाइस को खोलें.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

डिवाइस को नीचे की ओर 50% खोलें.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

डिवाइस के खुलने और बंद होने की स्थिति सेट करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

lockedState
deviceJammingDetected

फ़ॉलो-अप रिस्पॉन्स

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

पेलोड में इनमें से कोई एक स्थिति शामिल होती है:

पुष्टि हो गई

फ़ील्ड टाइप ब्यौरा
followUpToken String

ज़रूरी है.

EXECUTE के मूल अनुरोध में दिया गया टोकन.
status String

ज़रूरी है.

अनुरोध का नतीजा.

इस्तेमाल की जा सकने वाली वैल्यू:

SUCCESS
openPercent Number

ज़रूरी है.

इससे पता चलता है कि डिवाइस कितने प्रतिशत खुला है. इसमें 0 का मतलब है कि डिवाइस बंद है और 100 का मतलब है कि डिवाइस पूरी तरह से खुला है.

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

अपलोड नहीं हुआ

फ़ील्ड टाइप ब्यौरा
followUpToken String

ज़रूरी है.

EXECUTE के मूल अनुरोध में दिया गया टोकन.
status String

ज़रूरी है.

अनुरोध का नतीजा.

इस्तेमाल की जा सकने वाली वैल्यू:

FAILURE
errorCode String

ज़रूरी है.

इस trait के लिए, कोई भी गड़बड़ी कोड इस्तेमाल किया जा सकता है. जैसे, lockedState.

उदाहरण

गैरेज का दरवाज़ा खोलें. (सफलता के मामले के लिए फ़ॉलो-अप रिस्पॉन्स)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

गैरेज का दरवाज़ा खोलें. (गड़बड़ी के मामले के लिए फ़ॉलो-अप रिस्पॉन्स)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

डिवाइस के खुलने और बंद होने की स्थिति को, मौजूदा स्थिति के हिसाब से अडजस्ट करें. यह निर्देश सिर्फ़ तब उपलब्ध होता है, जब discreteOnlyOpenClose को false पर सेट किया गया हो.

इस निर्देश के लिए, ये एट्रिब्यूट ज़रूरी हैं: 
{
  "discreteOnlyOpenClose": false
}

पैरामीटर

पैरामीटर टाइप ब्यौरा
openRelativePercent Number

ज़रूरी है.

डिवाइस के खुलने और बंद होने की स्थिति में बदलाव करने का सटीक प्रतिशत. डिवाइस के खुलने और बंद होने की स्थिति में बदलाव करने के ऐसे निर्देश जिन्हें सटीक प्रतिशत में नहीं बदला जा सकता उन्हें सटीक प्रतिशत वाले पैरामीटर में बदल दिया जाएगा. उदाहरण के लिए, "ब्लाइंड को थोड़ा और खोलें" को "ब्लाइंड को 5% खोलें" में बदल दिया जाएगा.

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

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

इस्तेमाल की जा सकने वाली वैल्यू:

UP
DOWN
LEFT
RIGHT
IN
OUT

उदाहरण

डिवाइस को थोड़ा और खोलें

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

डिवाइस को 10% और बंद करें

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

डिवाइस को नीचे की ओर 50% और खोलें.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

डिवाइस के खुलने और बंद होने की स्थिति सेट करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

lockedState
deviceJammingDetected

बोलने के सैंपल

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

डिवाइस से जुड़ी गड़बड़ियां

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