Esta página estaba en el wiki de oriolrius.cat (2009–2012). La recupero aquí tal como era.
Se trata de un player que se alimenta de clutterscripts para mostrar escenarios, la lista de reproducción se recibe via DBUS y se puede interactuar con el player a través de esta interface.
Recursos
Referencias de proyectos relacionados
Cookbook (petit manual d'ús)
./player.py --help
./client.py --help
Y abusando un poco de líneas, me explayo un poco más. El player es el player.py. Se puede lanzar sin argumentos, en cuyo caso arranca y se queda parado, o se le pueden pasar páginas como argumentos, p. ej:
./player.py page1.json page2.json page3.json [...]
En este caso es como si hiciéramos 3 'load', 1 por cada página, y un 'next', es decir, cargamos las páginas y lanzamos la primera.
La GUI también tiene algunos comandos:
- 'q' para salir
- 'n' lanza comando 'next'
- 's' lanza comando 'stop'
- espacio para 'start' y 'pause'
Además el client.py permite gestionar la interfaz dbus del player. Tiene todos los comandos, funciona de una de las siguientes formas:
./client.py -c start
./client.py -c stop
./client.py -c pause
./client.py -c load page.json
./client.py -c next
./client.py -c clear
Metainformación
A continuación se define los elementos de los que se compone un canal de digital signage, al fin y al cabo el contenido que tiene que reproducir un player.
"Los Canales están formados por Páginas que a su vez permiten dividir el área util de la pantalla en Zonas. Cada una de las Zonas debe tener al menos una Cesta asociada."
Canal -> Páginas -> Zonas -> Cestas -> Media
Descripciones:
- Canal:
- Cestas: también se pueden entender como playlists
ClutterScript
Un ClutterScript podría ser una página del canal, entonces un canal estaría formado por varios ClutterScript que representan cada uno de ellos una página del canal.
Como nuestro sistema es la versión inicial, sólo soportamos páginas con una zona o dos zonas. En la siguiente captura de pantalla de MCP se pueden ver varias plantillas nosotros inicialmente sólo soportaremos la plantilla 1 (la seleccionada) y la 4 (zona de video con un pie que es la zona del ticker)

Dentro de una zona (da igual si es la zona grande o la pequeña/ticket) podemos tener asignada una cesta (playlist) esta playlist contendrá una lista de medias a mostrar: video, imágen o ticker de texto.
Por lo tanto nuestro clutterscript q define una página tendrá un aspecto similar a:
{
"My Scene" : {
"id" : "pagina1",
"type" : "ClutterStage",
"title" : "ClutterScript test",
"color" : "white",
"children" : [
{
"id" : "zona1",
"type" : "Zona",
"x" : 0, "y" : 0, "width" : 1024, "height" : 768
"children" : [
{
"id": "cesta1",
"type": "playlist",
"repeticiones":"0", (0:ninguna,-1:loop,n: num de veces)
"children" : [
{
"id": "item1",
"type":"video",
"file":"/path/filname.avi",
"sound_volumen":"0",
"scale":"yes"
}
]
"children" : [
{
"id": "item2",
"type":"image",
"file":"/path/filname.png",
"time":"0",
"scale":"yes"
}
]
}
]
}
]
}
}
Como funciona un player
Tiene una cola FIFO de stages/páginas que va reproduciendo de forma secuencial. A su vez cada una de las páginas tiene los elementos comentados anteriormente sobre los que no se puede interactuar más allá de poner en play/pause/stop.
Cuando la línia de tiempo de una página/stage se agota se carga la siguiente página y se muestra. Haciendo POP de la cola FIFO. Así pues un elemento de la cola FIFO que se esta reproduciendo ya no esta en la cola.
Si una página esta en LOOP infinto esta página se saca de la FIFO y no permite que nunca pase al siguiente elemento de la cola, hasta que algún elemento externo le mande un 'next'. Esto fuerza que se cargue el siguiente elemento sinó el por si mismo nunca saldrá del bucle.
Cuando se hace un 'load' lo que se hace es añadir un elemento en la cola FIFO que cuando sea oportuno será reproducido.
Un 'clear' lo único que hará es vaciar la cola FIFO no afecta al elemento en play.
Player-Clutter: Roadmap
version 0.1 ~finales de enero
Playlist basada en ClutterScripts. Plazo estimado: 4 y 11 diciembre para los 2 primeros puntosHechoEn primer lugar, necesitamos acabar de definir cual es la estructura de una playlist. ¿Sera la misma que en, p. ej. Signtech?. Esta estructura era:HechoSecuencia de videos y/o imagenes. En el caso de las imagenes, se indicaba un campo de duracion de exposicion de la imagen.HechoPosibilidad de ticker. Independiente de la secuencia anterior, simplemente contiene un texto que se va desplazando de izquierda a derecha durante todo el tiempo.HechoDudas: Con respecto al ticker, me surgen 2 dudas. En primer lugar, el ticker tipo signtech no tenía control de tiempo ni número de repeticiones, ya que actuaba como esclavo. El ticker actualmente está implementado así. Sin embargo, entiendo que esto no debería ser así, sino que debería marcarse un tiempo de duración o número de repeticiones, ¿no? ¿Cuál sería la forma preferida? Por otro lado, actualmente la duración de una pasada del texto en el ticker es constante (y hardcodeada). Esto quiere decir que si el texto es más grande pasará más lento y si hay más texto pasará más rápido... ¿esto debería ser configuble? ¿en base a un tiempo constante o una velocidad constante?RESPUESTA: el comportamiento del ticker debe ser:se muestra el ticker a una velocidad de X pixels/segundo (parámetro definido en JSON)Hechopuede estar o no definido un tiempo máximo en que este ticker se debe mostrar, por ejemplo, si pongo 1min se mostrará el ticker en loop durante 1minuto y después dejará de mostrarseHecholoops=X, si X=n se muestra n veces para n>0, X=0 se muestra infinitas vecesHechosi toda la lógica se complica mucho, implementa sólo lo de la velocidad y algo es algo... lo normal es que un ticker sea esclavo omo pasaba en signtech, el resto de funciones son por si la zona del ticker fuera la master como habrás imaginado.Finalmente he implementado la lógica completa.
Con la estructura de la playlist definida, hay que pensar como mapearla en el json. Lo que si esta claro es que en el json, tendremos directamente 3 objetos: Video, Image y Ticker a los que podremos mapear las propiedades, lo que aun no tengo claro pero no creo que sea problematico es la forma de definir una secuencia. @oriol: no se si tu le has dado una vuelta a esto, si no, tranqui, simplemente es que no me ha dado tiempo.Hecho a falta de las propiedades a añadir según el punto anterior en caso de necesidad. complete.json es un ejemplo de página.Una vez que esta el punto anterior resuelto, basta con hacer, si es necesario, algo de pegamento para implementar las secuencias, mostrar el escenario con los diferentes elementos, etc. Sin embargo, este punto se realizaria una vez tengamos las 3 clases funcionando (al menos prototipadas). Plazo estimado: 1 de enero para montarlo, 8 de enero para probar y acabar de cuadrar todo el punto 1 y todo el punto 2.Hecho
- Tipos de actores soportados. Cada tipo de elemento tendra sus propia clase, cada uno con las propiedades especificas que necesitemos: Plazo estimado: 19 y 26 diciembre para este punto
- Video, via gst. Heredara de ClutterGstVideoTexture. Hecho, aunque hay un problema con el escalado. Actualmente se escala automáticamente al tamaño de la pantalla, ya que no he encontrado forma de obtener el ancho/alto del video hasta que está ejecutándose. Me surge la duda también de si al escalar se ha de mantener el ratio ancho/alto constante o no.
- RESPUESTA: dejalo así aunque se deberá soportar: escalado manteniendo ratios x,y
Image. Heredara de ClutterTexture y tendra una propiedad duracion (si no se establece mediante un timeline)Hecho, aunque la duda del ratio ancho/alto también se mantiene aquí.Ticker. Tendrá el texto a mostrar y, a futuro, podrá ampliar sus características (tamaño de texto, tipografía, color, etc.)Hecho a falta de determinar la velocidad, ya comentado más arriba.
- Video, via gst. Heredara de ClutterGstVideoTexture. Hecho, aunque hay un problema con el escalado. Actualmente se escala automáticamente al tamaño de la pantalla, ya que no he encontrado forma de obtener el ancho/alto del video hasta que está ejecutándose. Me surge la duda también de si al escalar se ha de mantener el ratio ancho/alto constante o no.
- Interfaz dbus. Una vez tengamos los actores y las playlist soportadas, habrá que crear esta interfaz. A continuación intento definir un poco mas y lanzo alguna idea de como hacerlo: Plazo estimado: 15 y 22 de enero para implementarlo, 29 de enero para probarlo, y resolver problemas
play, pause, stop: estos 3 métodos permitirán arrancar, pausar y parar el player. En realidad, actuaran directamente sobre el stage, y automágicamente funcionara para todos los actores (si no acaba de funcionar de serie, habrá que hacer el pegamento para que funcione como comento, pero es posible que sea automágico, según la docu de clutter).Hechonext in pl: finalizara el 'timeline' de la imagen o video actual y pasara al siguientedescarga stage actual y pasa al siguienteHecho
clear pl: hay que definir el comportamiento: ¿pararia el player? o seguiria hasta el final de la pl pero no volveria a empezar? ¿es decir, destruiria todo el stage?borra todos los stage q tenemos en caché y nada más, si el user quería un pause/stop q lo hubiera lanzadoHecho
load pl: se le podra pasar un json como parametro entiendo... en este caso... seria como un 'reseteo' del player? o seguiria con el pl actual hasta su finalizacion y posteriormente cargaria la nueva?sería parecido a un append stage a mi lista de stages, me sigues?Hecho
He creado la interfaz dbus y un cliente: client.py que permite lanzar comandos vía dbus al playerHecho
- Fullscreen
- Integrar en moblin Plazo estimado: el punto anterior y este, podriamos poner 1 semana, el 5 de febrero, para intentar cuadrar todo, no se muy bien la integracion como de problematica sera... lo ideal seria ir probando mientras se va desarrollando. Si me pasas una imagen de virtualbox o similar (o un enlace o alguna indicacion) lo voy montando y asi evitamos sorpresas al final
Cuestiones de diseño a resolver:
- fullscreen: parece que el funcionamiento a pantalla completa es muy dependiente de la tarjeta grafica y el driver. Tambien depende del gestor de ventanas. No he conseguido poner los snippets a fullscreen con mi tarjeta/drivers/gestor. He creado un snippet en C para comprobar que no fuera un problema en los bindings de python (tambien he probado con el programa que supuestamente funcionaba) y tampoco ha sido posible. Si he visto que hay bastante gente con este problema, y que en funcion del orden de la inicializacion del stage principal el comportamiento puede diferir, por lo que creo saber como poder poner una aplicacion en fullscreen (si consiguiera que el fullscreen me funcionara)
- interfaz dbus: no he detectado ningun problema particular para hacer el interfaz dbus.
- tipos de actores soportados: he probado principalmente con video (via gstreamer) y no veo que vaya a haber mayor problema. Las imagenes estan soportadas sin problemas y el ticker no supone ningun problema con una animacion.
- playlist basada en clutterscript: para este apartado he estado considerando como se podria realizar. Mi intencion inicial era heredar nuestros elementos (video y ticker) de un Stage o Actor de Clutter y llamarlos directamente (he creado el snippet complete.py con basic.json para ir en esta linea). Pensaba que ClutterScript seria capaz de interpretar todos los objetos de la jerarquia Clutter, pero no es asi, su conocimiento parece limitarse a los objetos definidos en la libreria. De ser asi habria que comprobar el funcionamiento de las funciones que se pueden llamar desde clutterscript (con el elemento type-func) para crear dichos objetos. Después de la conversacion del viernes, me puse a investigar como implementar el parser, y como hacer que llamara a nuestros objetos. Investigando esta cuestion estuve repasando el sistema de objetos de glib, gobject, y leyendo la docu vi lo que estaba fallando: para que ClutterScript pudiera cargar nuestros objetos que siguen la jerarquia ClutterActor, lo que faltaba era registrar estas clases como tipos de gobject. Una vez resuelto esto, consegui cargar nuestras clases con ClutterScript. Una vez resuelta esta cuestion, me surgieron dos nuevas cuestiones:
- Como conseguir que nuestro objeto video fuera un objeto dentro de la jerarquia de ClutterActor, ya que en todos los snippets que tenemos, los 'players' hacen uso de una textura, pero no son objetos de tipo textura. Para comprender esto bien si que tuve que recurrir a la documentacion de gstreamer, ya que el funcionamiento de un player gstreamer tiene una organizacion un tanto compleja, que es dificil comprender sin conocer la arquiterctura de gstreamer. Una vez comprendido el funcionamiento, tengo ya una clase Video que hereda directamente de ClutterGstVideoTexture, con lo que estamos dentro de la jerarquia de objetos de Clutter. Este punto, junto con el anterior, estan resueltos en el commit 73
- Como 'adecuar' los playlists tradicionales (si no recuerdo mal, se podian definir una serie de videos e imagenes que se iban mostrando de forma ordenada, y ademas la posibilidad de un ticker, independiente de la secuencia de videos imagenes, al menos asi era en signtech, no recuerdo si era igual con el otro fabricante). Creo que esto no sera problema para resolverlo, pero en el roadmap lo pongo en primer lugar. Si que habria que definir el formato de playlist que deberiamos soportar.
version 0.2
- plug-ins
- escenarios complejos: múltiples zonas, múltiples medidas, comprobar comportamiento de zonas master.
- actors
- webkit
- flash (from webkit?)
version 0.3
- plug-ins
- capturan signals de las pantallas
- conectan playlists
- interactividad
- etc
- widgets = clutterscripts + plug-ins
Player-Clutter: Milestones
- Hasta el dia 27 de noviembre, formación:
- Mirar y analizar solución a grandes rasgos de como se programará el player.
- Código hecho hasta ahora en: http://svn.oriolrius.cat/websvn/listing.php?repname=svn.oriolrius.cat&path=%2Fplayer-clutter%2F&rev=0&sc=0
- valorar las fechas en que estará hecho el código
Joc de proves
Proves que s'haurien de fer al player per saber si ja és prou estable com per fer la release:
Playlist
Les basquest/playlists són susceptibles a consumir tota la memòria de la màquina si son massa grans. Així doncs, es proposa generar playlists de fins a 1.000 items combinant videos i imatges per veure quin és el comportament.
De moment cal validar això amb un stage amb una única zona.
Stage
- Crear un stage amb diverses zones (2,3,4 i 5) amb playlists slave i una de master que pot anar rotant, comprovar que el comportament és el correcte.
- Provar amb un stage de dues zones (master i ticker) de posar a la zona master una playlist gegant i comprovar que el sistema es manté estable mentre el ticker va donant voltes de forma infinita.