Basic Event Setup
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.
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.
The next part describes all the steps to set up all the necessary resources and the event itself.
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.
Create a new video stream that will represent your camera view that you want show inside the event.
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).
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.
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.
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:
- 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.
- 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.
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.
- 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.
- Create a new shocase entry and select the event that was published to the media library.
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.