ระบุและซิงค์

เมื่อคุณสร้างการกระทำ smart home แล้ว ขั้นตอนถัดไปคือการเพิ่มฟังก์ชันใน การดำเนินการตามคำสั่งซื้อเพื่อประมวลผล Intent ของสมาร์ทโฮมและแสดงผลคำตอบที่ Google Assistant จำได้

ระบุผู้ใช้

Assistant ส่งคำขอไปยัง smart home Fulfillment ของการดำเนินการด้วยโทเค็นเพื่อการเข้าถึงที่ระบุ โดยเซิร์ฟเวอร์ OAuth 2.0 ในส่วนหัว Authorization

POST /fulfillment HTTP/1.1
Host: smarthome.example.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

ก่อนตอบกลับคำขอ ตรรกะการดำเนินการตามคำสั่งซื้อควรยืนยันว่า ข้อมูลเข้าสู่ระบบโทเค็นนี้ถูกต้องและระบุบัญชีผู้ใช้ที่เชื่อมโยง ถ้า โทเค็นเพื่อการเข้าถึงไม่ถูกต้อง Fulfillment ของคุณควรแสดง ข้อผิดพลาด HTTP 401 Unauthorized

แสดงรายการอุปกรณ์และความสามารถ

เครื่องมือที่แนะนำสำหรับงานนี้

Assistant ส่ง action.devices.SYNC Intent การดำเนินการตามคำขอรายการอุปกรณ์ที่เชื่อมโยงกับผู้ใช้ที่กำหนดและ ความสามารถของตน การจำหน่ายของคุณต้องแสดงรหัสที่ไม่ซ้ำกันสำหรับผู้ใช้แต่ละรายใน ฟิลด์ agentUserId ของการตอบกลับ SYNC รหัสนี้ต้องเปลี่ยนแปลงไม่ได้ ค่าที่แสดงผู้ใช้ต่อบริการระบบคลาวด์ของคุณ เราไม่แนะนำให้ทำ ระบุอีเมลหรือแอตทริบิวต์อื่นๆ ตามการตั้งค่าที่ผู้ใช้สามารถ เปลี่ยน

ฟิลด์ devices ของคำตอบ SYNC มีอุปกรณ์ทั้งหมดที่ ผู้ใช้ได้ให้สิทธิ์ Assistant ในการเข้าถึง ประเภทและลักษณะ และแอตทริบิวต์ที่จำเป็นในการกำหนดค่าลักษณะการทำงานของลักษณะเฉพาะสำหรับ อุปกรณ์เครื่องนั้นโดยเฉพาะ

ระบบจะเรียกใช้ Intent SYNC ระหว่างการลิงก์บัญชีหรือเมื่อผู้ใช้ ระบบจะซิงค์อุปกรณ์ให้ใหม่ด้วยตนเอง หากผู้ใช้ รายการอุปกรณ์ที่รองรับ ลักษณะหรือค่าแอตทริบิวต์มีการเปลี่ยนแปลง ส่งคำขอซิงค์ เพื่อเรียกใช้ SYNC Intent และรายงานการอัปเดตไปยัง 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);
}

ดูข้อมูลเพิ่มเติมได้จาก Intent SYNC เอกสารอ้างอิง