您可以使用資料模型物件中的值,在場景中執行條件邏輯。以下各節說明條件的有效語法。
邏輯運算子
業者 | 說明 |
---|---|
&& |
邏輯 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