Webcam Asset

    Description

    The Webcam Asset - available on Windows PCs and Android devices - enables IntuiFace experiences to display the live video feed coming from a single webcam. In addition, snapshots of that live feed can be taken for post-processing and sharing.

    If more than one webcam is connected to a Windows PC, IntuiFace will use whichever camera Windows considers to be the "primary" camera.

    NOTE:

    • As mentioned above, the Webcam asset is only supported in Composer, Player for Windows and Player for Tablets on Android. For example, it is not supported on the iPad.
    • If your webcam is not recognized by IntuiFace, please contact Support.

    Adding the Webcam asset into your experience.

    To add the Webcam asset into an experience you are editing with Composer, either

    • Right-click an empty part of the scene and select the right-click menu option Insert->Asset ->Webcam, OR
    • Select the Webcam asset button WebcamToolbox.png in the Asset panel on the left-hand side of Composer.

    The Webcam asset will display a live feed as long as it is selected. The selection of any other item in the scene will stop the live feed.

    Taking and Preserving a Snapshot

    Taking and preserving a snapshot of a live webcam feed is a three step process.

    1. Selecting a sharing queue
      Add the interface asset corresponding to how you (optionally) intend to share one or more snapshots. These interface assets possess what is called a "sharing queue" and it is into this queue that all snapshots will be placed. See the corresponding article for more information about the sharing queue.
    2. Taking the snapshot
      One of the actions available for the Webcam asset is Take snapshot. Call this action whenever you want to capture a still image from the live webcam feed.

    Webcam-take-snpashot.jpg

    1. Adding each snapshot into the sharing queue
      At the space level, use the Snapshot is taken trigger to call the Add item to sharing queue action for the sharing interface asset you selected in Step One above.

    Snapshot-taken-action.jpg


    The value of the URI parameter for the Add item to sharing queue action is located in the URI parameter of the Snapshot is taken trigger. Use binding to store the trigger's URI parameter value in the corresponding action parameter.

    Snapshot_URI.jpg

    The interface asset you selected in Step One will store an unlimited number of snapshots, assigning each a unique URI that can be referenced, through binding, in the Image property of the Image asset.

    You can download the "Self-service Photobooth" Sample experience in the Marketplace to see this use case in action!

    Photobooth-sample.jpg

    Properties, Triggers & Actions

    Properties

    See our list of common properties for details about properties shared by all asset types.

    Webcam

    • Camera: Specifies the camera to be used by the experience. The dropdown menu lists the following choices:
      • Default: The camera considered 'default' by the device.
      • A list of all installed webcams, displayed with their name
      • An additional list:
        • Front: On Windows PCs, this is the camera facing the keyboard.
        • Android - Webcam User: Front-facing camera for Android devices. For example, can be used for selfies.
        • Android - Webcam Environment: Back-facing camera for Android devices.
      • You also have the ability to directly specify the name of a Webcam.
    • Mirror image: If selected, the live feed will appear as a mirror image of the item being displayed.
    • Delay: The time - in tenths of a second - between live action and when that action is displayed in the Webcam asset. Increasing the delay will improve image quality.
    • Video resolution: Indicates the resolution of the video feed. You have multiple options:
      • 320 x 240
      • 640 x 480
        • Recommended because many cameras mistakenly permit higher resolutions than they can handle. Excessive resolution could 1) cause poor image quality because the image sensor can't scale, or 2) slow performance because the camera can't transmit the video feed at a high enough bit rate. 640x480 is universally supported across all webcams.
      • 1280x720 (HD)
      • 1600x1200 (UXGA)
      • 1920x1080 (Full HD)
      • Set by camera
        • Maximum resolution available with the selected camera. Be careful about using this option. See point above about 640x480. In addition, we've found that sometimes this default setting is undefined and thus the resulting resolution is unpredictable.

    TransparentPixel.png

    Triggers

    See Triggers Overview and Actions Overview to get details of common triggers and actions shared by all assets

    • Starts capture: Raised when video begins to stream from the webcam.
    • Stops capture: Raised when video stops streaming from the webcam.


    Triggers-Webcam.jpg

    Actions

    • Start capture: Display video stream from the webcam.
    • Stop capture: Stop displaying video stream from the webcam.


    Actions-Webcal.jpg