smart home アクションを作成したら、次のステップとして フルフィルメントでスマートホーム インテントを処理し、 Google Assistant で認識されます。
ユーザーを特定する
Assistant は
smart home 提供されたアクセス トークンを使用したアクションのフルフィルメント
Authorization ヘッダーで OAuth 2.0 サーバーによって書き込まれます。
POST /fulfillment HTTP/1.1 Host: smarthome.example.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN
フルフィルメント ロジックでは、リクエストに応答する前にこのトークンの認証情報が有効であることを確認し、関連付けられているユーザー アカウントを特定する必要があります。条件
アクセス トークンが無効な場合、フルフィルメントは
HTTP 401 Unauthorized エラー。
デバイスと機能のリストを入手する
<ph type="x-smartling-placeholder"></ph>
このタスクに推奨されるツール
Assistant がメッセージを送信
action.devices.SYNC インテントを
指定したユーザーと関連付けられたデバイスのリストをリクエストするフルフィルメント
強化できます。フルフィルメントでは、ユーザーごとに一意の ID を返す必要があります。
SYNC レスポンスの agentUserId フィールド。この ID は不変である必要があります。
値を使用して、クラウド サービスでユーザーを表すことができます。推奨されません。
ユーザーが実行できる設定に基づいて、メールアドレスなどの属性を指定します。
あります。
SYNC レスポンスの devices フィールドには、
ユーザーが Assistant にアクセスを許可していますが、
さまざまなタイプやトレイト
トレイトの動作を設定するために必要な属性など、
許可します。
SYNC インテントは、アカウントをリンクしたとき、またはユーザーが手動でデバイスを再同期したときにトリガーされます。ユーザーのデバイスのリスト、サポートされている
変更する場合は、リソース属性を使用して
Request 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 インテントをご覧ください。
ご覧ください。