Este documento proporciona información de referencia del API del reproductor sin bordes de YouTube.

Contenido

Aspectos generales

El reproductor sin bordes de YouTube proporciona a los desarrolladores la flexibilidad necesaria para personalizar el reproductor de YouTube con sus propios controles, sus propios "bordes" e incluso funciones como, por ejemplo, menús y listas de reproducción.

Requisitos

El usuario final debe tener instalado Flash Player 8 o superior. Debido a este requisito, te sugerimos que utilices SWFObject para insertar el objeto SWF y detectar la versión de Flash Player del usuario.

Introducción

En primer lugar, necesitas una clave de desarrollador. Para registrarte y obtener una, visita la página de registro.

El reproductor sin bordes está compuesto por dos archivos SWF. apiplayer.SWF contiene la función de reproducción de vídeo en sí. cl.SWF es un SWF que carga apiplayer.SWF y muestra las funciones del API del reproductor. También ofrece restricciones de lugar de ensayo de seguridad para apiplayer.SWF, por lo que los SWFs de carga no pueden acceder a los elementos que se encuentran dentro del reproductor directamente.

El reproductor se puede controlar a través de dos métodos: cargando el SWF en otro SWF (o sitio web Flash, etc.), o insertándolo directamente en una página HTML y utilizando JavaScript para controlar el reproductor. Los controles de JavaScript son idénticos a los del API de JavaScript del reproductor insertado.

La URL para cargar el SWF del reproductor sin bordes es la siguiente:

http://gdata.youtube.com/apiplayer?key=DEV_KEY

Funciones

Además de las que aparecen en la documentación del API de JavaScript, están disponibles las siguientes operaciones:

loadVideoById(videoId:String, startSeconds:Number):Void

Carga el vídeo especificado e inicia la reproducción del vídeo. Si se especifica startSeconds (puede ser un número decimal), el vídeo comenzará desde el fotograma más cercano al momento especificado.

cueVideoById(videoId:String, startSeconds:Number):Void

Carga la miniatura del vídeo especificado y prepara el reproductor para reproducir el vídeo. El reproductor no solicitará el FLV hasta que se ejecute playVideo() o seekTo(). startSeconds acepta un número decimal/entero y especifica el momento en que debe comenzar la reproducción del vídeo mediante la ejecución de playVideo(). Si especificas startSeconds y, a continuación, ejecutas seekTo(), startSeconds se omitirá, y el reproductor comenzará la reproducción desde el momento especificado en la llamada seekTo(). Si el vídeo está en cola y listo para reproducirse, el reproductor emitirá un evento de vídeo en cola (5).

setSize(width:Number, height:Number):Void

Define el tamaño del reproductor sin bordes. Este método se debe utilizar para definir el ancho y la altura del objeto MovieClip directamente. Ten en cuenta que este método no contiene las proporciones del reproductor de vídeo, por lo que deberás mantener una proporción de 4:3. Al insertar el reproductor directamente en HTML, el tamaño se actualiza automáticamente con los valores de Stage.width y Stage.height, por lo que no es necesario ejecutar setSize() al insertar el reproductor sin bordes directamente en una página HTML. El tamaño predeterminado del SWF al cargarlo en otro SWF es de 320 por 240 píxeles.

Ejemplos

Uso del API de JavaScript

Al insertar el reproductor sin bordes en una página HTML, activa el API de JavaScript. Para ello, añade una variable a la URL del SWF:

http://gdata.youtube.com/apiplayer?key=dev_key&enablejsapi=1

Para obtener una lista de los métodos de API disponibles y ejemplos de cómo utilizar el API de JavaScript, consulta la documentación de referencia.

Para ver un ejemplo del reproductor sin bordes con el API de JavaScript API, haz clic aquí.

Carga del reproductor en otro SWF

Para obtener más información sobre cómo cargar el reproductor sin bordes en otro SWF, consulta la documentación de ActionScript 2.0. Todas las llamadas a API son iguales, además de las descritas anteriormente.

Volver al principio