Check engine version/en

From Ace Stream Wiki
Revision as of 15:32, 22 September 2014 by Ankiria (talk | contribs) (Проверка версии движка с помощью javascript API)
Jump to: navigation, search

Check engine version using javascript API

Sometimes it is necessary to check a version of installed engine. For example, you have created a broadcast using a newer version of the engine, and this broadcast can't be viewed by users with older versions of the engine. In this case it is necessary to check the version and if needed to warn users with a message from a web page.

You can checke engine version on a web page using javascript API.

Method Player.getEngineVersion() is used for checking. It returns a string with engine version.

Узнать версию движка можно только после того, как на веб-страницу загрузился плагин Ace Stream P2P multimedia plugin. После завершения загрузки вызывается событие onLoad - именно в обработчике этого события нужно проверять версию.

Пример кода для получения версии движка:

<script type="text/javascript">
    var controls = new TorrentStream.Controls("player-div-id", {
        style: "internal"
    });

    try {
        var player = new TorrentStream.Player(controls.getPluginContainer(), {
                useInternalControls: true,
                onLoad: function() {
                    var engineVersion = this.getEngineVersion();
                    // check engine version here
                    this.registerEventHandler(controls);
                    controls.attachPlayer(this);
                    this.loadPlayer(contentId);
                }
        });
    }
    catch(e) {
        controls.onSystemMessage(e);
    }
 </script>

В данном примере вместо комментария check engine version here вы можете реализовать свою проверку версии.

Рабочий пример проверки версии можно посмотреть здесь: http://www.acestream.org/test/alpha.php. На данной странице запущена трансляция из-под движка версии 2.2.0 и стоит проверка на версию 2.2.х либо 3.х.х.