Setelah membuat Tindakan smart home, langkah berikutnya adalah menambahkan fungsi di fulfillment Anda untuk memproses intent smart home dan menampilkan respons yang diidentifikasi Google Assistant.
Mengidentifikasi pengguna
Assistant membuat permintaan ke
fulfillment Action smart home Anda dengan token akses yang disediakan
oleh server OAuth 2.0 Anda di header Authorization.
POST /fulfillment HTTP/1.1 Host: smarthome.example.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN
Sebelum merespons permintaan apa pun, logika fulfillment Anda harus memverifikasi bahwa
kredensial token ini valid dan menentukan akun pengguna yang terkait. Jika
token akses tidak valid, fulfillment Anda akan menampilkan
error 401 Unauthorized HTTP.
Mencantumkan perangkat dan kemampuannya
Assistant mengirim intent action.devices.SYNC ke fulfillment Anda untuk meminta daftar perangkat yang terkait dengan pengguna tertentu dan kemampuannya. fulfillment Anda harus menampilkan ID unik untuk setiap pengguna dalam
kolom agentUserId dari respons SYNC. ID ini harus berupa nilai yang tidak dapat diubah
untuk mewakili pengguna ke layanan cloud Anda. Sebaiknya jangan
berikan alamat email atau atribut lain berdasarkan setelan yang dapat
diubah oleh pengguna.
Kolom devices dari respons SYNC Anda berisi semua perangkat
yang diberi otorisasi oleh Assistant untuk diakses pengguna, jenis dan karakteristik yang
didukungnya, serta atribut yang diperlukan untuk mengonfigurasi perilaku karakteristik untuk
perangkat tertentu tersebut.
Intent SYNC dipicu selama penautan akun atau saat pengguna
menyinkronkan ulang perangkat secara manual. Jika daftar perangkat, karakteristik
yang didukung, atau nilai atribut pengguna berubah, gunakan
Minta Sinkronisasi untuk memicu intent
SYNC baru dan melaporkan pembaruan ke 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);
}
Untuk informasi selengkapnya, lihat dokumentasi referensi intent
SYNC.