क्वेरी और एक्ज़ीक्यूट करें

जब लोग किसी डिवाइस की मौजूदा स्थिति के बारे में क्वेरी करने के लिए, Google Assistant से इंटरैक्ट करते हैं, तब आपके फ़ुलफ़िलमेंट को डिवाइस आईडी की सूची वाला action.devices.QUERY इंटेंट मिलता है (जैसा कि आपके SYNC जवाब में बताया गया है). जब उपयोगकर्ता आपके डिवाइस को कंट्रोल करने के लिए, Assistant को निर्देश भेजते हैं, तो आपके फ़ुलफ़िलमेंट को action.devices.EXECUTE इंटेंट मिलता है.

QUERY इंटेंट हैंडल करें

आपके QUERY रिस्पॉन्स में, अनुरोध किए गए डिवाइस के साथ काम करने वाले हर एक विशेषता की स्थितियों का एक पूरा सेट शामिल होता है.

अनुरोध करें
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [{
          "id": "123",
          "customData": {
            "fooValue": 74,
            "barValue": true,
            "bazValue": "foo"
          }
        }, {
          "id": "456",
          "customData": {
            "fooValue": 12,
            "barValue": false,
            "bazValue": "bar"
          }
        }]
      }
    }]
}
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "on": true,
        "online": true
      },
      "456": {
        "on": true,
        "online": true,
        "brightness": 80,
        "color": {
          "name": "cerulean",
          "spectrumRGB": 31655
        }
      }
    }
  }
}
Node.js
const {smarthome} = require('actions-on-google');
const app = smarthome();
// ...
app.onQuery((body, headers) => {
  // TODO Get device state
  return {
    requestId: body.requestId,
    payload: {
      devices: {
        123: {
          on: true,
          online: true
        },
        456: {
          on: true,
          online: true,
          brightness: 80,
          color: {
            name: "cerulean",
            spectrumRGB: 31655
          }
        }
      }
    }
  };
});
Java
@NotNull
@Override
public QueryResponse onQuery(@NotNull QueryRequest queryRequest, @Nullable Map<?, ?> map) {
  QueryResponse.Payload payload = new QueryResponse.Payload();
  payload.setDevices(
      new HashMap<String, Map<String, Object>>() {
        {
          put(
              "123",
              new HashMap<String, Object>() {
                {
                  put("on", true);
                  put("online", true);
                }
              });
          put(
              "456",
              new HashMap<String, Object>() {
                {
                  put("on", true);
                  put("online", true);
                  put("brightness", 80);
                  put(
                      "color",
                      new HashMap<String, Object>() {
                        {
                          put("name", "cerulean");
                          put("spectrumRGB", 31655);
                        }
                      });
                }
              });
        }
      });

  return new QueryResponse(queryRequest.getRequestId(), payload);
}

ज़्यादा जानकारी के लिए, QUERY इंटेंट के रेफ़रंस का दस्तावेज़ देखें.

EXECUTE इंटेंट हैंडल करें

QUERY की तरह, एक इंटेंट कई डिवाइस आईडी को टारगेट कर सकता है. एक EXECUTE इंटेंट में, डिवाइसों के ग्रुप को दिए गए कई अलग-अलग निर्देश भी शामिल हो सकते हैं. उदाहरण के लिए, ट्रिगर किया गया इंटेंट, लाइटों के ग्रुप पर चमक और रंग, दोनों सेट कर सकता है या कई लाइटों को एक अलग रंग पर सेट कर सकता है. कार्रवाई पूरी होने के बाद, EXECUTE के रिस्पॉन्स में डिवाइस की नई स्थिति दिखेगी.

उपयोगकर्ता के डिवाइस की स्थिति में बदलाव होने पर, Report State का इस्तेमाल करें. उदाहरण के लिए, EXECUTE के इंटेंट या स्थानीय स्थिति में बदलाव की वजह से (जैसे, लाइट के स्विच को मैन्युअल तरीके से फ़्लिप करना). इससे Google Home Graph, आपकी क्लाउड सेवा के साथ सिंक रहता है.

अनुरोध करें
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [{
          "devices": [{
            "id": "123",
            "customData": {
              "fooValue": 74,
              "barValue": true,
              "bazValue": "sheepdip"
            }
          }, {
            "id": "456",
            "customData": {
              "fooValue": 36,
              "barValue": false,
              "bazValue": "moarsheep"
            }
          }],
          "execution": [{
            "command": "action.devices.commands.OnOff",
            "params": {
              "on": true
            }
          }]
        }]
      }
    }]
}
JSON
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      },
      {
        "ids": [
          "456"
        ],
        "status": "ERROR",
        "errorCode": "deviceTurnedOff"
      }
    ]
  }
}
Node.js
const {smarthome} = require('actions-on-google');
const app = smarthome();
// ...
app.onExecute((body, headers) => {
  // TODO Send command to device
  return {
    requestId: body.requestId,
    payload: {
      commands: [{
        ids: ["123"],
        status: "SUCCESS",
        states: {
          on: true,
          online: true
        }
      }, {
        ids: ["456"],
        status: "ERROR",
        errorCode: "deviceTurnedOff"
      }]
    }
  };
});
Java
@NotNull
@Override
public ExecuteResponse onExecute(
    @NotNull ExecuteRequest executeRequest, @Nullable Map<?, ?> map) {
  ExecuteResponse.Payload payload = new ExecuteResponse.Payload();

  payload.setCommands(
      new Commands[] {
        new Commands(
            new String[] {"123"},
            "SUCCESS",
            new HashMap<String, Object>() {
              {
                put("on", true);
                put("online", true);
              }
            },
            null,
            null),
        new Commands(new String[] {"456"}, "ERROR", null, "deviceTurnedOff", null)
      });
  return new ExecuteResponse(executeRequest.getRequestId(), payload);
}

ज़्यादा जानकारी के लिए, EXECUTE इंटेंट से जुड़ा दस्तावेज़ देखें.

स्थिति के जवाब

आपके QUERY और EXECUTE जवाबों में एक status फ़ील्ड शामिल होता है, ताकि अनुरोध के नतीजे की जानकारी दी जा सके. हर स्टेटस रिस्पॉन्स में इनमें से कोई एक वैल्यू हो सकती है:

  • SUCCESS: अनुरोध पूरा हो गया.
  • OFFLINE: टारगेट डिवाइस ऑफ़लाइन है या किसी और तरह से पहुंच में नहीं है.
  • EXCEPTIONS: अनुरोध से जुड़ी कोई समस्या या चेतावनी है.
  • ERROR: संबंधित errorCode से जुड़ा अनुरोध पूरा नहीं किया जा सका.

ERROR और EXCEPTIONS की ज़्यादा जानकारी के लिए, गड़बड़ियां और अपवाद मैनेज करना और गड़बड़ियां और अपवाद देखें.

पीछे जाएं
पहचानें और सिंक करें
आगे बढ़ें
डिसकनेक्ट करें