条件

データモデルオブジェクトの値を使用して、シーン内で条件付きロジックを実行できます。以降のセクションでは、条件の有効な構文について説明します。

論理演算子

演算子	説明
`&&`	論理 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