दूसरे उपयोगकर्ता की पुष्टि

ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप, ये हैं:

• ackNeeded simple
• ackNeeded with trait states

ackNeeded simple

इस उदाहरण में, रोशनी की चमक कम करने के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके, सामान्य अनुरोध और जवाब दिखाया गया है. साथ ही, रोशनी की चमक कम करने की पुष्टि भी दिखाई गई है.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.BrightnessAbsolute",
          "params": {
            "brightness": 12
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "ackNeeded"
      }
    }]
  }
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.BrightnessAbsolute",
          "params": {
            "brightness": 12
          },
          "challenge": {
            "ack": true
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "SUCCESS"
    }]
  }
}

ackNeeded with trait states

सेकंडरी यूज़र की पुष्टि करने के लिए, साफ़ तौर पर पुष्टि करने की सुविधा. इसमें, किसी खासियत के लिए स्थितियों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर TemperatureSetting की खासियत का इस्तेमाल किया जा रहा है और thermostatMode और thermostatTemperatureSetpoint दोनों सेट हैं, तो Assistant यह सवाल पूछ सकता है कि क्या आपको वाकई एयर कंडीशनर का तापमान 28 डिग्री सेल्सियस पर सेट करना है?

किसी दिए गए अनुरोध के आधार पर, Assistant से कोई खास कार्रवाई कराने के लिए, जवाब में स्थिति भी शामिल की जा सकती है.

यहां बताई गई खासियत और स्थितियों के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल किया जा सकता है. किसी खास खासियत की सूची से पता चलता है कि उसकी सभी स्थितियों के लिए, पुष्टि करने के लिए सवाल पूछने के इस टाइप का इस्तेमाल किया जा सकता है.

• ArmDisarm
• डिवाइस को चालू करने या चालू करने की प्रोसेस को रद्द करने के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करें. हालांकि, डिवाइस को बंद करने और बंद करने की प्रोसेस को रद्द करने के लिए, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करना ज़रूरी है.
• Fill
• LockUnlock
• डिवाइस को लॉक करने के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करें. वहीं, डिवाइस को अनलॉक करने के लिए, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करें.
• OnOff
• on
• इस खासियत के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करें. CAMERA डिवाइसों के साथ इस खासियत का इस्तेमाल करने पर, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करना ज़रूरी है.
• OpenClose
• इस खासियत के लिए, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करें. DOOR, GARAGE, GATE या WINDOW डिवाइसों के साथ इस खासियत का इस्तेमाल करने पर, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करना ज़रूरी है.
• Scene
• TemperatureSetting
• thermostatMode
• thermostatTemperatureSetpoint
• thermostatTemperatureSetpointHigh
• thermostatTemperatureSetpointLow

इस उदाहरण में, ackNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके, अनुरोध और जवाब दिखाया गया है. इसमें, खासियत की स्थिति का इस्तेमाल किया गया है. इससे, एयर कंडीशनर का मोड बदलकर हीट पर सेट हो जाता है और तापमान 28 डिग्री सेल्सियस पर सेट हो जाता है. इसके बाद, Assistant उपयोगकर्ताओं से हीट को चालू करने और तापमान को 28 डिग्री सेल्सियस पर सेट करने की पुष्टि करने के लिए कहता है. ऐसा इसलिए, क्योंकि जवाब में thermostatTemperatureSetpoint की स्थिति के तौर पर 28 दिखाया जाता है.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.TemperatureSetting",
          "params": {
            "thermostatMode": "heat"
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "states": {
        "thermostatMode": "heat",
        "thermostatTemperatureSetpoint": 28
      },
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "ackNeeded"
      }
    }]
  }
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.TemperatureSetting",
          "params": {
            "thermostatMode": "heat"
          },
          "challenge": {
            "ack": true
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "SUCCESS",
      "states": {
        "thermostatMode": "heat",
        "thermostatTemperatureSetpoint": 28
      }
    }]
  }
}

pinNeeded

सुरक्षा डिवाइसों के लिए, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करने का सुझाव दिया जाता है.

इस उदाहरण में, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके, शुरुआती अनुरोध और जवाब दिखाया गया है. इस उदाहरण में, pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके जवाब दिखाया गया है. इसलिए, Assistant पिन के लिए पूछता है. इस समय, उपयोगकर्ता गलत या सही पिन डाल सकता है.

गलत या सही पिन के लिए, अनुरोध और जवाब का उदाहरण:

• गलत पिन
• सही पिन

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.LockUnlock",
          "params": {
            "lock": false
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "pinNeeded"
      }
    }]
  }
}

गलत पिन

इस उदाहरण में, challengeFailedPinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके, अनुरोध और जवाब दिखाया गया है. pinNeeded पुष्टि करने के लिए सवाल पूछने के टाइप का इस्तेमाल करके, शुरुआती अनुरोध पूरा न होने के बाद, पुष्टि करने के लिए सवाल पूछने के इस टाइप का इस्तेमाल किया जाना चाहिए.

जब challengeFailedPinNeeded टाइप का इस्तेमाल करके जवाब दिया जाता है, तो Assistant सुरक्षा कोड के लिए फिर से पूछता है. अगर उपयोगकर्ता बहुत ज़्यादा बार गलत पिन डालता है, तो tooManyFailedAttempts गड़बड़ी का जवाब दिया जा सकता है. गड़बड़ी के जवाब देखें.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.LockUnlock",
          "params": {
            "lock": false
          },
          "challenge": {
            "pin": "333222"
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "challengeFailedPinNeeded"
      }
    }]
  }
}

सही पिन

इस उदाहरण में, सही पिन के लिए अनुरोध और जवाब दिखाया गया है.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.LockUnlock",
          "params": {
            "lock": false
          },
          "challenge": {
            "pin": "333444"
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "SUCCESS",
      "states": {
        "isLocked": false,
        "isJammed": false
      }
    }]
  }
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.BrightnessAbsolute",
          "params": {
            "brightness": 12
          }
        }]
      }]
    }
  }]
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["123"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "pinNeeded"
      }
    }]
  }
}

गड़बड़ी के जवाब

यहां गड़बड़ी के कुछ कोड दिए गए हैं. इन्हें आपके जवाबों के साथ दिखाया जा सकता है:

• tooManyFailedAttempts - माफ़ करें, आपने बहुत ज़्यादा बार गलत पिन डाला है. कृपया इस कार्रवाई को पूरा करने के लिए, अपने डिवाइस के ऐप्लिकेशन पर जाएं.
• pinIncorrect - माफ़ करें, सुरक्षा कोड गलत है.
• userCancelled - ठीक है

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