Psaní modulů plug-in pro Azure Media Player

  • Článek

Modul plug-in je JavaScript napsaný k rozšíření nebo vylepšení přehrávače. Můžete psát moduly plug-in, které mění vzhled a funkčnost Azure Media Playeru nebo dokonce mají rozhraní s jinými službami. Můžete to provést ve dvou jednoduchých krocích:

Krok 1

Napište JavaScript ve funkci, která vypadá takto:


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

Kód můžete napsat přímo na stránce HTML v rámci <script> značek nebo v externím souboru JavaScriptu. Pokud to uděláte, nezapomeňte za skript AMP zahrnout soubor JavaScriptu na <head> stránce HTML.

Příklad:

    <!--*****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>

Krok 2

Inicializace modulu plug-in pomocí JavaScriptu jedním ze dvou způsobů:

Metoda 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);

Metoda 2:

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

Nejsou vyžadovány možnosti modulu plug-in, včetně nich pouze umožňují vývojářům používajícím modul plug-in nakonfigurovat jeho chování, aniž by museli měnit zdrojový kód.

Inspiraci a další příklady vytvoření modulu plug-in najdete v naší galerii.

Poznámka

Kód modulu plug-in dynamicky mění položky v dom během životnosti hráčského prostředí diváka, nikdy neprovádí trvalé změny zdrojového kódu hráče. Tady je užitečné porozumět vývojářským nástrojům vašeho prohlížeče. Pokud například chcete změnit vzhled prvku v přehrávači, můžete najít jeho element HTML podle názvu třídy a pak přidat nebo změnit atributy odtud. Tady je skvělý zdroj informací o změně atributů HTML.

Integrované moduly plug-in

V současné době jsou v AMP dva pluginy: časový tip a klávesové zkratky. Tyto pluginy byly původně vyvinuty jako modulární pluginy pro hráče, ale nyní jsou zahrnuty do zdrojového kódu přehrávače.