Clip Ingest Service (CIS) - Cultural

Introduction

Clip Ingest Service allows the uploading of a media content to a server and makes it available in a content management service to be watched on demand.

Functionality

There will be three modes of ingesting content:

  • Upload mode. It consists on selecting a video from the local computer of the user and upload it.
  • Download mode. It consists on downloading a video from the internet from the url of the video. The downloaded video is copied to the source folder of the ingest process. Thereafter, the process is just the same than in the upload mode.
  • File-system mode. It consist on copying a video previously stored in a folder on the server where the ingest service is deployed to the source folder of the process. Thereafter, the process is just the same than in the upload and download mode.

MimeTypes supported by Clip Ingest Service are the following:

  • video/msvideo
  • video/x-msvideo
  • video/avs-video
  • video/avi
  • video/mp4a
  • video/webm
  • video/ogg
  • video/quicktime

Transcodification will be made only for those MimeTypes selected in the service invocation. A thumbnail will also be generated.

During ingest process, an UUID will be created and assigned to all files created.

After the POST request is received, the API will return an XML with an OK or KO message.

  • In case of a OK message, URL of the content generated will be displayed.
  • In case of a KO message, a brief description of the error will be displayed.

After content transcoding the server will inform of the transcoded content URLs and the metadata.

Use Cases

Clip Ingest Service Cultural was deployed at the first run for two experimental applicactions: DigitalSchladming and MediaConnect and at the second run, it was also been deployed in the context of an experiment application: iCaCoT (interactive Camera-based Coaching and Training).

API

List of functions

Uploading content

To upload content make a POST (just one request) to: http://{host_name}/{experiment_ingest_name}/uploadFile

Parameters accepted for this invocation are the following:

Name Type Description Mandatory
title string content title yes
description string content description yes
category string content categories separate by comma ”,” no
type string content type no
thumbnailsTitle string thumbnail title no
releaseDate string date format: ISO 8601 (20071103T131805 ) no
actors string content actors separated by comma ”,” no
director string content director separated by comma ”,” no
rightHolder string conditional access right holder ID no
conditionalAccess boolean conditional access true / false no
conditionalAccessProfile string name of the conditional access profile no
multiQuality boolean true / false at least one transcodification profile must be selected
html5Mp4U boolean true / false
html5WebM boolean true / false
html5OggM boolean true / false
html5Mp3audio boolean true / false
userName string user uploading the video, to be shown on Facebook event page yes
path string url where the video is downloaded from (download mode) or location of the video on the local filesystem (local filesystem mode) yes if download or local filesystem mode is selected
caption string URL of the caption file no
uploadedfile file video source file yes

Deleting content

To delete a content, make a POST to: http://{host_name}/{experiment_ingest_name}/deleteContent

The only parameter of this service is the UUID generated during ingest process

For security reasons, the IPs allowed to invoke this service must be declared in a white-list file.

Metrics generation

The Clip Ingest Service has been integrated ECC 2.0 library version. Each ingest job is reported as a new entity on the ECC and all its metrics are compiled during media content processing. There are two types of metrics, absolutes and relative to time.

Attribute Description
Files in queue Current number of files in the transcoding queue
Average time Average trans codification time *
Files VoD Total number of audiovisual content available for VoD
Processed data Average processed data per interval
Queue waiting time Queue waiting time per interval *
Transcoding errors Transcoding errors within the provided interval
Transcoded files Number of files transcoded within an interval *
Transcoded data Data read and transcoded within an interval *
Total transcoded data Accumulated data read and transcoded by a service instance
  • Metrics reset after every report.

Code Examples

AVCC upload form

Drupal 7.X module that generates an html form, which is used in the user interface to send files and metadata to the server ingest application

CIS Drupal Upload Form

AVCC item inserter

Module for Drupal 7.x which implements a REST service to allow insertion into the CMS of the content recorded by the server ingest app once it has finished processing.

CIS Drupal Inserter

User Interface

In the CMS there will be a html file with a form whose fields are those listed in the Uploading content section.

Contact & Support Information

Contact

Pablo Salinero Ruiz
Media Lab, Atos
Antonio Gómez Muriana
Media Lab, Atos

Support

See Contact.