The Webcam Asset - available on Windows PCs, Android and ChromeOS devices - enables Intuiface experiences to display the live video feed coming from a single webcam. In addition, snapshots (Windows only) 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.
- As mentioned above, the Webcam asset is only supported in Composer and Player on Windows, Android, and ChromeOS. For example, it is not supported on the iPad.
- On Windows, Intuiface only supports cameras which are DirectShow compatible: the camera must be recognized by Windows as a Webcam, which means as a DirectShow source, thus visible in other software such as Skype, VLC, etc. If these tools don't recognize the camera as a video source, Intuiface will not either.
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 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 of a live webcam feed is a three step process.
- 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.
- 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.
- 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.
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.
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!
See our list of common properties for details about properties shared by all asset types.
- 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.
- Starts capture: Raised when video begins to stream from the webcam.
- Stops capture: Raised when video stops streaming from the webcam.
- Start capture: Display video stream from the webcam.
- Stop capture: Stop displaying video stream from the webcam.