ytCropper

Autor: José Manuel Blasco Galdón

Librería de métodos que ayudan al programador a implementar de forma sencilla un módulo que corta vídeos de YouTube. Se trata de una previsualización de vídeo con un segmento para el corte y métodos para la recolección de valores (manecillas, tiempo de reproducción).

Se puede ver una demo de su uso en: http://www.ytcropper.com/developers

For full english DOCs, read: https://github.com/manuman94/ytCropper/wiki

Requisitos

Incluir las librerías JQuery y JQuery UI (js y css), además de la hoja de estilos css y la librería javascript ytCropper.

http://jquery.com/download/
http://jqueryui.com/download/

+

<script src="ytCropper/ytCropper.js"></script>
<link rel="stylesheet" type="text/css" href="ytCropper/ytCropper.css" />

API

• Constructor de la clase:
  ytCropper(idcont,{ idvid , width, height, maxRange, minRange})
  Método que crea el reproductor listo para cortar un segmento en un div.
  
  idcont -> id del div que contendrá el cortador.
  idvid -> id del vídeo alojado en YouTube.
  width -> Ancho del reproductor.
  height -> Alto del reproductor.
  maxRange -> Valor máximo de separación de manecillas
  minRange -> Valor mínimo de separación de manecillas
  
  

• ytCropper::getVideoId()
  Devuelve el ID del vídeo asignado al cropper

• ytCropper::getInitialValue()
  Devuelve el valor de la primera manecilla en segundos (valor inicial del intervalo).
  
  

• ytCropper::getFinalValue()
  Devuelve el valor de la segunda manecilla en segundos (valor final del intervalo).
  
  

• ytCropper::setInitialValue(value)
  Función que cambia el valor inicial del intervalo.
  

value -> Valor en segundos

• ytCropper::setFinalValue(value)
  Función que cambia el valor final del intervalo.
  

value -> Valor en segundos

• ytCropper::getCurrentTime()
  Devuelve el tiempo de reproducción actual en segundos.
  
  

• ytCropper::getDuration()
  Devuelve la duración del vídeo cargado en segundos.
  
  

• ytCropper::getEmbedLink()
  Devuelve un link embed de youtube configurado para reproducir el intervalo especificado en el cropper.
  
  

• Event onProgress(e, currentTime)
  Función que se dispara cada segundo mientras el vídeo está reproduciendo.
  
  

e -> Referencia al evento.
currentTime -> El tiempo actual de reproducción

• Event onFirstHandleChange(e, handleValue)
  Función que se dispara cuando la primera manecilla cambia su valor.
  

e -> Referencia al evento.
handleValue -> El valor de la manecilla en segundos

• Event onSecondHandleChange(e, handleValue)
  Función que se dispara cuando la segunda manecilla cambia su valor.
  

e -> Referencia al evento.
handleValue -> El valor de la manecilla en segundos

• Event onVideoPlay(currentTime)
  Función que se dispara cuando el vídeo se comienza a reproducir o se reanuda.
  

currentTime -> El tiempo actual de reproducción en segundos

• Event onVideoPause(currentTime)
  Función que se dispara cuando el vídeo se pausa.
  

currentTime -> El tiempo actual de reproducción en segundos

Funciones extra:

• showWithTwoDigits(n)
  Función que devuelve un string de dos dígitos para poder mostrar la fecha con formato MM:SS. Ejemplo -> n = 9 -> salida = “09”.
  
  

• toDefaultTime(seconds)
  Función que convierte segundos a minutos y segundos. Devuelve un JSON con los valores minutes y seconds. Ejemplo -> seconds = 130 -> Return = { minutes:2, seconds: 10}

Demo

En el repositorio hay una página de prueba donde se puede ver el uso de los métodos y de la gestión de los eventos. La versión online de la demo se puede encontrar aquí:

http://www.ytcropper.com

Nota: Esta librería está en fase de pruebas. Si tienes cualquier problema o sugerencia puedes contactar a
José Manuel Blasco Galdón
[email protected].