תנאים

אפשר להפעיל לוגיקה מותנית בסצנות באמצעות ערכים אובייקטים של מודל נתונים. בקטעים הבאים מתוארים את התחביר החוקי של התנאים.

אופרטורים לוגיים

מפעיל	תיאור
&&	ווגם לוגי. ביטויים פנימיים מוערכים באופן חזרתי, אם ביטוי כלשהו מקבל את הערך False, יש קיצור דרך.
||	לוגי או לוגי. ביטויים פנימיים מוערכים באופן חזרתי, אם ביטוי כלשהו מקבל את הערך True, מוגבל בזמן
!	לוגי NOT. ההערכה של הביטוי הפנימי מתבטלת

אופרטורים מספריים ומחרוזות

האופרטורים המספריים והמחרוזות הבאים נתמכים:

מפעיל	תיאור
+	הוספת מספרים או שרשור מחרוזות
-	החסירו בין מספרים
*	הכפילו מספרים
/	חלקו מספרים

בוליאני

הערכים הבוליאניים הקבועים הבאים נתמכים:

קבוע	תיאור
true	חייב להיות באותיות קטנות.
false	חייב להיות באותיות קטנות.
!false	מתבצעת הערכה ל-true. חייב להיות באותיות קטנות.

אופרטורים להשוואה

אלו האופרטורים הבאים להשוואה:

מפעיל	תיאור
==	שווה ל-
!=	לא שווה ל-
<	פחות מ-
<=	פחות מ- או שווה ל-
>	גדול מ-
>=	גדול מ- או שווה ל-

רשימות ומפות

נתונה רשימה בשם session.params.myList:

תחביר	תיאור
x in session.params.myList	הפונקציה מחזירה true אם הערך x נמצא ב- session.params.myList
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	נתונים של פרמטר 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