Quick play

The Quick play tab has three different sections, specifically:

  • Interaction

  • POI

  • Composition

The options above will only be shown if supported by the connected robot.

List of Interactions

This option will only be shown if the connected robot has interactions installed on it. On a James for example, this option will be hidden from the Dashboard and the tab will not be shown in the Steering-page.

The interaction widget contains options for starting simple actions on the robot. These interactions can be used to entertain guests or make the robot (seem) more human.

ListDetails

The following options are available for this list:

  1. Filter the list

  2. Sort the list

  3. Use the interaction

When executing interactions, make sure the robot has plenty of free space to move the limbs.

Filter the list

The list can be shortened by entering a search-term(1) or by applying a filter(2).

SearchBar

Entering a search-term in the field

Tap the search-field to enter a term in the field:

TapSearch

After entering a search-term, the list will be updated immediately.

To remove the search-term, tap the icon in the right of the search-field or erase the current searched term in the search-field.

TapCloseSearch
The icon will only be shown when editing the search-field.

Filter by type of interaction

This section is highly dependent on the type of robot ZBOS Control has been connected to. For this section in the manual, the example of a Zora was used.

Tap the icon FilterList next to the search-bar to show the options for the filter.

TapFilter

A modal will be shown with available options:

The available options depend on the type of robot ZBOS Control has been connected to.
FilterListOptions

The list of Interactions will be separated into different sections, based on the connected robot. Each section has the following properties:

FilterCategoryOptions

  1. Tap the first option to select or un-select all sections in the list

  2. Tap an element in the category to toggle showing the animation with the selected property.

The option 'Unselect all' will only be shown once all category-elements have been selected. Otherwise, the option 'Select all' will be shown instead.

Apply the filter

Tap the icon to apply the filter to the list.

TapFilterCheck

Sort the list of POIs

Tap on a property of the POIs (name, type, map) to sort the list by these terms in ascending or descending order.

TapSort
The sorting will be applied on top of the active search or filter.

Using an interaction

The following details will be shown for each interaction:

InteractionOptions

  1. Tap the Star-icon to (un-)mark an interaction as a favorite

  2. Tap an interaction to make the robot start playing

  3. Tap the stop-button to stop the currently playing interaction

Marking an interaction as a favorite

Tap the next to a Quick Response to (un-)mark them as favorites.

TapStar
md star shows the response is marked as favorite, whereas md star outline shows the response isn’t a favorite.

Starting an interaction

Tap an interaction to start it.

TapInteraction

Stopping an interaction

Tap the stop-button next to the active interaction to stop it.

TapStop
The stop-button will only be shown if an interaction is already in progress.

List of POIs

ZBOS Control needs to be connected to a robot before any POIs will be shown in the list.

This component of the dashboard displays the list of POIs for the current map.

FullList

The widget can be used to:

  1. Filter the list of POIs

  2. Sort the list of POIs

  3. Move to or modify a POI

  4. Add the current location as a POI

Filter the list of POIs

Only the POIs for the current map will be shown in this list.

The user can modify the display of the list by entering a search-term or filtering the list down based on the type of POI.

Entering a search-term in the field

Enter a search-term to search the list for POIs with the search-term in the name of the POI.

SearchTerm

To remove the search-term, tap the icon in the right of the search-field or erase the current searched term in the search-field.

The icon will only be shown when editing the search-field.

Filter by type of POI

When starting ZBOS Control, only the POIs of the currently loaded map are shown.

Tap the icon FilterList next to the search-bar for the POIs to show the options on which the list of POI’s can be filtered.

FilterList

In the shown modal, the list can be filtered on type of POI.

FilterListOptions

  1. Tap the first option to select or un-select all POI-types

  2. Tap a category to toggle showing this type of POI in the list

  3. Tap the icon to apply the new setting

The option 'Unselect all' will only be shown once all POI-types have been selected. Otherwise, the option 'Select all' will be shown instead.

Sort the list of POIs

SortBy

Tap on a property of the POIs (name, type, map) to sort the list by these terms in ascending or descending order.

The sorting will be applied on top of the active search or filter.

Using a POI from the list

The following details will be shown for a single POI:

POIOperations

  1. Tap the POI to move the robot to the POI

  2. Tap the Stop-button to stop the robot

  3. Tap the Edit-button to edit the settings of the POI

  4. Tap the Delete-button to remove the POI (Confirmation required)

Moving a robot to a POI

Tap the name of a POI to have to robot move to the selected location.

TapName
If obstacles are detected or if the selected POI is obstructed by virtual walls or an unmapped part, the robot will not move.

Stop the robot moving

To stop the robot moving, tap any of the -buttons in the list.

TapStop

Edit the settings of the POI

Tap the button md edit next to a POI to edit its settings.

TapEdit

A modal will be shown with the current settings for the POI:

POISettings

  1. Name of the POI

  2. Type of POI

  3. Additional settings (Interactive POI only)

Tap the button 'Update POI to the current position' (4) to save the POI in the current location on the map with the new settings.

Tap the button 'Update POI' to apply the changes to the POI in its current location.

To undo the changes, tap outside the modal or tap the icon in the top-right corner of the edit-modal.

Deleting a POI

Tap the button md trash to remove a POI.

TapDelete

This will display a modal asking to confirm deleting the POI:

ConfirmDelete

Tap the option 'Yes' to remove the POI.

Tap the option 'No' or outside the modal to keep the POI.

Add current location as a POI

Tap the button to add the current position of the robot to the map as a POI.

TapAdd

A modal asking for the details of the POI is shown:

POIAdd

  1. Enter a name for the POI

  2. Select the type of POI to set (Additional options will be shown for Interactive POI).

  3. Tap the button 'Add POI' to add the POI to the map

  • The option 'Add POI' will be disabled until a value is entered for the name.

  • Tap outside the modal or the icon in the top-right corner of the modal to close the modal without adding the POI.

List of Compositions

This component has been designed to allow the user to start compositions directly from the dashboard. Additionally, the number of times the composition can be played can be edited as well.

The following options are shown for this component:

ListDetails

  1. Filter the list of compositions

  2. Sort the list of compositions

  3. Play, edit, stop a composition or edit a composition

Only the locally stored compositions (i.e. stored in the ZBOS Control app) will be shown, not those stored on the connected robot.

Filtering the list of compositions

The list can be filtered by entering a search-term(1) or applying a filter(2) to the list.

FilterCompositions

  1. Tap the md funnel icon to apply filters to the list.

  2. Tap the search field to enter a search term.

  3. Tap the to view close the search.

Available filters

FilterOptions

  • Tap the md checkbox (1) icon next to a category to show or hide the compositions in the shown category.

  • Tap the (2) icon in the top right corner of the modal to apply the changes and close the modal.

Sort the list of compositions

The list of compositions can be sorted based on the properties:

SortCompositions

  1. Tap any of the details to sort the list by the tapped detail.
    By default, the list will be sorted by name.

  2. Tap the icon to show advanced options.

The sorting will be applied on top of the active search or filter.

Advanced options

The following options are available for the compositions shown in the list:

AdvancedOptions 1

  1. Toggle whether the compositions stored in the app ('local') or the compositions stored on the robot ('robot')(1).

  2. Show the advanced options for the execution of the compositions(2)

(1): By default, the compositions stored for the connected robot will be shown.
(2): This option is only available for the compositions stored on the robot.

Execution options

The following options for the execution of compositions are available:

AdvancedOptions 2

  1. Toggle whether the compositions should run concurrently to other options set in the Task manager.

  2. Set the priority for the execution of the compositions (Critical, Important, Low or Normal).

  3. Set what the action should do (Restart, Restart block, Stop) when the task is resumed(1)

  4. Tap the button 'Save composition settings' to sav the new values. Alternatively, tap the icon to close the modal without saving the changes.

(1): Depending on how the concurrency setting is configured, higher priority tasks are allowed to interrupt lower priority tasks. The 'Resume behaviour setting' controls how to continue once a higher priority task is finished.

Composition list

The current state of the composition is shown in the list:

CompositionDetails

  1. The name and category for the composition is shown in the list. Tap the name of the composition to play the composition.

  2. The options for the currently not running compositions can be edited.

  3. The currently playing compositions is shown with buttons to pause, resume or stop the running composition(s).

Playing a composition

Tap a composition to start playing it on the connected robot.

TapComposition
Once the composition is playing, the buttons next to the composition will change to display pause- and stop-buttons.

Pausing a composition

Tap the button 'Pause' to pause the composition:

TapPause

  • Don’t pause a composition while a video is playing. This will stop the composition.

  • If a composition is paused while the robot is moving, when resuming the composition the robot will continue to move.

  • Don’t move the robot by hand while the composition is paused. This may cause the robot to not recognize its current position properly, thereby causing the movement of James to POI’s to be incorrect.
This will change the pause-button into a play-button.

Resuming a paused composition

Tap the button 'Play' to resume the paused composition:

TapResume
In some cases, the last played block will be repeated (e.g. Multimedia or speech), depending on where the composition was paused previously.

Stopping a composition

Tap the stop-button to stop the running composition.

TapStop
This will also stop the robot from moving (if it was moving to a POI/Location on the map).

Editing the settings of the composition

Tap the button md edit next to a composition to edit the composition.

TapEdit

The following options are available for the composition:

PlaySettings

  1. Toggle the option 'Can be stopped' on to allow the end-user to stop the composition on the robot

  2. Toggle the option 'Infinite' to loop the composition endlessly

  3. Enter a specific number of times the composition should play

  4. Tap the option 'Save composition settings' to save the settings for the composition

Saving the changes will only be stored locally. To save the changes for a composition on the robot, use the Simple/Advanced composer-page.

For more information on the settings for a composition, check the documentation for composer