بعد إنشاء عملية Cloud-to-cloudدمج، الخطوة التالية هي إضافة وظائف إلى عملية التنفيذ لمعالجة الطلبات المتعلقة بالمنزل الذكي وعرض ردود يتعرّف عليها Google Assistant.
تحديد هوية المستخدم
يرسل Assistant طلبات إلى
smart home Action لتنفيذ الطلب باستخدام رمز الدخول الذي يوفّره
خادم OAuth 2.0 في العنوان Authorization.
POST /fulfillment HTTP/1.1 Host: smarthome.example.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN
قبل الردّ على أي طلبات، يجب أن تتحقّق منطق التنفيذ من أنّ بيانات اعتماد الرمز المميز هذه صالحة وتحدّد حساب المستخدم المرتبط بها. إذا كان رمز الدخول غير صالح، يجب أن تعرض عملية التنفيذ الخطأ 401 Unauthorized في HTTP.
عرض قائمة بالأجهزة وإمكاناتها
يرسل Assistant غرض action.devices.SYNC إلى خدمة التنفيذ لطلب قائمة الأجهزة المرتبطة بالمستخدم المحدّد وإمكاناتها. يجب أن تعرض عملية التنفيذ معرّفًا فريدًا لكل مستخدم في الحقل agentUserId من الردّ SYNC. يجب أن يكون رقم التعريف هذا قيمة غير قابلة للتغيير
لتمثيل المستخدم في خدمتك السحابية. لا يُنصح بتقديم عناوين بريد إلكتروني أو سمات أخرى استنادًا إلى إعدادات يمكن للمستخدم تغييرها.
يحتوي حقل devices في استجابة SYNC على جميع الأجهزة التي منح المستخدم Assistant الإذن بالوصول إليها، وأنواعها وسماتها المتوافقة معها، والسمات المطلوبة لضبط سلوك السمة لهذا الجهاز المحدّد.
يتم تفعيل الغرض SYNC أثناء ربط الحساب أو عندما يعيد المستخدم مزامنة أجهزته يدويًا. في حال تغيير قائمة الأجهزة أو السمات المتوافقة أو قيم السمات الخاصة بالمستخدمين، استخدِم طلب المزامنة لتفعيل هدف SYNC جديد وإبلاغ Google بالتعديلات.
{
"requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
"inputs": [{
"intent": "action.devices.SYNC"
}]
}JSON
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "agentUserId": "1836.15267389", "devices": [ { "id": "123", "type": "action.devices.types.OUTLET", "traits": [ "action.devices.traits.OnOff" ], "name": { "defaultNames": [ "My Outlet 1234" ], "name": "Night light", "nicknames": [ "wall plug" ] }, "willReportState": false, "roomHint": "kitchen", "deviceInfo": { "manufacturer": "lights-out-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" }, "otherDeviceIds": [ { "deviceId": "local-device-id" } ], "customData": { "fooValue": 74, "barValue": true, "bazValue": "foo" } }, { "id": "456", "type": "action.devices.types.LIGHT", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.Brightness", "action.devices.traits.ColorSetting" ], "name": { "defaultNames": [ "lights out inc. bulb A19 color hyperglow" ], "name": "lamp1", "nicknames": [ "reading lamp" ] }, "willReportState": false, "roomHint": "office", "attributes": { "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 }, "commandOnlyColorSetting": false }, "deviceInfo": { "manufacturer": "lights out inc.", "model": "hg11", "hwVersion": "1.2", "swVersion": "5.4" }, "customData": { "fooValue": 12, "barValue": false, "bazValue": "bar" } } ] } }
Node.js
const {smarthome} = require('actions-on-google'); const app = smarthome(); // ... app.onSync((body, headers) => { // TODO Get devices for user return { requestId: body.requestId, payload: { agentUserId: "1836.15267389", devices: [{ id: "123", type: "action.devices.types.OUTLET", traits: [ "action.devices.traits.OnOff" ], name: { defaultNames: ["My Outlet 1234"], name: "Night light", nicknames: ["wall plug"] }, willReportState: false, roomHint: "kitchen", deviceInfo: { manufacturer: "lights-out-inc", model: "hs1234", hwVersion: "3.2", swVersion: "11.4" }, otherDeviceIds: [{ deviceId: "local-device-id" }], customData: { fooValue: 74, barValue: true, bazValue: "foo" } }, { id: "456", type: "action.devices.types.LIGHT", traits: [ "action.devices.traits.OnOff", "action.devices.traits.Brightness", "action.devices.traits.ColorSetting" ], name: { defaultNames: ["lights out inc. bulb A19 color hyperglow"], name: "lamp1", nicknames: ["reading lamp"] }, willReportState: false, roomHint: "office", attributes: { colorModel: 'rgb', colorTemperatureRange: { temperatureMinK: 2000, temperatureMaxK: 9000 }, commandOnlyColorSetting: false }, deviceInfo: { manufacturer: "lights out inc.", model: "hg11", hwVersion: "1.2", swVersion: "5.4" }, customData: { fooValue: 12, barValue: false, bazValue: "bar" } }] } }; });
Java
@NotNull @Override public SyncResponse onSync(@NotNull SyncRequest syncRequest, @Nullable Map<?, ?> map) { Payload payload = new Payload(); payload.setAgentUserId("1836.15267389"); payload.setDevices( new Device[] { new Device.Builder() .setId("123") .setType("action.devices.types.OUTLET") .addTrait("action.devices.traits.OnOff") .setName( Collections.singletonList("My Outlet 1234"), "Night light", Collections.singletonList("Wall plug")) .setWillReportState(true) .setDeviceInfo("lights-out-inc", "hs1234", "3.2", "11.4") .setCustomData( new JSONObject() .put("fooValue", 74) .put("barValue", true) .put("bazValue", "foo")) .build(), new Device.Builder() .setId("456") .setType("action.devices.types.LIGHT") .addTrait("action.devices.traits.OnOff") .addTrait("action.devices.traits.Brightness") .addTrait("action.devices.traits.ColorTemperature") .addTrait("action.devices.traits.ColorSpectrum") .setName( Collections.singletonList("Lights Out Inc. bulb A19 color hyperglow"), "Lamp", Collections.singletonList("Reading lamp")) .setWillReportState(true) .setDeviceInfo("Lights Out Inc.", "hg11", "1.2", "5.4") .setCustomData( new JSONObject() .put("fooValue", 12) .put("barValue", false) .put("bazValue", "bar")) .build(), }); return new SyncResponse(syncRequest.getRequestId(), payload); }
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات مرجع SYNC.