ค้นหาและดําเนินการ

เมื่อผู้ใช้โต้ตอบกับ Google Assistant เพื่อค้นหาสถานะปัจจุบันของอุปกรณ์ การดําเนินการตามคําสั่งซื้อจะได้รับ Intent action.devices.QUERY ที่มีรายการรหัสอุปกรณ์ (ตามที่การตอบกลับ SYNC กําหนด) การดําเนินการตามคําสั่งซื้อจะได้รับ Intent action.devices.EXECUTE เมื่อผู้ใช้ส่งคําสั่งไปที่ Assistant เพื่อควบคุมอุปกรณ์

จัดการ Intent ของ 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);
}

ดูข้อมูลเพิ่มเติมได้ในเอกสารอ้างอิง Intent ของ QUERY

จัดการ Intent ของ EXECUTE

เช่นเดียวกับ QUERY ความตั้งใจเดียวจะกําหนดเป้าหมายรหัสอุปกรณ์ได้หลายรหัส Intent เดี่ยวของ EXECUTE อาจมีคําสั่งที่แตกต่างกันหลายรายการที่กําหนดให้กับกลุ่มอุปกรณ์ ตัวอย่างเช่น Intent ที่ทริกเกอร์อาจตั้งค่าทั้งความสว่างและสีในกลุ่มหลอดไฟ หรือตั้งค่าไฟหลายดวงเป็นสีที่แตกต่างกัน การตอบสนอง 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);
}

ดูข้อมูลเพิ่มเติมได้ในเอกสารอ้างอิง Intent ของ EXECUTE

การตอบสนองสถานะ

การตอบกลับ QUERY และ EXECUTE จะมีช่อง status ในการรายงานผลของคําขอ การตอบกลับสถานะแต่ละครั้งสามารถระบุ ค่าใดค่าหนึ่งต่อไปนี้

  • SUCCESS: การร้องขอสําเร็จแล้ว
  • OFFLINE: อุปกรณ์เป้าหมายออฟไลน์อยู่หรือเข้าถึงไม่ได้
  • EXCEPTIONS: มีปัญหาหรือการแจ้งเตือนที่เกี่ยวข้องกับคําขอ
  • ERROR: คําขอล้มเหลวที่มี errorCode ที่ตรงกัน

สําหรับ ERROR และ EXCEPTIONS ดูรายละเอียดเพิ่มเติมได้ที่ข้อผิดพลาดและข้อยกเว้นในการจัดการ และข้อผิดพลาดและข้อยกเว้น

ก่อนหน้า
ระบุและซิงค์
ถัดไป
ยกเลิกการเชื่อมต่อ