เมื่อผู้ใช้โต้ตอบกับ 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
ดูรายละเอียดเพิ่มเติมได้ที่ข้อผิดพลาดและข้อยกเว้นในการจัดการ และข้อผิดพลาดและข้อยกเว้น