Difference between revisions of "Virtual Robot Content Organizer"

From Engineered Arts Wiki
Jump to navigation Jump to search
(Robots panel: performances already on your robot or ready to sync to robot)
(Location of performances that are transferred, rather than synced)
 
(46 intermediate revisions by 3 users not shown)
Line 7: Line 7:
  
 
The Content Organizer is used to arrange [[Touchscreen|touch screen]] and [[Telepresence]] content, add button images and text labels; transfer new performances and synchronise updates to performances with your robot, even while the robot is switched off.
 
The Content Organizer is used to arrange [[Touchscreen|touch screen]] and [[Telepresence]] content, add button images and text labels; transfer new performances and synchronise updates to performances with your robot, even while the robot is switched off.
 +
 +
*NOTE: In some of the following screenshots, you'll see Edit and Delete buttons on the top menus in the Files and Robots panel. These buttons have been removed. You can edit/delete files by right-clicking and pressing edit/delete now.
  
 
==Accessing the Content Organizer==
 
==Accessing the Content Organizer==
Line 21: Line 23:
 
==Content Organizer Overview==
 
==Content Organizer Overview==
 
Virtual Robot Content Organizer is composed of 4 sections:
 
Virtual Robot Content Organizer is composed of 4 sections:
[[File:content2.jpg|thumb|none|1024px|link=|Content Organizer]]
+
[[File:content3.png|thumb|none|1024px|link=|Content Organizer]]
 
{{num|1}} Files panel: performances in your '''Virtual Robot''' account<br>
 
{{num|1}} Files panel: performances in your '''Virtual Robot''' account<br>
 
{{num|2}} Robots panel: performances already on your '''robot''' or ready to sync to your robot<br>
 
{{num|2}} Robots panel: performances already on your '''robot''' or ready to sync to your robot<br>
{{num|3}} Properties panel (hidden by default): edit the [[#Properties|Properties]] of performances and manage their appearance on the <br>
+
{{num|3}} Properties panel (hidden by default): edit the [[#Properties|Properties]] of performances and manage their appearance on [[Telepresence]]. <br>
 
{{num|4}} File transfers and log: status of transfers
 
{{num|4}} File transfers and log: status of transfers
  
  
 
===Files panel: Performances in Virtual Robot===
 
===Files panel: Performances in Virtual Robot===
[[File:content3.jpg|thumb|none|600px|link=|Files]]
+
[[File:Files_Panel.png|thumb|none|600px|link=|Files]]
  
{{num|1}} Edit: open selected performance in Virtual Robot for editing.  You can also double click a performance to edit it.<br>
+
{{num|1}} Transfer: transfers performance to the robot archive folder (rather than directly to the Touch screen or Telepresence interface).  Sync is preffered.<br>
{{num|2}} Delete: delete selected performance from Virtual Robot permanently<br>
+
{{num|2}} Bulk Edit: easily edit properties of multiple performances.<br>
{{num|3}} Transfer: transfers performance to the robot archive folder (rather than directly to the Touch screen or Telepresence interface)<br>
+
{{num|3}} New Folder: create folders to organise content.<br>
{{num|4}} Bulk Edit: easily edit properties of multiple performances<br>
+
{{num|4}} Performances are listed below, clicking on Name to sort by name.<br>
{{num|5}} Duplicate: duplicate the selected folder and its performances. Duplicates are unique copies that can be edited without affecting the originals.<br>
+
{{num|5}} Last Saved: date or time (if today) performance was last saved. Click on Last Saved to sort by Last Saved.<br>
{{num|6}} New Folder: create folders to organise content.<br>
+
{{num|6}} By right clicking on a performance, you can bring up the open and delete options.
{{num|7}} Performances are listed below, clicking on Name to sort by name<br>
 
{{num|8}} Last Saved: date or time (if today) performance was last saved. Click on Last Saved to sort by Last Saved.
 
  
 +
====Location of performances that are transferred, rather than synced====
 +
The Transfer button copies content to a user folder, which the robot can access. This folder is hidden from the interface. Access [[Remote_Connection#Remote_access_via_the_Robot_Management_System|the Robot Management System]] and navigate to the [[Tritium GUI Assets]] tab.
 +
* On the Assets tab click View >> and tick Advanced (to show hidden folders)
 +
* Navigate to the folder: user >> your user name >> to see any performances you Transferred
 +
 +
[[File:Assets on rt - hidden user folder.png|600px|thumb|none|Assets on rt - hidden user folder]]
  
 
===Robots panel: performances already on your robot or ready to sync to robot===
 
===Robots panel: performances already on your robot or ready to sync to robot===
[[File:content4.jpg|thumb|none|600px|link=|Robots]]
+
[[File:Robots_Panel.png|thumb|none|600px|link=|Robots]]
Click the arrow next to a folder to show all the subfolders containing content on the robot. <br>
+
{{num|1}} Sync: sync new or altered performances from Virtual Robot to the robot<br>
 +
{{num|2}}, {{num|3}} User's robots. Click the arrow next to a robot to show all the subfolders containing content on the robot. <br>
 
Clicking the arrow again hides the subfolders. You can also double click on the Robot to expand / hide subfolders<br>
 
Clicking the arrow again hides the subfolders. You can also double click on the Robot to expand / hide subfolders<br>
{{num|1}} Edit: open selected performance in Virtual Robot for editing.  You can also double click a performance to edit it.<br>
 
{{num|2}}  Delete: delete selected performance from robot. Performance still exists in Virtual robot until deleted from Virtual Robot.<br>
 
{{num|3}} Sync: sync new or altered performances from Virtual Robot to the robot<br>
 
{{num|4}}, {{num|5}} User's robots
 
  
 
===File Transfers and Log===
 
===File Transfers and Log===
Line 54: Line 57:
  
 
[[File:content6.jpg|thumb|none|600px|link=|Sync request pending]]
 
[[File:content6.jpg|thumb|none|600px|link=|Sync request pending]]
{{num|1}} cancel: cancel selected sync job<br>
 
 
{{num|1}} clear completed: remove completed sync jobs from the list<br>
 
{{num|1}} clear completed: remove completed sync jobs from the list<br>
 
{{num|2}} Status: pending / completed<br>
 
{{num|2}} Status: pending / completed<br>
 
{{num|3}} Last Activity: date and time sync job was added if pending, or date and time completed<br>
 
{{num|3}} Last Activity: date and time sync job was added if pending, or date and time completed<br>
 
{{num|4}} File: performance or folder being synced<br>
 
{{num|4}} File: performance or folder being synced<br>
{{num|5}} Robot: Name (or location) of robot
+
{{num|5}} Robot: Name (or location) of robot<br>
 
+
cancel: cancel selected sync job<br>
  
 
Once the robot is online it will begin to synchronise.  When the content has been transferred to the robot the Status will show as "completed".
 
Once the robot is online it will begin to synchronise.  When the content has been transferred to the robot the Status will show as "completed".
Line 72: Line 74:
 
[[File:content8.jpg|thumb|none|600px|link=|Transfer Log]]
 
[[File:content8.jpg|thumb|none|600px|link=|Transfer Log]]
  
 
+
==Syncing content to Touch Screen kiosk - LIBRARY page==
===Transferring content to Touch Screen kiosk - LIBRARY page===
 
 
Example LIBRARY page showing on the [[Touchscreen|touch screen]]:
 
Example LIBRARY page showing on the [[Touchscreen|touch screen]]:
  
Line 88: Line 89:
  
  
Let's say you want to add a new performance to the LIBRARY page.
+
===Let's say you want to add a new performance to the LIBRARY page.===
  
 
Select the performance you want to add in the [[#Files panel: Performances in Virtual Robot|Files panel]] on the left and drag it into the Library folder of the Robots panel on the right.
 
Select the performance you want to add in the [[#Files panel: Performances in Virtual Robot|Files panel]] on the left and drag it into the Library folder of the Robots panel on the right.
  
 
[[File:content10.jpg|thumb|none|600px|link=|Transfer to library]]  
 
[[File:content10.jpg|thumb|none|600px|link=|Transfer to library]]  
Drag selected performance {{num|1}} from Files panel into the Library folder {{num|3}}. A dialog box {{num|2}} indicates how many performances are being dragged
+
Drag selected performance {{num|1}} from Files panel into the Library folder {{num|3}}.<br>
 +
A dialog box {{num|2}} indicates how many performances are being dragged<br>
 
{{num|3}} Green dotted line indicates which folder performance or folder is being dragged to
 
{{num|3}} Green dotted line indicates which folder performance or folder is being dragged to
  
Add any other new performances in the same way.
+
* Add any other new performances in the same way.
 +
* Change order of performances in the Library folder by dragging performances around
 +
* Delete any performances in Library if no longer wanted.
  
Change order of performances in the Library folder by dragging performances around
+
Then '''sync''' the changes to the robot
  
Delete any performances in Library if no longer wanted.
+
'''''Don't forget to press the Sync button'''''
  
Then sync the changes to the robot
 
 
===Syncing content changes to robot===
 
===Syncing content changes to robot===
[[File:content11.jpg|thumb|none|600px|link=|Transfer Log]]
+
[[File:content11.jpg|thumb|none|600px|link=|Ready to sync - items that will be synced marked]]
 
{{num|1}} Transferred performance in library from example above<br>
 
{{num|1}} Transferred performance in library from example above<br>
{{num|2}} Sync symbol indicates items that will be synced (i.e. updated or transferred or re-ordered<br>
+
{{num|2}} Sync symbol indicates items that will be synced (i.e. updated or transferred or re-ordered)<br>
{{num|3}} Click Sync to add the sync job to the [[#File Transfers and Log|File Transfers list]]. Once the robot is online it will begin to synchronise. When the content has been transferred to the robot the Status will show as "completed".
+
{{num|3}} Click Sync to add the sync job to the [[#File Transfers and Log|File Transfers list]] and initiate the changes<br>  
 +
Once the robot is online it will begin to synchronise. When the content has been transferred to the robot the Status will show as "completed".
 +
 
  
 
[[File:content7.jpg|thumb|none|600px|link=|Sync job completed]]
 
[[File:content7.jpg|thumb|none|600px|link=|Sync job completed]]
  
==Properties==
+
 
Access the properties panel by clicking on the ">>" :
+
To see the updated content on your touch screen, change to one of the other pages on your touch screen (e.g. LIVE or LANGUAGE) then click on LIBRARY again to reload the LIBRARY page - you should now see all your changes.
 +
 
 +
====Example video====
 +
Please watch both parts. (note video hosted on external site (YouTube.))
 +
{{#ev:youtube|12dU9BvInCI|1280|left|Example content syncing with virtual robot organizer - part 1|frame}}
 +
{{#ev:youtube|mK_kPA3eiLw|1280|left|Example content syncing with virtual robot organizer - part 2|frame}}
 +
<div style="clear:both;"></div>
 +
 
 +
==Sequence properties==
 +
You can edit the properties of performances and manage their appearance on the kiosk and in Telepresence. Access the properties panel by clicking on the ">>" :
 
[[File:content12.jpg|thumb|none|1024px|link=|accessing properties]]
 
[[File:content12.jpg|thumb|none|1024px|link=|accessing properties]]
  
  
This opens the Properties panel:
+
This opens the Properties panel
 
[[File:content13.jpg|thumb|none|1024px|link=|Properties panel open]]
 
[[File:content13.jpg|thumb|none|1024px|link=|Properties panel open]]
  
  
 +
Select a sequence in Files that you wish to change the properties of.  The following properties are availabnle
 +
[[File:content14.jpg|thumb|none|600px|link=|Properties elements]]
 +
{{num|1}}  ID: unique ID number (For info - can not be altered)<br>
 +
{{num|2}}  Name: Sequence name<br>
 +
{{num|3}}  Label: Button label that appears on the Touch Screen interface<br>
 +
{{num|4}}  Description: Use to describe your content if desired (does not appear on touch screen)<br>
 +
{{num|5}}  Icon: Select an icon to use on the Button on the Touch Screen or in the Telepresence interface<br>
 +
{{num|6}}  Limit Control: Limit the sequence in [[Tritium Arbitration]] to only control certain parts of the robot (no need to change if unfamiliar with Arbitration)<br>
 +
{{num|7}}  Exclusive: If playing this sequence should stop other playing sequences in Telepresence<br>
 +
{{num|8}}  Loop: For Telepresence loops - sequences that will loop until told to stop<br>
 +
{{num|9}}  Robot Model: For info - robot model the sequence was created for (this is now called Robot Staging).<br>
  
[[File:content14.jpg|thumb|none|600px|link=|Properties elements]]
+
===Icon selection===
# ID: unique ID number (can not be altered)
+
[[File:content15.jpg|thumb|none|600px|link=|icon selection box]]
# Name:
+
Click in the empty box {{num|2}} next to Icon {{num|1}} this will open Icons window<br>
# Label:
+
Here you can select an existing icon e.g. humphrey {{num|3}}, or scroll to the bottom of the icons and click "+ Upload" to upload your own.
# Description:
 
# Icon:
 
# Limit Control:
 
# Exclusive:
 
# Loop:
 
# Robot Model: Robot model (can not be altered)
 
  
* Different icons can be slected to appear in tinman (telepresance) or on the touch screen kisok
 
  
[[File:content15.jpg|thumb|none|600px|link=|changing performance icons]]
+
The icon property will update to the selected icon:
To change icon click on the icon button
+
[[File:content16.jpg|thumb|none|600px|link=|changing performance icons]]
  
[[File:content16.jpg|thumb|none|600px|link=|icon selection box]]
 
choose suitable icon from pre-existing list
 
# click on empty bar next to 'Icon' this will open Icons list
 
# Icons list
 
# click on chosen icon
 
  
note after making any changes in properties the robot will have to be 'synced'
+
After making any changes in properties hit sync again to sync the changes to the robot.
  
(Clicking the "<<" symbol closes the properties panel)
+
Clicking the "<<" symbol closes the properties panel
  
 
==Some useful shortcuts==
 
==Some useful shortcuts==
Line 153: Line 166:
 
* click an arrow next to a folder to show / hide subfolders
 
* click an arrow next to a folder to show / hide subfolders
 
* double click on a folder to show / hide subfolders
 
* double click on a folder to show / hide subfolders
 +
 +
==Changing the order of content on touchscreen interface==
 +
virtual robot list in Library folder:
 +
<pre>
 +
Virtual Robot:    Kiosk:
 +
1                1  4  7
 +
2                2  5  8
 +
3                3  6  9
 +
4
 +
5
 +
6
 +
7
 +
8
 +
9
 +
</pre>
 +
 +
<div><ul>
 +
<li style="display: inline-block;">[[File:Virtual Robot content order.png|thumb|none|800px|link=|Virtual Robot content order]]</li>
 +
<li style="display: inline-block;">[[File:Kiosk content order.png|thumb|none|800px|link=|Kiosk content order.]]</li>
 +
</ul></div>
  
 
==Troubleshooting==
 
==Troubleshooting==
 
If you experience issues transferring content or with Virtual Robot in general please see [[Virtual Robot Troubleshooting]]
 
If you experience issues transferring content or with Virtual Robot in general please see [[Virtual Robot Troubleshooting]]

Latest revision as of 14:30, 24 August 2020

Virtual Robot > Virtual Robot Content Organizer
This page applies to 2017 onwards Tritium robots, for earlier Tritium robots please see Virtual Robot - Transferring Content, for IOServe based robots please see Virtual Robot - Transferring Content (IOServe)

The Virtual Robot Interface

Introduction

Virtual Robot provides a simple to use but powerful web based tool for content creation on Engineered Arts robots like RoboThespian and SociBot.

The Content Organizer is used to arrange touch screen and Telepresence content, add button images and text labels; transfer new performances and synchronise updates to performances with your robot, even while the robot is switched off.

  • NOTE: In some of the following screenshots, you'll see Edit and Delete buttons on the top menus in the Files and Robots panel. These buttons have been removed. You can edit/delete files by right-clicking and pressing edit/delete now.

Accessing the Content Organizer

The content organizer can be accessed from the Robot Management System:

Robot Management System

Serial number of robot - when robot is ONLINE this becomes a link. Click the link to open the robot's Tritium GUI
Status of robot - ONLINE / OFFLINE
Link to robot's content - click to open Virtual Robot Content Organizer
Tinman status - when robot has telepresence installed and is ONLINE, click here to access the Tinman Telepresence System

Content Organizer Overview

Virtual Robot Content Organizer is composed of 4 sections:

Content Organizer

Files panel: performances in your Virtual Robot account
Robots panel: performances already on your robot or ready to sync to your robot
Properties panel (hidden by default): edit the Properties of performances and manage their appearance on Telepresence.
File transfers and log: status of transfers


Files panel: Performances in Virtual Robot

Files

Transfer: transfers performance to the robot archive folder (rather than directly to the Touch screen or Telepresence interface). Sync is preffered.
Bulk Edit: easily edit properties of multiple performances.
New Folder: create folders to organise content.
Performances are listed below, clicking on Name to sort by name.
Last Saved: date or time (if today) performance was last saved. Click on Last Saved to sort by Last Saved.
By right clicking on a performance, you can bring up the open and delete options.

Location of performances that are transferred, rather than synced

The Transfer button copies content to a user folder, which the robot can access. This folder is hidden from the interface. Access the Robot Management System and navigate to the Tritium GUI Assets tab.

  • On the Assets tab click View >> and tick Advanced (to show hidden folders)
  • Navigate to the folder: user >> your user name >> to see any performances you Transferred
Assets on rt - hidden user folder

Robots panel: performances already on your robot or ready to sync to robot

Robots

Sync: sync new or altered performances from Virtual Robot to the robot
, User's robots. Click the arrow next to a robot to show all the subfolders containing content on the robot.
Clicking the arrow again hides the subfolders. You can also double click on the Robot to expand / hide subfolders

File Transfers and Log

Shows status of current sync requests. Clicking on a robot to sync content to and pressing the Sync button adds a "pending" sync job to the File Transfers list.

Sync request pending

clear completed: remove completed sync jobs from the list
Status: pending / completed
Last Activity: date and time sync job was added if pending, or date and time completed
File: performance or folder being synced
Robot: Name (or location) of robot
cancel: cancel selected sync job

Once the robot is online it will begin to synchronise. When the content has been transferred to the robot the Status will show as "completed".

Sync job completed

Status: completed transfer of performance or folder
clear completed: remove completed sync jobs from the list


Log: logs actions carried out in Virtual Robot Content Organizer

Transfer Log

Syncing content to Touch Screen kiosk - LIBRARY page

Example LIBRARY page showing on the touch screen:

Example LIBRARY page


In the Robots panel select the Robot you wish to transfer performances to.

library folder

Click the arrow next to the Robot you wish to sync content to. This shows all the subfolders containing content on the robot. (Clicking the arrow again hides the subfolders. You can also double click on the Robot to expand / hide subfolders)
Click the arrow next to 'touchscreen_ui' to show the subfolders for content in different languages on the Robot
Click the arrow next to 'en_GB' (for British English touch screen content) - if you have other languages installed they will appear here as well. This folder this contains all editable pages of the touch screen interface
Click the arrow next to 'Library' to show the Library content in the order it appears on the touch screen kiosk


Let's say you want to add a new performance to the LIBRARY page.

Select the performance you want to add in the Files panel on the left and drag it into the Library folder of the Robots panel on the right.

Transfer to library

Drag selected performance from Files panel into the Library folder .
A dialog box indicates how many performances are being dragged
Green dotted line indicates which folder performance or folder is being dragged to

  • Add any other new performances in the same way.
  • Change order of performances in the Library folder by dragging performances around
  • Delete any performances in Library if no longer wanted.

Then sync the changes to the robot

Don't forget to press the Sync button

Syncing content changes to robot

Ready to sync - items that will be synced marked

Transferred performance in library from example above
Sync symbol indicates items that will be synced (i.e. updated or transferred or re-ordered)
Click Sync to add the sync job to the File Transfers list and initiate the changes
Once the robot is online it will begin to synchronise. When the content has been transferred to the robot the Status will show as "completed".


Sync job completed


To see the updated content on your touch screen, change to one of the other pages on your touch screen (e.g. LIVE or LANGUAGE) then click on LIBRARY again to reload the LIBRARY page - you should now see all your changes.

Example video

Please watch both parts. (note video hosted on external site (YouTube.))

Example content syncing with virtual robot organizer - part 1
Example content syncing with virtual robot organizer - part 2

Sequence properties

You can edit the properties of performances and manage their appearance on the kiosk and in Telepresence. Access the properties panel by clicking on the ">>" :

accessing properties


This opens the Properties panel

Properties panel open


Select a sequence in Files that you wish to change the properties of. The following properties are availabnle

Properties elements

ID: unique ID number (For info - can not be altered)
Name: Sequence name
Label: Button label that appears on the Touch Screen interface
Description: Use to describe your content if desired (does not appear on touch screen)
Icon: Select an icon to use on the Button on the Touch Screen or in the Telepresence interface
Limit Control: Limit the sequence in Tritium Arbitration to only control certain parts of the robot (no need to change if unfamiliar with Arbitration)
Exclusive: If playing this sequence should stop other playing sequences in Telepresence
Loop: For Telepresence loops - sequences that will loop until told to stop
Robot Model: For info - robot model the sequence was created for (this is now called Robot Staging).

Icon selection

icon selection box

Click in the empty box next to Icon this will open Icons window
Here you can select an existing icon e.g. humphrey , or scroll to the bottom of the icons and click "+ Upload" to upload your own.


The icon property will update to the selected icon:

changing performance icons


After making any changes in properties hit sync again to sync the changes to the robot.

Clicking the "<<" symbol closes the properties panel

Some useful shortcuts

  • slow click folder or performance name to rename
  • double click folder to open
  • double click performance to edit
  • click an arrow next to a folder to show / hide subfolders
  • double click on a folder to show / hide subfolders

Changing the order of content on touchscreen interface

virtual robot list in Library folder:

Virtual Robot:    Kiosk:
1                 1  4  7
2                 2  5  8
3                 3  6  9
4
5
6
7
8
9
  • Virtual Robot content order
  • Kiosk content order.

Troubleshooting

If you experience issues transferring content or with Virtual Robot in general please see Virtual Robot Troubleshooting