Saving Items to a USB Drive

    Description

    For Windows PCs only

    IntuiFace enables users to save one or more images, videos, audio files and documents or snapshots of annotated images and scenes to a USB drive.

    Preparing an Experience to Use a USB Drive

    To enable the saving of items to a USB drive, add the Share via USB interface asset to your experience:

    Then open the Properties panel for this interface asset. Specify the "Destination folder" and configure other properties as needed. See below for detailed information about the various properties.

    NOTE: USB Drives are only recognized by IntuiFace if connected to your PC after the experience is run. USB drives connected to a PC before playing an experience will not be detected.

    Saving Items to a USB Drive

    To save items to a USB drive, you must first add them to the sharing queue. Every item in the sharing queue is automatically saved to a USB drive by IntuiFace. In fact, if there are multiple items in the sharing queue, it is not possible to selectively save only a subset of those items.

    There are two ways to add Image, Video, Audio and Document assets into the sharing queue:

    1. Enable the Show sharing button property in the Tools section of the More Properties panel for the asset you may want to save to a USB drive.



      By touching this button in a running experience, the asset is added to the sharing queue.



      NOTE: Annotated images and scenes are added to the sharing queue by using the Snapshot button in the Drawing Tool. After annotating your images, click the snapshot button (see image below). A copy - the snapshot - is created. Press the Sharing button on this copy.



    2. Call the "Add in sharing queue" action of the Asset. You can call this action using any In
      tuiFace trigger. A parameter of this action is specification of which sharing queue to use.


      NOTE: Use the "Remove from sharing queue" trigger to remove this particular asset from a specified sharing queue.

    Once the items you wish to save are in the sharing queue, call the Share action of the Share via USB interface asset.

    ShareUSB-Send.jpg

    More About Sharing Queues

    Each sharing interface asset - email, file system, USB drive - has its own sharing queue. However, the above methods add assets and asset snapshots to all sharing queues at the same time. To add an asset to a specific sharing queue, call that asset's Add in sharing queue action and specify which queue you are targeting.


    Sharing-AddToQueue.jpg

    If you would like to see the sharing queue as items are added/removed and even automate the Share action, add the Share via USB drive data template we've built for you by double-clicking the interface asset in the Interface Asset panel.

    ShareUSB-Panel.jpg

    This data template illustrates what is possible with the Share via USB Drive interface asset; you are not required to use its design or even to use it at all. The image on the right of the template simply illustrates placement of the sharing button.

    ShareUSB-DA.jpg

    Properties, Triggers & Actions

    Properties

    • Destination folder   name of folder in which items shared to the USB drive will be saved
    • Create destination folder   toggle whether or not the Destination folder should be created if it doesn't already exist on the USB drive
    • Overwrite existing files   toggle whether or overwrite preexisting files with the same name as newly saved items
    • Drive storage unit   determine which measurement you want IntuiFace to use to represent capacity and free space of a given USB drive. These values are available via binding as properties of the Share via USB interface asset.
    • Sharing storage unit: Unit used for size of the sharing queue

    Triggers

    Share via USB

    • Sharing failed: Raised when an attempt to share is unable to complete.
      • Message: The error message
    • Sharing has been cancelled: Raised when sharing has been cancelled.
    • Sharing has completed: Raised when sharing has completed.
    • USB drive removed during copy: Raised when the targeted USB drive is removed before an active copy process completes.
      • Message: The error message

    USB Drive

    • No USB drive detected: Raised when no USB drive is detected.
    • USB drive plugged in: Raised when an USB drive has been plugged in. Contains the following parameters:
      • USB disk usage: Percentage (between 0 and 100) of used space on the drive.
      • USB drive capacity: Drive capacity.
      • USB drive free space: Available free space on the drive.
      • USB drive name: Drive name.
    • USB drive unplugged: Raised when an USB drive has been unplugged. Contains the following parameters:
      • USB disk usage: Percentage (between 0 and 100) of used space on the drive.
      • USB drive capacity: Drive capacity.
      • USB drive free space: Available free space on the drive.
      • USB drive name: Drive name.

    Sharing queue

    • Sharing queue cleared: Raised when sharing queue selection is cleared.
    • Sharing queue item added: Raised when an item has been added to the sharing queue.
    • Sharing queue item removed: Raised when an item has been added to the sharing queue.

    Email-trigger.jpg

    Actions

    Share via USB

    • Cancel sharing: Cancel ongoing share attempt.
    • Change selected drive: Change the drive selected for sharing.
      • Name: Name of the drive to select.
    • Share: Copy all items in sharing queue to the destination folder.

    Sharing queue

    • Add item to sharing queue: Add the item referenced by the following URI to the sharing queue.
      • URI: the local path the item to add to the sharing queue.
    • Clear sharing queue: Clear the sharing queue of all items.
    • Remove item from sharing queue: Remove the item referenced by the following URI from the sharing queue.
      • URI: the local path the item to add to the sharing queue.

    Sharingqueue.jpg