条件

您可以使用数据模型对象中的值在场景中执行条件逻辑。以下部分介绍了有效的条件语法。

逻辑运算符

运营商 说明
&& 逻辑与。内部表达式以迭代方式求值,如果任意表达式的计算结果为 false,则计算结果为 false。
|| 逻辑 OR。内部表达式以迭代方式求值,如果任何表达式的计算结果为 true,则计算过程短路
! 逻辑 NOT。系统会否定内部表达式的求值

数字和字符串运算符

支持以下数字运算符和字符串运算符:

运营商 说明
+ 将数字或字符串串联
- 减去数字
* 乘以数字
/ 除数

布尔值

支持以下常量布尔值:

常量 说明
true 必须为小写
false 必须为小写
!false 求值为 true。必须使用小写字母。

比较运算符

提供以下比较运算符:

运营商 说明
== 等于
!= 不等于
< 小于
<= 小于等于
> 大于
>= 大于等于

列表和映射

假设有一个名为 session.params.myList 的列表:

语法 说明
x in session.params.myList 如果 x 值位于 session.params.myList 中,则返回 true
myList[x] 返回第 x 个位置处的值(共 myList 个)
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