Kullanıcılar bir cihazın mevcut durumunu sorgulamak için Google Assistant ile etkileşimde bulunduğunda, sipariş karşılama işleminiz cihaz kimliklerinin listesini (SYNC
yanıtınızda sağlanan şekilde) içeren bir action.devices.QUERY
niyeti alır.
Kullanıcılar cihazınızı kontrol etmek için Assistant adresine komut gönderdiğinde, istek karşılama işleminiz action.devices.EXECUTE
niyeti alır.
QUERY
niyetini işleyin
QUERY
yanıtınız, istenen cihazların desteklediği özelliklerin her biri için tam bir durum grubu içerir.
{ "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); }
Daha fazla bilgi için QUERY
intent referans belgelerine göz atın.
EXECUTE
niyetini işleyin
QUERY
özelliğine benzer şekilde, tek bir amaç da birden fazla cihaz kimliğini hedefleyebilir. Tek bir EXECUTE
niyeti, bir cihaz grubuna verilen birden fazla farklı komutu da içerebilir. Örneğin, tetiklenen bir amaç bir grup ışıkta hem parlaklığı hem de rengi ayarlayabilir veya birden fazla ışığı her biri farklı bir renge ayarlayabilir. EXECUTE
yanıtınız, yürütme işleminden sonra cihazın yeni durumunu döndürecektir.
Kullanıcıların cihazının durumu değiştiğinde Report State simgesini kullanın. Örneğin, bir EXECUTE
niyeti veya yerel durum değişikliği nedeniyle (ör. bir ışık anahtarını manuel olarak çevirme).
Böylece Google Home Graph, bulut hizmetinizle senkronize edilir.
{ "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); }
Daha fazla bilgi için EXECUTE
amaç referans belgelerine bakın.
Durum yanıtları
QUERY
ve EXECUTE
yanıtlarınızda, isteğin sonucunu bildirmek için bir status
alanı bulunur. Her durum yanıtı, aşağıdaki değerlerden birini sağlayabilir:
SUCCESS
: İstek başarılı oldu.OFFLINE
: Hedef cihaz çevrimdışı veya başka bir şekilde erişilemez durumda.EXCEPTIONS
: İstekle ilişkili bir sorun veya uyarı var.ERROR
: İstek, ilgilierrorCode
ile başarısız oldu.
ERROR
ve EXCEPTIONS
ile ilgili daha fazla ayrıntı için Hataları ve istisnaları işleme ve Hatalar ve istisnalar bölümlerine bakın.