Bixby Developer Center

Navigation mode defines the list navigation experience for the user. You define this in a view for a given Moment and must choose between the several experiences available. Navigation mode supports using conditionals, so you can adjust the experience, depending on how many items the user can choose from or if the device is in hands-free mode. For more information on when to use the different read modes, see the Hands-Free and Multiple Devices Design Guide.

Examples

The following example follows an Input Moment example with an input-view.

input-view {
  match: Person (candidates) {
    from-output: FindPerson {
      from-input: PersonName (name)
    }
  }
  message {
    macro (PERSON_SELECTION_PROMPT)
  }
  render {
    selection-of (candidates) {
      navigation-mode {
        if ($handsFree) {
          read-one {
            with-navigation-conversation-drivers
            list-summary {
              macro (HANDS_FREE_PERSON_LIST_SUMMARY) {
                param (name) {
                  if (exists(name)) {
                    expression (name)
                  }
                }
              }
            }
            page-content {
              item-selection-question {
                macro (HANDS_FREE_PERSON_ITEM_SELECTION_QUESTION)
              }
              overflow-statement {
                macro (HANDS_FREE_PERSON_OVERFLOW_STATEMENT)
              }
              overflow-question {
                macro (HANDS_FREE_PERSON_OVERFLOW_QUESTION)
              }
              underflow-statement {
                macro (HANDS_FREE_PERSON_UNDERFLOW_STATEMENT)
              }
            }
          }
        }
      }
      where-each (candidate) {
        macro (PERSON_SUMMARY) {
          param (person) {
            expression (candidate)
          }
        }
        spoken-summary {
          template ("#{value(candidate.name)}")
        }
      }
    }
  }
}

View master on GitHub

Here is an example of a Result Moment with a result-view:

result-view {
  match {
    Movie (results)
  }
  message {
    if (size(results) == 0) {
      template ("#{event(results, 'NoResult')}")
    } else {
      template ("#{event(results, 'Result')}")
    }
  }
  render {
    if (size(results) == 1) {
      macro (MOVIE_DETAILS) {
        param (movie) {
          expression (results)
        }
      }
    }
    else-if (size(results) > 1) {
      list-of (results) {
        navigation-mode {
          if ($handsFree) {
            read-one {
              list-summary {
                template ("#{event(results, 'Result')}")
              }
              page-content {
                item-selection-question {
                  macro (HANDS_FREE_MOVIE_ITEM_SELECTION_QUESTION)
                }
                overflow-statement {
                  macro (HANDS_FREE_MOVIE_OVERFLOW_STATEMENT)
                }
                overflow-question {
                  macro (HANDS_FREE_MOVIE_OVERFLOW_QUESTION)
                }
                underflow-statement {
                  macro (HANDS_FREE_MOVIE_UNDERFLOW_STATEMENT)
                }
              }
            }
          }
        }
        highlights {
          select (pick) {
            label {
              macro (MOVIE_HIGHLIGHT_LABEL)
            }
            macro (MOVIE_HIGHLIGHT) {
              param (movie) {
                expression (pick)
              }
            }
            summary {
              macro (HANDS_FREE_MOVIE_HIGHLIGHT_SUMMARY) {
                param (movie) {
                  expression (pick)
                }
              }
            }
          }
        }
        where-each (result) {
          if ($handsFree) {
            macro (MOVIE_HIGHLIGHT) {
              param (movie) {
                expression (result)
              }
            }
          }
          else {
            macro (MOVIE_SUMMARY) {
              param (movie) {
                expression (result)
              }
            }
          }
          spoken-summary {
            macro (HANDS_FREE_MOVIE_NORMAL_SUMMARY) {
              param (movie) {
                expression (result)
              }
            }
          }
        }
      }
    }
  }
}

View master on GitHub