Getting Started

Basic Event Setup

10min

To test the NativeWaves EXP system end-to-end, a new event needs to be created in the NativeWaves Console. After the event has been created and configured, we publish it and make it accessible in the NativeWaves Showcase App.

Resource Descriptions

For the full setup, we need to create the event itself and multiple resources connected to it. Here is a brief explanation of what these resources are:

Workspace: Workspaces are utilized to group content for a specific production. For instance, a workspace can store all 300 events of a football season along with their associated content.

It is important to note that the content is stored in the workspace. So if a workspace is deleted, all events and content in that workspace will also be deleted, even though they were published to a media library (see below). Be careful when deleting workspaces.

Video Stream: A video stream is a basic content resource that can hold multiple video objects, that store the actual video data.

AVC Task: AVC Task stands for Audio/Video Coding Task which provides a simple interface for setting up and executing transcoding workflows on dedicated encoder hardware or in the cloud.

Event including configuration details (see detailed EXP event flow in the Overview section):

  • Video Track: A video track is part of the event configuration and not a standalone resource. It can store multiple video objects but can also link to a Video Stream resource to automatically ingest video objects.
  • Entity: An entity is part of the event configuration and not a standalone resource. It functions as content abstraction layer to describe various use cases, e.g. in motorsport a driver would be an entity, and you can link multiple video tracks to it, e.g. for front cam, back cam and 360° cam. For this basic event setup our entity will just represent one video stream that the user can select in the app.

Media Library: The Media Library serves as a central point for managing your media assets. It does not store the content itself (this is done in the workspace), but creates a large search index for all assets. Compared to the workspace, you typically have only one or a few of these, as they serve as the entry point for all the media content you want to expose to end consumers / frontend applications.

Showcase Collection: A Showcase Collection groups multiple NativeWaves EXP-enabled experiences together and points to a media library. After we publish the event to the media library, we can also create a showcase entry for that event in the collection.

Setup Process

The next part describes all the steps to set up all the necessary resources and the event itself.

1.) Create a Workspace

If you don't already have a workspace set up in your environment that you want to work in, create a new one in the console.

Workspaces Management Page
Workspaces Management Page


2.) Create a new Video Stream in the Workspace

Create a new video stream that will represent your camera view that you want show inside the event.

VideoStreams Management In Workspace
VideoStreams Management In Workspace


3.) Create a new AVC Task in the Workspace

Create a new AVC Task inside the workspace, that defines a video input source and outputs to the created video stream Id in a supported video format like HLS (HTTP Live Streaming).

4.) Create a new Event in the Workspace

Event Management In Workspace
Event Management In Workspace


4.1.) Add a New Video Track to the Event With the Video Stream as the Source

An event can consist of multiple video and audio tracks. Each of these tracks can represent a content feed. When you add a new track, it does not automatically appear in the end-user application. It must also be associated with an entity, which is explained in the next section.

4.2.) Create a New Entity and Link the Video Track

Entity represent a selection the user can make in the frontend application to access specific content. It functions as content abstraction layer to realize more complex content scenarios. In our scenario, we only have one entity and one video track.

5.) Create a Media Library and Publish the Event

To make your event accessible, we need to publish the event to a media library so that we later can add it to a showcase collection:

  1. Set up a new media library: Start by creating a new media library where you can publish your event. The media library serves as a centralized point for managing your media assets.
  2. Publish your event as an entry in the media library: Once the media library is set up, publish your event by creating an entry for it within the library.
Publish Event To Media Library
Publish Event To Media Library


6.) Create a Showcase Collection

After the event is published in the media library, proceed to create a new showcase collection. This collection will serve as a container for organizing and presenting your event in the NativeWaves Showcase App.

  1. When creating a new showcase collection, a media library needs to specified that links the related content. Select the media library that was created before.
  2. Create a new shocase entry and select the event that was published to the media library.

Next Step

Once you have completed these steps, your event is now part of a showcase collection and can be accessed in the Showcase app. Since the NativeWaves Showcase app has its own content security layer, we also need to create an access share link so you can open it in the app. This process is explained here: NativeWaves Showcase App.