Detect and visualize hands from a video
An example on how to get video feed, detect and visualize hands in a 2D canvas.
Last updated
An example on how to get video feed, detect and visualize hands in a 2D canvas.
Last updated
This example demonstrates how to load and display a video in a Unity scene with a and an , implement hand tracking with the , and use the to render detected fingers on a 2D canvas.
Open the Unity Project you created in the section.
Right-click on the Assets
folder and select Create > Scene
.
Type the scene's name. In this example, we'll use the name VideoDemo
.
After the scene is created, right-click on the scene and select GameObject > UI > Canvas
.
Navigate to the LightBuzz Prefabs
folder at Assets\LightBuzz Hand Tracking\Runtime\Prefabs
.
Then, right-click on the Hierarchy
pane and select Create Empty
.
Give a name to the new component. In this example, we'll use the name Demo
.
Then, go to the Inspector
pane and select Add Component
. In the search bar, type new
and select the New script
option.
Type the script's name and select Create and Add
. For this example, we'll use the name VideoDemo
.
Double-click on the newly created MonoBehaviour
script and import the necessary namespaces.
Add a Texture2D
object to load the video frames.
After adding the serialized fields, go to the Unity Editor to connect these fields with the Demo
component.
At the Inspector
pane, select the round button next to each SerializeField
.
Then, at the Scene
tab, select the corresponding prefab. For example, for the Image
field, select the ImageView
prefab.
When all fields are connected, the result should resemble the following image.
Then, select the HandManager
prefab, under the Canvas
, and connect the Image
field to the ImageView
prefab.
Then, select the VideoSource
prefab, under the Canvas,
and connect the Video Clip
field to a video source. You can either use the demo video lightbuzz-hand-tracking.mp4
included in the Assets/LightBuzz Hand Tracking/Runtime/Media
or create your own video source.
After connecting all the fields, navigate to the Canvas
to set the render options.
Change the Render Mode
to Screen Space - Camera
.
Then, set the Main Camera,
from the Scene tab, as the Render Camera
.
When all the render options are set, the result should look like the following image.
Enable the frameReady
events. Any registered delegates with VideoPlayer.frameReady
will be invoked when a frame is ready to be drawn.
Register for the VideoPlayer.prepareCompleted
event with the VideoPrepared
event handler method.
Register for the VideoPlayer.frameReady
event with the VideoFrameReady
event handler method.
Initiate playback engine preparation. After this is done, video frames can be received immediately.
Create the Texture2D
according to the VideoPlayer
resolution.
Start playback.
Create a RenderTexture
with the VideoPlayer
frame data.
Unsubscribe the VideoPrepared
event handler method from the VideoPlayer.prepareCompleted
event.
Unsubscribe the VideoFrameReady
event handler method from the VideoPlayer.frameReady
event.
Destroy the Texture2D
object created in Step 2.
Here is the full example code that has the same functionality as the Hand Tracking Unity plugin LightBuzz_Hand_Tracking_Video
sample.
By following these steps, you will be able to load the video feed into your application, detect hands, and finally, render these detections on a 2D canvas.
For this example, drag and drop the , and prefabs into the Canvas.
For this example, we'll need a VideoPlayer
to get the video frames, an to draw image texture and a to visualize the detected hands.
Finally, return to the script and instantiate a to detect hands.
Load the texture onto the to show the video feed.
Pass the texture
to the for processing.
The will analyze the texture and detect any hands present in the image.
Pass the detections to the . The will manage the rendering and updates required to depict the detected hands.
Dispose of the object to ensure that all associated resources are released.