| |
|
|
 |
mkStickyPlayer :: Documentación
|
 |
|
Primero, un ejemplo típico que te va a permitir conocer la idea del programa. Inventemos una radio ficticia, Manatí FM del país Cremona, cuyo stream es mms://manatifm.com/radio. Los pasos a seguir son los siguientes:
En el tab Formatos:
- Click en Nuevo.
- En Nombre del formato poné Windows Media Audio.
- En Programa para reproducirlo poné la ruta hasta el Windows Media Player, por ejemplo: c:\Program Files\Windows Media Player\wmplayer.exe.
- Click en Agregar.
En el tab Ubicaciones:
- Click en Nuevo.
- En Nombre de la ubicación: Cremona.
- Click en Agregar.
En el tab Streams:
- Click en Nuevo.
- En Nombre: Manatí FM.
- En Ubicación seleccioná Cremona.
- En URL: mms://manatifm.com/radio.
- En Formato elegí Windows Media Audio.
- Click en Agregar.
Finalmente, seleccioná el Stream en la lista y apretá Play! Eso es lo básico. Ahora, vamos a ver en detalle todas las funciones del programa.
|
|
|
 |
Configuración
|
 |
|

Sticky Mode
- Activar Sticky Mode
Activa las funciones de monitoreo de señal (audio) en el programa. Esto sirve para que el programa reinicie el stream en el caso de que la señal se haya perdido por el motivo que fuere.
Opciones de monitoreo
El monitoreo permite detectar si un stream está funcionando. Si no, el programa reinicia el reproductor hasta que el stream vuelva.
- Segundos para esperar que el reproductor cargue
Si estás usando un reproductor externo, aquí definís los segundos que se debe esperar hasta que cargue. Si luego de ese tiempo el reproductor no cargó, se intenta cargarlo nuevamente.
- Segundos para esperar la primera señal
Cuántos segundos se debe esperar desde que el reproductor cargó hasta que se empiece a reproducir el audio del stream.
- Segundos sin señal que indican su pérdida
Cuántos segundos de silencio contínuo indican que la señal ha sido perdida, luego de lo cual el stream es detenido y vuelto a iniciar.
- Nivel de detección de señal
Cuando estás reproduciendo un stream, en el sector inferior del programa vas a ver el indicador del nivel de señal. Los valores van a ir de 0 a varios miles. Esta opción permite definir qué nivel de audio es interpretado como una señal del stream. Normalmente, entre 100 y 500 es una buena opción. No lo pongas demasiado bajo porque las placas de audio siempre están reproduciendo algo de ruido, el cual no debe ser interpretado como verdadero audio.
- Valores originales
Resetea los 4 valores a los recomendados.
- Valores guardados
Descarta las últimas modificaciones y vuelve a cargar los valores que guardaste.
- Guardar
Guarda en la configuración del programa estos 4 valores. Si no apretás este botón, los valores van a resetearse cuando cierres el programa.
Comando previo
Se trata de un comando (exe, cmd, etc.) que se puede ejecutar antes de empezar la reproducción. Especialmente útil para modificar los valores del mixer de la placa de audio para que pueda detectar el audio de los streams.
- Activar
Simplemente, activa o desactiva el uso del comando previo.
- Activar... Al iniciar el primer Stream
Sólo ejecutar el comando previo cuando se inicia el primer stream en la sesión actual de mkStickyPlayer. Es decir, la primera vez que apretás Play y nunca más.
- Activar... Al iniciar cada Stream
Ejecutar el comando previo cada vez que presionás Play.
- Activar... Al iniciar y reiniciar cada Stream
Ejecutar el comando previo cada vez que presionás Play y cada vez que el stream debe ser reiniciado por pérdida de señal.
- ...
Buscar el archivo del comando previo a ejecutar.
- Borrar
Borra el comando previo actualmente seleccionado.
- Timeout
¿Cuántos segundos se debe esperar hasta que el comando previo termine de ejecutarse? Si este tiempo es superado, el comando previo es cancelado.
- Ejecutar
Permite probar el comando previo ingresado en ese mismo momento.
Dispositivo de grabación
El corazón del funcionamiento de mkStickyPlayer es la detección del nivel de audio de un stream. En esta opción podés seleccionar el dispositivo de grabación que hay que utilizar para medir el nivel de audio. Normalmente, Primary Sound Capture Driver es la opción correcta.
Reproductor interno
Por el momento, lo único que se puede configurar del reproductor interno es el volumen, lo cual podés hacer con el slider.
Minimizar el programa y el reproductor
- Iniciar el reproductor minimizado
Si estás usando un reproductor externo, esta opción te permite minimizarlo ni bien haya cargado.
- Minimizar el reproductor al detectar señal
También para reproductor externo, en este caso para minimizarlo cuando la señal del stream haya sido detectada.
- Minimizar mkStickyPlayer al iniciar reproducción
Es decir, minimizar el programa ni bien apretás Play.
- Minimizar al System Tray.
Permite enviar a mkStickyPlayer al System Tray de Windows cuando apretás el botón minimizar de la ventana.
Otras opciones
- Guardar log en un archivo
Permite guardar toda la información que aparece en el tab Log en un archivo llamado mkStickyPlayer.log, que se encuentra en c:\Documents and Settings\<Usuario>\Application Data\mkStickyPlayer.
- Mostrar tooltips de ayuda
Para que no te pierdas, marcando esta opción vas a ver unos bonitos tooltips de ayuda cuando pases el mouse sobre los botones y diferentes opciones de mkStickyPlayer.
|
|
|
 |
Los Streams y los controles generales de mkStickyPlayer
|
 |
|
En este tab podés agregar, modificar y borrar tus streams. También podés Exportar e Importar Streams.

En la lista podés hacer doble click sobre un stream para empezar a reproducirlo. Es el equivalente de hacerle un solo click y luego presionar Play.
En Búsqueda podés filtrar el listado de Streams. Un detalle: haciendo doble click sobre este campo, borrás su contenido rápidamente.
Al lado de la búsqueda tenés los botones para Exportar Streams a un archivo (para pasarle Streams a otra persona o para hacer un backup), Copiar Streams al clipboard (para pasar rápidamente algunos Streams por mail, por ejemplo) y finalmente el botón Importar, que te permite cargar en tu mkStickyPlayer los Streams que tengas en un archivo previamente exportado o copiados en el clipboard.
Más abajo, los controles generales del programa, que están siempre visibles.
Tenés los botones Play y Stop, que son bastante obvios. Luego tenés MiniPlayer y QuickPlay, dos opciones que vas a ver más adelante.
Al lado, la información del Stream en reproducción. Si te fijás, hay un pequeño link que se llama Agregar. Sirve para cargar un nuevo Stream con los datos que aparecen ahí. ¿Para qué sirve, si estoy reproduciendo un stream que ya cargué en mi lista? Para usar junto a la función QuickPlay.
En la sección Monitoreo, tenés el indicador de Señal detectada, otro que indica si el Sticky Mode está en funcionamiento o no. Luego, algo muy importante: los segundos que el programa va a esperar hasta que las diferentes instancias de reproducción de un stream se completen -estos son los segundos que definiste en el tab Opciones-. Y por último, el nivel de audio que se está reproduciendo.
|
|
|
 |
Importar Streams
|
 |
|
Esta ventana te permite importar Streams que tengas en un archivo previamente exportado por este programa o que hayas copiado al clipboard.

El botón Abrir archivo de Streams te permite elegir de qué archivo importar los Streams. Los Streams que contenga ese archivo se van a cargar en la lista, para que puedas Importar todos o solamente los que selecciones. El botón Pegar del clipboard carga en la lista lo que hayas copiado previamente, por ejemplo desde un mail.
Si estás importando Streams que te pasó otra persona, seguramente van a surgir incongruencias en los nombres de las Ubicaciones y los Formatos. Esto es porque cada uno define sus listas de ubicaciones y formatos como más le guste. Para solucionar estas incongruencias, vas a tener que utilizar las secciones Reemplazar Ubicaciones y Reemplazar Formatos.
En las listas Ubicaciones no encontradas y Formatos no encontrados vas a ver, si los hubiere, los valores que no coinciden con tus propias listas de ubicaciones y formatos. Seleccioná el valor por el que quieras reemplazar cada uno de estos valores no encontrados por uno de tu lista y hacé click en el botón Reemplazar que corresponda.
Importante: Sólo recién cuando hayas reemplazado todas las ubicaciones y todos los formatos no encontrados vas a poder importar los Streams.
|
|
|
 |
Reproductor interno
|
 |
|
Si estás viendo un stream de video, vas a poder verlo en este Tab.

El valor de Tiempo lamentablemente rara vez va a funcionar. Esto sucede porque mkStickyPlayer usa VLC para reproducir los streams internamente, el cual rara vez reporta este valor para los streams. Es una lástima, pero prefiero que sea así y seguir usando VLC, porque el soporte de streams es excelente.
|
|
|
 |
Web
|
 |
|
Una de las características que más adoro de mi propio programa es el soporte de radios que utilizan reproductores no convencionales para transmitir. A veces son Java, otras son Flash, etc. El tener un pequeño browser permite cargar también estos streams. Cuando reproduzcas un stream de estas características, lo vas a ver en este browser.

Un detalle a tener en cuenta es que mkStickyPlayer bloquea los popups y la aparición de nuevas ventanas que provengan desde el browser, para evitar lios.
|
|
|
 |
Ubicaciones
|
 |
|
Acá podés agregar, modificar y borrar las ubicaciones de los streams. Las ubicaciones te van a servir para ordenar la lista de streams y poder buscar por país, ciudad, etc.

|
|
|
 |
Formatos
|
 |
|
Los Formatos son una parte importantísima del programa. Es lo que define de qué manera hay que reproducir cada stream.

El Nombre del formato es puramente descriptivo. En la pantalla tenés algunos ejemplos para que te des una idea.
Luego, hay que decidir de qué manera se va a reproducir los streams que tengan asociados el presente formato. Hay tres posibilidades:
- Utilizar un reproductor externo
Es decir, Windows Media Player, Winamp, Real Player, Zoom Player, etc.
- Utilizar el reproductor interno
Marcá esta opción si querés que mkStickyPlayer reproduzca este formato internamente. Los formatos soportados son todos los que soporta VLC.
- Utilizar el browser interno
Como te contaba antes, si el stream sólo funciona con un reproductor no estándar que está embebido en la página Web del sitio, marcá esta opción.
Los Parámetros se utilizan únicamente para los reproductores externos. Te permite ingresar cualquier parámetro adicional que quieras enviar al reproductor. Normalmente no es necesario, pero puede ser útil con reproductores avanzados como Zoom Player o Media Player Classic, que soportan diferentes opciones en la línea de comandos.
Ubicar parámetros al final de la línea de comando permite definir de qué modo se crea la línea de comandos para un reproductor externo. Veamos un ejemplo. Supongamos que el reproductor es greatPlayer.exe y queremos pasarle el parámetro /volume=100
- Si esta opción está desmarcada, la línea de comandos será:
greatPlayer.exe /volume=100 <url del stream>
- Si está marcada, entonces será:
greatPlayer.exe <url del stream> /volume=100
|
|
|
 |
Log
|
 |
|
En este tab se muestra el log de actividad de mkStickyPlayer.

|
|
|
 |
MiniPlayer
|
 |
|
Esta pequeña ventanita está siempre On Top y te permite elegir streams, iniciarlos y detenerlos. ¿Cómoda? Que se yo!

Detalle importante: para volver a la ventana principal de mkStickyPlayer, hacé doble click sobre la barra de título del MiniPlayer.
|
|
|
 |
QuickPlay
|
 |
|
Te permite reproducir streams rápidamente, sin necesitar agregarlos a tu lista de streams.

El campo URL lo podés ingresar a mano, pero también va a extraer automáticamente una URL que hayas copiado al Clipboard. Por ejemplo, copiás al Clipboard la URL de un stream desde un sitio Web y cuando abrís el QuickPlay ya te va a aparecer ingresada.
Luego, elegís el formato y clickeás Play.
Tip: si querés guardar el stream que estás probando, hacés click en el link Agregar que se encuentra en la parte inferior de la ventana principal de mkStickyPlayer, al lado de Stream en reproducción. Luego, terminás de completar los datos del stream que faltan y lo agregás a tu lista.
|
|
|
|
|