データモデル オブジェクトの値を使用して、シーン内で条件付きロジックを実行できます。以降のセクションでは、条件の有効な構文について説明します。
論理演算子
演算子 | 説明 |
---|---|
&& |
論理 AND。内部式は繰り返し評価され、いずれかの式が false と評価されると評価が短くなります。 |
|| |
論理 OR。内部式は繰り返し評価され、いずれかの式が true と評価されると評価が短くなります。 |
! |
論理 NOT。内部式の評価が否定されている |
数値演算子と文字列演算子
次の数値演算子と文字列演算子がサポートされています。
演算子 | 説明 |
---|---|
+ |
数値または文字列の連結を追加します |
- |
引き算を行う |
* |
かけ算を行う |
/ |
割り算を行う |
ブール値
サポートされる定数のブール値は次のとおりです。
定数 | 説明 |
---|---|
true |
小文字にする必要があります |
false |
小文字にする必要があります |
!false |
true と評価されます。小文字にする必要があります。 |
比較演算子
次の比較演算子が用意されています。
演算子 | 説明 |
---|---|
== |
等価 |
!= |
等しくない |
< |
次より小さい |
<= |
次の値以下 |
> |
次より大きい |
>= |
次の値以上 |
リストとマップ
session.params.myList
という名前のリストの場合:
構文 | 説明 |
---|---|
x in session.params.myList |
値 x が session.params.myList に含まれている場合に true を返します |
myList[x] |
myList のインデックス x の値を返します。 |
size(session.params.myList) |
リストのサイズを返します。 |
session.params.myMap
という名前の地図の場合:
構文 | 説明 |
---|---|
session.params.myMap == {"one": 1, "two":2} |
マップが等しい場合、true を返します |
session['params']['myMap']['one'] |
指定したキーで値を返します。 |
size(session.params.myMap) |
地図のサイズを返します。 |
データモデル
シーン条件内では、次のオブジェクトを使用できます。
構文 | 説明 |
---|---|
intent |
一致インテント パラメータのデータ |
scene |
スロットフィル データ |
session |
セッション ストレージ データ |
user |
ユーザーの保存場所のデータ |
home |
ホーム ストレージのデータ |
device |
デバイスの機能と位置情報のデータ |
canvas |
キャンバスの状態データ |
resources |
ローカライズされたプロジェクト リソース(音声、画像、文字列など)のデータ |
JSON 形式の完全なデータモデル スニペットの例を以下に示します。
{
"intent": {
"params": {
"<param_name>": {
"original": "five people",
"resolved": 5
}
}
},
"session": {
"params": {
"<session_params_key>": "<session_params_value>"
}
},
"scene": {
"slots": {
"status": "FINAL",
"params": {
"<slot_name>": "<slot_value>"
}
}
},
"user": {
"params": {
"<user_params_key>": "<user_params_value>"
},
"permissions": [
"DEVICE_PRECISE_LOCATION"
],
"accountLinkingStatus": "LINKED",
"verificationStatus": "VERIFIED",
"lastSeenTime": {
"seconds": 123,
"nanos": 456
},
"engagement": {
"pushNotificationIntents": [
"intent1",
"intent2"
]
}
},
"home": {
"params": {
"<home_params_key>": "<home_params_value>"
}
},
"canvas": {
"state": {
"<canvas_state_key>": "<canvas_state_value>"
}
},
"device": {
"capabilities": [
"SPEECH",
"RICH_RESPONSE",
"LONG_FORM_AUDIO",
"INTERACTIVE_CANVAS"
],
"currentLocation": {
"coordinates": {
"latitude": 37.422,
"longitude": -122.084
},
"postalAddress": {
"revision": 0,
"regionCode": "US",
"languageCode": "en",
"postalCode": "94043",
"sortingCode": "",
"administrativeArea": "California",
"locality": "Mountain View",
"sublocality": "",
"addressLines": ["1600 Amphitheatre Parkway"],
"recipients": [],
"organization": ""
}
}
},
"resources": {
"strings": {
"<resource_string_key>": "<resource_string_value>"
},
"images": {
"<resource_image_key>": "<resource_image_value>"
}
}
}
使用方法のリファレンス
次の構文例では、session.params
オブジェクトを操作していることを前提としています。
session.params = {
"flag": true,
"count": 10,
"name": "john smith",
"myList": [1, 2, 3],
"myMap": {"one": 1, "two":2}
}
次の条件付き演算を実行できます。
// numbers and boolean logic
session.params.count > 0 && session.params.count < 100 // AND
session.params.count == 0 || session.params.count != 5 // OR
!(session.params.count <= 0) // NOT
// booleans
!false // true constant
session.params.flag // boolean variable
session.params.flag == true // explicitly compare with true constant
// strings
session.params.name == "john smith" // double quotes supported
session.params.name == 'john smith' // single quotes supported
session.params.name.contains("john") // substring
session.params.name + "!!!" == "john smith!!!" // string concatenation
session.params.name < "abc" // compares lexicographically
size(session.params.name) == 10 // length of string
// lists
1 in session.params.myList // "contains in list" operator
session.params.myList[0] == 1 // "index into list" operator
size(session.params.myList) == 3 // returns number of elements in the list
// maps
session.params.myMap == {"one": 1, "two":2} // compare map with json
session['params']['myMap']['one'] == 1 // index using square brackets
size(session.params.myMap) == 2 // number of entries in the map