Paella plugin: es.upv.paella.opencast.loader

This plugin configures how events are loaded into paella player.

The configurations for this plugin are done for each tenant. So you need to modify the plugins section of the paella config file.

Control which flavors to play

An event can have many tracks, but an institution can configure which of these tracks are played and which are not.

To do it, you need to configure the streams property. The streams property is an array of rules. The first that matches is the one that will be applied.

Each element in the array have two properties:

• filter: select which devices the rule applies to.

  Valid devices: Android, Linux, MacOS, Windows, iOS, iPad, iPhone, iPodTouch

• tracks: select which tracks to import into paella.

  tracks can be selected by flavors or tags

Example:

{
    "streams": [
        {
            "filter": {
                "system": ["*"]
            },
            "tracks": {
                "flavors": ["*/*"],
                "tags": []
            }
        }
    ]
}

Multiple audio tracks

An event can have multiple audio tracks. Paella only plays one at a time, but you can configure paella to allow the user to decide which one to play. These tracks need to be m4a files.

You need to configure the audioTag property. It is an object where the key is the flavor to configure and the value is the label that will be shown in the player interface.

Example:

Your mediapackage has three audio tracks for english, spanish and german languages

{
    "audioTag": {
        "audio_en/delivery" : "en",
        "audio_es/delivery" : "es",
        "audio_de/delivery" : "de"
    }
}

Selecting which video canvas to use

You can configure which canvas to use in order to render video files. This is useful to enable 360 videos for example.

Nowadays, paella has three video canvas you can use:

• video: Default rectangular canvas (This is used by default if no other canvas defined)

• video360: 360 videos

• video360theta: 360 videos for Ricoh 360 cameras

You need to configure the videoCanvas property. It is an object where the key is the flavor to configure and the value is the canvas to use.

Example:

{
    "videoCanvas": {
        "*/delivery+360": "video360",
        "*/delivery+360Theta": "video360Theta"
    }

}

Examples

An institution wants to play only */delivery media tracks and has two audio tracks for English and Spanish languages

{
    "es.upv.paella.opencast.loader": {
        "streams": [
            {
                "filter": {
                    "system": ["*"]
                },
                "tracks": {
                    "flavors": ["*/delivery"],
                    "tags": []
                }
            }
        ],
        "audioTag": {
            "audio_en/delivery" : "en",
            "audio_es/delivery" : "es"
        },
        "videoCanvas": {
            "*/delivery+360": "video360",
            "*/delivery+360Theta": "video360Theta"
        }
    }    
}

An institution wants to play sidebyside/delivery track on Android and iOS devices, and presenter/delivery and presentation/delivery on the other devices

{
    "es.upv.paella.opencast.loader": {
        "streams": [
            {
                "filter": {
                    "system": ["Android", "iOS"]
                },
                "tracks": {
                    "flavors": ["sidebyside/delivery"],
                    "tags": []
                }
            },
            {
                "filter": {
                    "system": ["*"]
                },
                "tracks": {
                    "flavors": ["presenter/delivery", "presentation/delivery"],
                    "tags": []
                }
            }
        ],
        "audioTag": {
        },
        "videoCanvas": {
            "*/delivery+360": "video360",
            "*/delivery+360Theta": "video360Theta"
        }
    }    
}