Compartir a través de

Escritura de complementos para Azure Media Player

  • Artículo

Un complemento es un fragmento de JavaScript escrito para ampliar o mejorar el reproductor. Puede escribir complementos que cambien la apariencia de Azure Media Player, su funcionalidad, o incluso tener una interfaz con otros servicios. Puede hacerlo de dos sencillas maneras:

Paso 1

Escriba el código JavaScript en una función como la siguiente:


    (function () {
        amp.plugin('yourPluginName', function (options) {
        var myPlayer = this;
           myPlayer.addEventListener(amp.eventName.ready, function () {
        console.log("player is ready!");
            });
        });
    }).call(this);

Puede escribir el código directamente en la página HTML dentro de las etiquetas <script> o en un archivo externo de JavaScript. Si hace lo último, asegúrese de incluir el archivo JavaScript en el <head> de la página HTML después del script de Azure Media Player.

Ejemplo:

    <!--*****START OF Azure Media Player Scripts*****-->
    <script src="//amp.azure.net/libs/amp/latest/azuremediaplayer.min.js"></script>
    <link href="//amp.azure.net/libs/amp/latest/skins/amp-default/azuremediaplayer.min.css" rel="stylesheet">
    <!--*****END OF Azure Media Player Scripts*****-->
    <!--Add Plugins-->
    <script src="yourPluginName.js"></script>

Paso 2

Inicialice el complemento con JavaScript de una de estas dos maneras:

Método 1:

    var myOptions = {
        autoplay: true,
        controls: true,
        width: "640",
        height: "400",
        poster: "",
        plugins: {
            yourPluginName: {
                [your plugin options]: [example options]
           }
        }
    };
    var myPlayer = amp([videotag id], myOptions);

Método 2:

    var video = amp([videotag id]);
    video.yourPluginName({[your plugins option]: [example option]});

No se necesitan opciones de complemento, solo se las incluye para permitir a los desarrolladores usar el complemento para configurar su comportamiento sin tener que cambiar el código fuente.

Para obtener inspiración y más ejemplos sobre cómo crear un complemento, eche un vistazo a nuestra galería.

Nota

El código del complemento cambia dinámicamente los elementos del DOM durante la duración de la experiencia del espectador con el reproductor, nunca realiza cambios permanentes en el código fuente del reproductor. Aquí es donde resulta útil comprender las herramientas para desarrolladores del explorador. Por ejemplo, si desea cambiar la apariencia de un elemento en el reproductor, puede encontrar su elemento HTML por su nombre de clase y, a continuación, agregar o cambiar los atributos desde allí. Este es un excelente recurso para cambiar los atributos HTML.

Complementos integrados

Actualmente hay dos complementos preparados en Azure Media Player: la sugerencia de tiempo y las teclas de acceso rápido. Estos complementos se desarrollaron originalmente para ser complementos modulares del reproductor, pero ahora se incluyen en el código fuente del mismo.