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"
}
}
}