ব্যবহারকারীরা যখন কোনো ডিভাইসের বর্তমান অবস্থা জানতে 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 } } } } }; });
জাভা
@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
intents হ্যান্ডেল
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" }] } }; });
জাভা
@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
জন্য, আরও বিশদ বিবরণের জন্য ত্রুটি এবং ব্যতিক্রম এবং ত্রুটি এবং ব্যতিক্রমগুলি পরিচালনা করুন দেখুন৷