Genvid Studio sample

Warning

The Genvid Studio and Composition feature is provided as a preview. The elements presented here will likely change in the future. The current vesrion is only supported in Google Chrome.

The Studio sample exposes the composition feature of the Genvid stack through a web interface. It can be used with either two instances of a game or with the Genvid Ingest sample. For this example, we use two instances of the Tutorial sample composed in different ways.

You can switch the output from one of the tutorial instancess to the other, as well as create a “picture-in-picture” composition. In “picture-in-picture” mode, either of the tutorial samples can be selected as the inputs for the background picture or the PIP window. You can specify transitions between the two, as well as the window position.

Configuration of the cluster

Start a local cluster and set up the tutorial. After confirming it’s working, stop the services and do the following:

  • If you are on a The Cloud Environment, load the images and then the configuration:

    py studio.py -c {clustername} upload-images
    py studio.py -c {clustername} load
    
  • If you are in a Local Environment, you only need to load the configuration:

    py studio.py load
    

You can now go back in Cluster UI and see that a new job and a link, both named studio, were added to jobs page. You can now start streaming by pressing the Start All button.

Once the Studio link turns blue, you can click on it to access the Studio page.

The Studio website

Warning

This version of the Studio website only works on Google Chrome. It is only available as a preview and the interface will likely change in the future.

Monitor

The top of the Composition page is the monitor screen. It displays four different areas:

  1. The top left (preview) is the current Composition settings view.
  2. The top right (program) is the current broadcast output.
  3. The bottom left is the first input.
  4. The bottom right is the second input.

We only started one tutorial instance, so there is only one input active.

Monitor Screen

Composition editing

Below the Monitor area are the controls used to modify the composition.

Composition Controls

Example - How to switch video source

Click the green arrow next to “tutorial” on the Cluster-UI jobs page to start a second tutorial instance.

Tutorial Count

We now have two active inputs.

Dual Inputs

Select Source 1 as the active input in the Source of the Video Mixer.

Select Source 1

Source 1 shows in the preview area, while Source 0 still broadcasts.

Source1 Selected

Click Cut in the Transition section of Compose to switch the streaming to Source 1.

Click Cut

Source 1 is now broadcasting.

Source1 Broadcast

Example - How to activate picture-in-picture

Select Picture-in-Picture in the Layout dropdown list of the Video Mixer.

Select Pip

Source 0 now shows in the PIP window, while Source 1 is the background image.

Pip

Click Cut in the Transition section of Compose to switch the streaming to the PIP composition.

Click Cut

The PIP composition is now broadcasting.

Pip Broadcasted

You can now experiment with the other settings.

Script reference

Studio sample script

usage: studio.py [-h] [--loglevel {DEBUG,INFO,WARNING,ERROR}] [-c CLUSTER_ID]
                 {upload-images,load,unload,env} ...

Positional Arguments

command Possible choices: upload-images, load, unload, env

Named Arguments

--loglevel

Possible choices: DEBUG, INFO, WARNING, ERROR

Set the script log level

-c, --cluster_id
 The cluster id. Default local

Sub-commands:

upload-images

Upload studiod images to the cloud

studio.py upload-images [-h] [-v VERSION]
Named Arguments
-v, --version

The version to upload

Default: “1.8.0”

load

Load the specified target definition in the cloud

studio.py load [-h]

unload

Unload the specified target definition in the cloud

studio.py unload [-h]

env

Print environment variables

studio.py env [-h]