Guides

    Live Video Clipping

    ##Introduction

    The live video clipping feature in Nomad Media is the implementation of video clipping for Nomad Media Live Channels. The general design is a Live Channel outputs a VOD (video on demand) HLS output at the same time as its LIVE HLS output. At the start of the live channel, a place holder Asset is generated in Nomad Media that points to the highest quality rendition of the VOD HLS output and the asset reference is stored in the Live Channel along with the output’s audio tracks metadata and video bitrate. When video clipping is performed in the UI on the video player, the Live Channel’s “clip” API endpoint is called (see below) then the clipping request model is received and merged with the Live Channel’s stored metadata information. The latest VOD HLS rendition playlist manifest file is loaded/modified/saved whilst changing the “EXT-X-PLAYLIST-TYPE” entry from “EVENT” to “VOD” (this allows clipping-engine to ingest the playlist manifest as an input) and this with the merged clip model becomes the final input into the creation of the clipping job for Asset Services which performs the final [live] video clipping.

    For this feature to be enabled, in the Live Channel, the IsLiveClipping property must be set to “TRUE.”

    API

    POST {server-url}/api/livechannel/clip
    {"startTimeCode":"00:00:08;02","endTimeCode":"00:00:38;17","title":"kene","outputFolderId":"e57b879c-eefa-414d-b56a-285ac10f4b87"}

    Configuration

    This implementation references the following configuration entries from the following configuration sections.

    1. MediaProcessingArnsSettings section:
      a. Set “MediaLiveVodDestinationIdTemplateSecured” entry – This is the secured S3 URL location for VOD HLS output destination root.
      b. Set “MediaLiveVodDestinationIdTemplate” entry – This is the S3 URL location for VOD HLS output destination root.