Інструкцыя па ўсталяванні

Дакументацыя і API

Smart Player JS API і REST API платформы Tvigle Video Publisher: усталяванне плэера, кіраванне прайграваннем, праца з відэа, плэй-лістамі і катэгорыямі, RSS і публічная выдача відэа.

JS APIREST API · JSONDASH / HLS / MP4AVOD · TVOD · SVOD · ESTРэестр расійскага ПЗ № 20881

Smart Player JS API

Праграмнае забеспячэнне ўяўляе сабой інтэрнэт-сэрвіс, дадатковых дзеянняў па ўсталяванні праграмы ад карыстальніка не патрабуецца.

Функцыянальныя характарыстыкі плэера Video Publisher

Пералік адпавядае запісу ў рэестры расійскага ПЗ № 20881.

Прайграванне

  • Кросплатформеннасць
  • Падтрымка ўсіх сучасных стандартаў відэа (DASH/HLS/MP4)
  • Адаптыўны стрымінг
  • Падтрымка прамых эфіраў
  • Магчымасць выкарыстоўваць плэй-лісты

Інтэграцыя

  • Гнуткі адзіны API дазваляе хутка інтэграваць відэаплатформу ва ўласную CMS сайта
  • Адсочванне ключавых падзей падчас прагляду відэа
  • Кастамізацыя інтэрфейсу плэера пад кліента

Манетызацыя і абарона

  • Магчымасць паказваць рэкламу ў сетцы Інтэрнэт
  • Сумяшчальнасць з любым даступным спосабам манетызацыі на сайце кліента
  • Падтрымка мадэлей продажу кантэнту AVOD/TVOD/SVOD/EST
  • Падключэнне DRM-модуля для аховы аўтарскіх правоў на кантэнт

Інструкцыі па ўсталяванні плэера Video Publisher

Каб падключыць Smart API, партнёр павінен уставіць гэты код на сваю старонку.

HTMLПросты плэер Video Publisher
Код устаўкі
<script language="JavaScript" type="text/javascript" src="/src/player_builder.min.js"></script>
<object class="TviglePlayer">
    <param name="bgcolor" value="#000000"/>
    <param name="width" value="720">
    <param name="height" value="405">
    <param name="id" value="875223">
    <param name="playlistID" value="35044">
    <param name="useAPI" value="true">
    <param name="autoChangeVideo" value="true">
    <param name="autoStart" value="true">
</object>
HTMLПлэер Video Publisher з магчымасцю кіравання і праслухоўвання падзей
Код устаўкі з апрацоўшчыкамі
<script language="JavaScript" type="text/javascript" src="/src/player_builder.min.js"></script>
<object class="TviglePlayer">

    ...

    <!-- eventHandler: String (неабавязковы) - Імя JS-метаду, які будзе апрацоўваць «падзеі» з тыкета VP-110 -->
    <param name="eventHandler" value="Partner.eventHandler">

    <!-- templateLoadHandler: String (неабавязковы) - Імя JS-метаду, які будзе выкліканы ў момант ініцыялізацыі плэера -->
    <param name="templateLoadHandler" value="Partner.onLoaded">

    <!-- templateReadyHandler: String (неабавязковы) - Імя JS-метаду, які будзе выкліканы ў момант гатоўнасці плэера да прайгравання -->
    <param name="templateReadyHandler" value="Partner.onReady">

    ...

</object>
JSJavaScript — прыклад PlayerProxy / Partner
JavaScript
var PlayerProxy = function(player) {
    this.player = undefined;
    this.handlers = {
        "current_video_change": function(id) {
            console.warn("----now video id is", id);
        },
        "play": function(video) {
            console.warn("----video playing");
        },
        "pause": function(video) {
            console.warn("----video paused");
        },
        "on_progress": function(position) {
            console.warn("----position eq", position);
        }
    };
};

//----------------------------------- METHODS
PlayerProxy.prototype.play = function() {
    this.getPlayer().play();
};

PlayerProxy.prototype.pause = function() {
    this.getPlayer().pause();
};

PlayerProxy.prototype.stop = function() {
    this.getPlayer().stop();
};

PlayerProxy.prototype.next = function(autoplay) {
    this.getPlayer().next(autoplay);
};

PlayerProxy.prototype.prev = function(autoplay) {
    this.getPlayer().prev(autoplay);
};

PlayerProxy.prototype.setQuality = function(quality) {
    this.getPlayer().setQuality(quality);
};

PlayerProxy.prototype.seek = function(position) {
    this.getPlayer().seek(position);
};

PlayerProxy.prototype.getState = function() {
    var self = this;
    this.getPlayer().getState(function(state) {
        var isPlaying = !!(state & self.states.STATE_PLAYING);
        console.warn(isPlaying);
    });
};

//-----------------------------------
PlayerProxy.prototype.getPlayer = function() {
    return this.getPlayerObject().getModule(tvigle.api.modules.APIModules.VIDEO_PLAYER);
};

PlayerProxy.prototype.setPlayerObject = function(player) {
    this.player = player;
};

PlayerProxy.prototype.getPlayerObject = function() {
    return this.player;
};

PlayerProxy.prototype.getHandler = function(name) {
    return this.handlers[name];
};

//----------------------------------- STATIC
PlayerProxy.getInstance = function() {
    if (this.instance === undefined) {
        this.instance = new PlayerProxy();
    }
    return this.instance;
};

Partner = (function(player) {
    "use strict";
    return {

        /**
         * Player was created
         * @param {String} id   Player ID
         */
        "onLoaded": function(id) {
            player.setPlayerObject(tvigle.api.getPlayer(id));
        },

        /**
         * Player prepared to play
         */
        "onReady": function() {
            // Autoplay example
            // player.play();
        },

        /**
         * Event router
         * @param event
         */
        "eventHandler": function(event) {
            var command = event['name'],
                args = event['args'];
            var method = player.getHandler(command);

            if (typeof method === "function") {
                method.apply(player, args);
            } else if (window.console){
                console.log("Function named " + command + "(" + args.length + " params) is not defined.");
            }
        }
    };

    this.states = {};
    this.states.STATE_INITED = 1 << 0;
    this.states.STATE_ACTIVATED = 1 << 1;
    this.states.STATE_AD_SHOWING = 1 << 2;
    this.states.STATE_BUFFERING = 1 << 3;
    this.states.STATE_PLAYING = 1 << 4;
    this.states.STATE_PAUSED = 1 << 5;
    this.states.STATE_STOPPED = 1 << 6;
    this.states.STATE_IN_SEEK = 1 << 7;
    this.states.STATE_FULLSCREEN = 1 << 8;
    this.states.STATE_FULLBROWSER = 1 << 9;
    this.states.STATE_FITTED = 1 << 10;
    this.states.STATE_CONTINUOUS_PLAY = 1 << 11;
    this.states.STATE_FIT_AVAILABLE = this.states.STATE_FULLBROWSER | this.states.STATE_FULLSCREEN;
    this.states.STATE_MIDDLE_ROLL_WAS = 1 << 12;
})(PlayerProxy.getInstance());

Метады, даступныя партнёру

JSСетэры
Setters
loadVideoByID(id: Integer): void
play(): void
pause(): void
stop(): void
seek(time: Number): void
next([autoplay: Boolean]): void
prev([autoplay: Boolean]): void
setVolume(volume: Number): void
setQuality(quality: String): void (апісанне ніжэй, раздзел «Якасці відэа»)
fullscreen(): void
JSГетэры
Getters
getVolume(callback: Function): void
getDuration(callback: Function): void
getVideoQueue(callback: Function): void
getCurrentVideo(callback: Function): void
getPosition(callback: Function): void
getState(callback: Function): void (апісанне ніжэй, раздзел «Станы плэера»)
JSСтаны плэера Video Publisher
Бітавыя сцягі; праверка праз пабітавае І, гл. прыклад getState вышэй.
States
(1 << 0) - Плэер ініцыялізаваны
(1 << 1) - Плэер гатовы да прайгравання
(1 << 2) - Ідзе паказ рэкламы (плэер заблакіраваны)
(1 << 3) - Ідзе буферызацыя
(1 << 4) - Ідзе прайграванне
(1 << 5) - На паўзе
(1 << 6) - Быў спынены
(1 << 7) - Ідзе пошук ключавога кадра падчас выканання метаду seek
(1 << 8) - Плэер у поўнаэкранным рэжыме
(1 << 9) - Плэер разгорнуты на ўсё акно браўзера
(1 << 10) - Overlay
(1 << 11) - Прайграванне працягваецца
JSЯкасці відэа
Qualities
HD240 - якасць 240p
HD320 - якасць 320p
HD480 - якасць 480p
HD720 - якасць 720p
HD1080 - якасць 1080p
HD1440 - якасць 1440p

Праца з кантэнтам · Відэа

Даданне, атрыманне, рэдагаванне і выдаленне відэа. Фармат запытаў і адказаў — application/json.

01Даданне відэа

POST/api/videos/
Request (application/json)
Body
{
    "name": "Назва відэа",
    "description": "Апісанне відэа",
    "show_ad": true,
    "age_restrictions": "6+",
    "publication_date": "%Y-%m-%d %H:%M",
    "callback_url": "http://example.com/callback/",
    "source_url" : "http://example.com/source.mp4",
    "resources": [
        {
            "quality":"240p",
            "url":"http://www.tvigle.ru/1.avi"
        },
        {
            "quality":"720p",
            "url":"http://www.tvigle.ru/2.avi"
        }
    ]
}
Schema
{
    "type":"object",
    "required":[
        "name",
        "description"
    ],
    "properties":{
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        }
    },
    "show_ad":{
        "type":"boolean"
    },
    "age_restrictions":{
        "type":"string"
    },
    "publication_date":{
        "type":"date-time"
    },
    "callback_url":{
        "type":"string"
    },
    "source_url":{
        "type":"string"
    },
    "resources":{
        "type":"array",
        "items":{
            "type":"object",
            "required":[
                "quality",
                "url"
            ],
            "properties":{
                "quality":"string",
                "url":"string"
            }
        }
    }
}
Response 201 (application/json)
{
    "embed_html": "<script language='JavaScript'
                        type='text/javascript'
                        src='/static/player/player_builder.min.js'></script>
        <object class='TviglePlayer'>
            <param name='bgcolor' value='#000000' />
            <param name='height' value='405' />
            <param name='width' value='702' />
            <param name='id' value='1' />
            <param name='useAPI' value='true' />
            <param name='autoChangeVideo' value='false' />
        </object>",
    "duration": "0:47",
    "id": 1,
    "category": 5,
    "errors": [],
    "country_restrictions": [],
    "age_restrictions": "18+",
    "progress": 100,
    "thumbnail": "http://photo.tvigle.ru/res/prt/c330f15b00e2d7499a04688ae5657e5d/40/33/000001284033/pub.jpg",
    "resources": [
        {
            "status": "queued",
            "progress": 0,
            "errors": [],
            "quality": "240p",
            "id": 2
        },
        {
            "status": "queued",
            "progress": 0,
            "errors": [],
            "quality": "480p",
            "id": 1
        }
    ],
    "status": "published",
    "description": "",
    "tags": [],
    "show_ad": true,
    "is_active": true,
    "is_playable": true,
    "publication_date": null,
    "name": "Какое-то имя",
    "created_at": "2013-06-29 10:19:43",
    "aspect_ratio": "16:9",
    "distribution": 1,
    "freezeFrame": null
}

02Атрыманне спіса відэа

GET/api/videos/{?contract_id}{?order_by}{?q}{?name}{?status}{?tv_id}{?license_date_to}
contract_id
optional, numeric, 1 — id кантракта, да якога прывязана відэа
order_by
optional, string, -created_time — поле, па якім сартаваць. Дапушчальныя значэнні: -name, name, created_time, -created_time, -publication_start_date, publication_start_date
q
optional, string, Пошук — радок пошуку, па якім шукаць відэа
name
optional, string, Відэа — імя, па якім фільтраваць відэа
status
optional, string, published — статус, па якім фільтраваць відэа. Дапушчальныя варыянты: queued, waiting, processing, finished, published, failed, cancelled
tv_id
optional, string, 111 — tv_id, па якім фільтраваць відэа
license_date_to
optional, string, YYYY-MM-DD — фільтр па даце заканчэння ліцэнзіі. Выводзіць відэа, ліцэнзія на якія заканчваецца не пазней за ўказаную дату
Response 200 (application/json)
{
    "total_count":3064,
    "result":[
        {
            "status":"published",
            "embed_html":"<iframe src='http://127.0.0.1:8000/video/5350456/?playerId=13&amp;partnerId=1'
                width='854'
                height='405'
                frameborder='no'
                scrolling='no'
                webkitAllowFullScreen
                mozallowfullscreen
                allowfullscreen></iframe>",
            "subtitle":null,
            "description":"поп-музыка La Vtornik!",
            "tags":[
                "поп-музыка",
                "La Vtornik",
                "поп"
            ],
            "iframe_url":"http://127.0.0.1:8000/video/5350456/?playerId=13&partnerId=1",
            "show_ad":true,
            "embed_object":"<object class='TviglePlayer'>
                    <param name='id' value='5350456'>
                    <param name='adv_cat_id' value='6'>
                    <param name='partnerId' value='1'>
                    <param name='autoStart' value='true'>
                    <param name='forceFlashObject' value='true'>
                    <param name='wmode' value='opaque'>
                    <param name='playerId' value='13'>
                    <param name='width' value='854'>
                    <param name='height' value=''>
                    <param name='useAPI' value='true'>
                    <param name='autoChangeVideo' value='false'>
                    <!--<param name='api_sign' value='play_token=111&expire=222&key=333'>-->
                    <!--<param name='trace' value='true'>-->
                </object>
                <script language='JavaScript'
                        type='text/javascript'
                        data-hang='false'
                        src='/static/player/player_builder.min.js'></script>",
            "is_active":true,
            "is_playable":true,
            "duration_in_ms":201762,
            "callback_url":null,
            "errors":[],
            "meta":{
                "country_restrictions":[]
            },
            "license": {
                "date_from": "2017-03-20",
                "date_to": "2018-03-20"
            },
            "duration":"3:21",
            "publication_date":"2013-12-28 21:00:00",
            "is_banned":false,
            "freezeFrame":"//127.0.0.1:8000/res/2016/01/11/0f113cb6-ccb7-448d-83b0-32611fb2648f.png",
            "partner_id":1,
            "id":5350456,
            "category":27774,
            "rightholder":18799,
            "country_restrictions":[],
            "name":"Зацепила",
            "publication_start_date":"",
            "age_restrictions":"12+",
            "created_at":"2016-01-11 18:18:20",
            "url":"/client/videos/5350456/",
            "publication_end_date":"",
            "aspect_ratio":null,
            "progress":100,
            "distribution":1,
            "status_display":"опубликован",
            "thumbnail":"//127.0.0.1:8000/res/2016/01/11/18da8e2d-3f87-4bf8-bcc6-c14e917b2738.jpg",
            "resources":[
                {
                    "status":"finished",
                    "errors":[],
                    "format":"flv",
                    "progress":100,
                    "quality":"1080p",
                    "id":9632266
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"mp4",
                    "progress":100,
                    "quality":"480p",
                    "id":9632263
                }
            ],
            "tv_id":null
        }
    ]
}

03Атрыманне спіса партнёрскага відэа

GET/api/videos/{?partner_id}
partner_id
required, integer, 1 — id партнёра, відэа якога даступна
Заўвага: каб атрымаць спіс відэа Tvigle.ru, неабходна выкарыстоўваць параметр ?partner_id=24
Response 200 (application/json)
{
    "total_count":3064,
    "result":[
        {
            "status":"published",
            "embed_html":"<iframe src='http://127.0.0.1:8000/video/5350456/?playerId=13&amp;partnerId=1'
                width='854'
                height='405'
                frameborder='no'
                scrolling='no'
                webkitAllowFullScreen
                mozallowfullscreen
                allowfullscreen></iframe>",
            "subtitle":null,
            "description":"поп-музыка La Vtornik!",
            "tags":[
                "поп-музыка",
                "La Vtornik",
                "поп"
            ],
            "iframe_url":"http://127.0.0.1:8000/video/5350456/?playerId=13&partnerId=1",
            "show_ad":true,
            "embed_object":"<object class='TviglePlayer'>
                    <param name='id' value='5350456'>
                    <param name='adv_cat_id' value='6'>
                    <param name='partnerId' value='1'>
                    <param name='autoStart' value='true'>
                    <param name='forceFlashObject' value='true'>
                    <param name='wmode' value='opaque'>
                    <param name='playerId' value='13'>
                    <param name='width' value='854'>
                    <param name='height' value=''>
                    <param name='useAPI' value='true'>
                    <param name='autoChangeVideo' value='false'>
                    <!--<param name='api_sign' value='play_token=111&expire=222&key=333'>-->
                    <!--<param name='trace' value='true'>-->
                </object>
                <script language='JavaScript'
                        type='text/javascript'
                        data-hang='false'
                        src='/static/player/player_builder.min.js'></script>",
            "is_active":true,
            "is_playable":true,
            "duration_in_ms":201762,
            "callback_url":null,
            "errors":[],
            "meta":{
                "country_restrictions":[]
            },
            "license": {
                "date_from": "2017-03-20",
                "date_to": "2018-03-20"
            },
            "duration":"3:21",
            "publication_date":"2013-12-28 21:00:00",
            "is_banned":false,
            "freezeFrame":"//127.0.0.1:8000/res/2016/01/11/0f113cb6-ccb7-448d-83b0-32611fb2648f.png",
            "partner_id":1,
            "id":5350456,
            "category":27774,
            "rightholder":18799,
            "country_restrictions":[],
            "name":"Зацепила",
            "publication_start_date":"",
            "age_restrictions":"12+",
            "created_at":"2016-01-11 18:18:20",
            "url":"/client/videos/5350456/",
            "publication_end_date":"",
            "aspect_ratio":null,
            "progress":100,
            "distribution":1,
            "status_display":"опубликован",
            "thumbnail":"//127.0.0.1:8000/res/2016/01/11/18da8e2d-3f87-4bf8-bcc6-c14e917b2738.jpg",
            "resources":[
                {
                    "status":"finished",
                    "errors":[],
                    "format":"flv",
                    "progress":100,
                    "quality":"1080p",
                    "id":9632266
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"mp4",
                    "progress":100,
                    "quality":"480p",
                    "id":9632263
                }
            ],
            "tv_id":null
        }
    ]
}

04Выдаленне відэа

DELETE/api/videos/{id}
id
required, integer, 1 — id відэа
Response 204

05Атрыманне відэа па ID

GET/api/videos/{id}
id
required, integer, 1 — id відэа
Response 200 (application/json)
{
    "status":"published",
    "embed_html":"<iframe src='http://127.0.0.1:8000/video/5350456/?playerId=13&amp;partnerId=1'
        width='854'
        height='405'
        frameborder='no'
        scrolling='no'
        webkitAllowFullScreen
        mozallowfullscreen
        allowfullscreen></iframe>",
    "subtitle":null,
    "description":"поп-музыка La Vtornik!",
    "tags":[
        "поп-музыка",
        "La Vtornik",
        "поп"
    ],
    "iframe_url":"http://127.0.0.1:8000/video/5350456/?playerId=13&partnerId=1",
    "show_ad":true,
    "embed_object":"<object class='TviglePlayer'>
            <param name='id' value='5350456'>
            <param name='adv_cat_id' value='6'>
            <param name='partnerId' value='1'>
            <param name='autoStart' value='true'>
            <param name='forceFlashObject' value='true'>
            <param name='wmode' value='opaque'>
            <param name='playerId' value='13'>
            <param name='width' value='854'>
            <param name='height' value=''>
            <param name='useAPI' value='true'>
            <param name='autoChangeVideo' value='false'>
            <!--<param name='api_sign' value='play_token=111&expire=222&key=333'>-->
            <!--<param name='trace' value='true'>-->
        </object>
        <script language='JavaScript'
                type='text/javascript'
                data-hang='false'
                src='/static/player/player_builder.min.js'></script>",
    "is_active":true,
    "is_playable":true,
    "duration_in_ms":201762,
    "callback_url":null,
    "errors":[],
    "meta":{
        "country_restrictions":[]
    },
    "duration":"3:21",
    "publication_date":"2013-12-28 21:00:00",
    "is_banned":false,
    "freezeFrame":"//127.0.0.1:8000/res/2016/01/11/0f113cb6-ccb7-448d-83b0-32611fb2648f.png",
    "partner_id":1,
    "id":5350456,
    "category":27774,
    "rightholder":18799,
    "country_restrictions":[],
    "name":"Зацепила",
    "publication_start_date":"",
    "age_restrictions":"12+",
    "created_at":"2016-01-11 18:18:20",
    "url":"/client/videos/5350456/",
    "publication_end_date":"",
    "aspect_ratio":null,
    "progress":100,
    "distribution":1,
    "status_display":"опубликован",
    "thumbnail":"//127.0.0.1:8000/res/2016/01/11/18da8e2d-3f87-4bf8-bcc6-c14e917b2738.jpg",
    "resources":[
        {
            "status":"finished",
            "errors":[],
            "format":"flv",
            "progress":100,
            "quality":"1080p",
            "id":9632266
        },
        {
            "status":"finished",
            "errors":[],
            "format":"mp4",
            "progress":100,
            "quality":"480p",
            "id":9632263
        }
    ],
    "tv_id":null
}

06Атрыманне метаданых відэа

GET/api/videos/{video_id}/meta/?partner_id=24{?access_token}
video_id
required, numeric, 1 — id відэа
access_token
required, string, 2356db1a9ed7243a61ea58cd29cc7573 — токен аўтарызацыі
Response 200 (application/json)
{
    "album":"",
    "description":"Недавно уволенные друзья, которым уже за сорок...",
    "film_studios":[],
    "kinopoisk_id":null,
    "url":"http://www.tvigle.ru/video/kadry-treiler/",
    "season":null,
    "tags":[
        "Оуэн Уилсон",
        "Винс Вон",
        "The Internship",
        "2013"
    ],
    "original_name":"",
    "persons":{
        "producers":[],
        "directors":[],
        "writers":[],
        "actors":[],
        "composer":[],
        "singers":[]
    },
    "release_year":null,
    "awards":[],
    "genries":[
        "Комедия"
    ],
    "series":null,
    "countries":[],
    "id":5147182,
    "name":"Кадры Трейлер"
}

07Рэдагаванне відэа

PUT/api/videos/{id}
id
required, integer, 1 — id відэа
Request (application/json)
Body
{
    "name": "Назва відэа",
    "description": "Апісанне відэа",
    "show_ad": true,
    "age_restrictions": "6+",
    "publication_date": "%Y-%m-%d %H:%M"
}
Schema
{
    "type":"object",
    "required":[
        "name",
        "description"
    ],
    "properties":{
        "name":{
            "type":"string"
        },
        "description":{
            "type":"string"
        }
    },
    "show_ad":{
        "type":"boolean"
    },
    "age_restrictions":{
        "type":"string"
    },
    "publication_date":{
        "type":"date-time"
    }
}

Праца з кантэнтам · Плэй-лісты

01Спіс

GET/api/playlists/{?q}
q
required, string, радок — радок, па якім шукаць плэй-лісты
Response 200 (application/json)
{
    "total_count":1,
    "result":[
        {
            "embed_html":"<iframe src='http://cloud.tvigle.ru/playlist/1/?playerId=1&amp;partnerId=1'
                width='854'
                height='405'
                frameborder='no'
                scrolling='no'
                webkitAllowFullScreen
                mozallowfullscreen
                allowfullscreen></iframe>",
            "description":"",
            "iframe_url":"http://cloud.tvigle.ru/playlist/1/?playerId=1&partnerId=1",
            "embed_object":"<object class='TviglePlayer'>
                    <param name='playlistID' value='1'>
                    <param name='id' value=''>
                    <param name='adv_cat_id' value='1'>
                    <param name='partnerId' value='1'>
                    <param name='autoStart' value='true'>
                    <param name='forceFlashObject' value='true'>
                    <param name='wmode' value='opaque'>
                    <param name='playerId' value='1'>
                    <param name='width' value='854'>
                    <param name='height' value=''>
                    <param name='useAPI' value='true'>
                    <param name='autoChangeVideo' value='false'>
                </object>
                <script language='JavaScript'
                        type='text/javascript'
                        data-hang='false'
                        src='//cloud.tvigle.ru/static/player/player_builder.min.js'></script>",
            "is_active":true,
            "number_of_videos":0,
            "id":1,
            "name":"123"
        }
    ]
}

02Стварэнне

POST/api/playlists/
Request (application/json)
{
    "description": "test_playlist_description",
    "name": "test_playlist_name6"
}
Response 201 (application/json)
{
    "embed_html":"<iframe src='http://cloud.tvigle.ru/playlist/1/?playerId=1&amp;partnerId=1'
        width='854'
        height='405'
        frameborder='no'
        scrolling='no'
        webkitAllowFullScreen
        mozallowfullscreen
        allowfullscreen></iframe>",
    "description":"test_playlist_description",
    "iframe_url":"http://cloud.tvigle.ru/playlist/1/?playerId=1&partnerId=1",
    "embed_object":"<object class='TviglePlayer'>
            <param name='playlistID' value='1'>
            <param name='id' value=''>
            <param name='adv_cat_id' value='1'>
            <param name='partnerId' value='1'>
            <param name='autoStart' value='true'>
            <param name='forceFlashObject' value='true'>
            <param name='wmode' value='opaque'>
            <param name='playerId' value='1'>
            <param name='width' value='854'>
            <param name='height' value=''>
            <param name='useAPI' value='true'>
            <param name='autoChangeVideo' value='false'>
        </object>
        <script language='JavaScript'
                type='text/javascript'
                data-hang='false'
                src='//cloud.tvigle.ru/static/player/player_builder.min.js'></script>",
    "is_active":true,
    "number_of_videos":0,
    "id":1,
    "name":"test_playlist_name6"
}

03Падрабязнасці

GET/api/playlists/{id}/
id
required, numeric, 1 — id плэй-ліста
Response 200 (application/json)
{
    "embed_html":"<iframe src='http://cloud.tvigle.ru/playlist/1/?playerId=1&amp;partnerId=1'
        width='854'
        height='405'
        frameborder='no'
        scrolling='no'
        webkitAllowFullScreen
        mozallowfullscreen
        allowfullscreen></iframe>",
    "description":"",
    "iframe_url":"http://cloud.tvigle.ru/playlist/1/?playerId=1&partnerId=1",
    "embed_object":"<object class='TviglePlayer'>
            <param name='playlistID' value='1'>
            <param name='id' value=''>
            <param name='adv_cat_id' value='1'>
            <param name='partnerId' value='1'>
            <param name='autoStart' value='true'>
            <param name='forceFlashObject' value='true'>
            <param name='wmode' value='opaque'>
            <param name='playerId' value='1'>
            <param name='width' value='854'>
            <param name='height' value=''>
            <param name='useAPI' value='true'>
            <param name='autoChangeVideo' value='false'>
        </object>
        <script language='JavaScript'
                type='text/javascript'
                data-hang='false'
                src='//cloud.tvigle.ru/static/player/player_builder.min.js'></script>",
    "is_active":true,
    "number_of_videos":0,
    "id":1,
    "name":"123"
}

04Змяненне

PUT/api/playlists/{id}/
id
required, numeric, 1 — id плэй-ліста
Request (application/json)
{
    "description": "update2",
    "name": "updated1"
}
Response 200 (application/json)
{
    "embed_html":"<iframe src='http://cloud.tvigle.ru/playlist/1/?playerId=1&amp;partnerId=1'
        width='854'
        height='405'
        frameborder='no'
        scrolling='no'
        webkitAllowFullScreen
        mozallowfullscreen
        allowfullscreen></iframe>",
    "description":"update2",
    "iframe_url":"http://cloud.tvigle.ru/playlist/1/?playerId=1&partnerId=1",
    "embed_object":"<object class='TviglePlayer'>
            <param name='playlistID' value='1'>
            <param name='id' value=''>
            <param name='adv_cat_id' value='1'>
            <param name='partnerId' value='1'>
            <param name='autoStart' value='true'>
            <param name='forceFlashObject' value='true'>
            <param name='wmode' value='opaque'>
            <param name='playerId' value='1'>
            <param name='width' value='854'>
            <param name='height' value=''>
            <param name='useAPI' value='true'>
            <param name='autoChangeVideo' value='false'>
        </object>
        <script language='JavaScript'
                type='text/javascript'
                data-hang='false'
                src='//cloud.tvigle.ru/static/player/player_builder.min.js'></script>",
    "is_active":true,
    "number_of_videos":0,
    "id":1,
    "name":"updated1"
}

05Выдаленне

DELETE/api/playlists/{id}/
id
required, numeric, 1 — id плэй-ліста
Response 204

06Спіс відэа

GET/api/playlists/{id}/videos/
id
required, numeric, 1 — id плэй-ліста
Response 200 (application/json)
{
    "total_count":1,
    "result":[
        {
            "embed_html":"<iframe src='http://cloud.tvigle.ru/video/1/?playerId=1'
                width='702'
                height='405'
                frameborder='no'
                scrolling='no'
                webkitAllowFullScreen
                mozallowfullscreen
                allowfullscreen></iframe>",
            "subtitle":null,
            "callback_url":null,
            "meta":{
                "country_restrictions":[]
            },
            "duration":"2:44",
            "partner_id":24,
            "id":5144693,
            "category":33295,
            "errors":[],
            "country_restrictions":[],
            "age_restrictions":"0+",
            "publication_end_date":"2015-11-20 12:58:03",
            "progress":100,
            "thumbnail":"//example.com/thumbnail.png",
            "resources":[
                {
                    "status":"finished",
                    "errors":[],
                    "format":"mp4",
                    "progress":100,
                    "quality":"240p",
                    "id":850898
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"flv",
                    "progress":100,
                    "quality":"240p",
                    "id":850899
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"flv",
                    "progress":100,
                    "quality":"480p",
                    "id":850900
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"mp4",
                    "progress":100,
                    "quality":"480p",
                    "id":850901
                }
            ],
            "tv_id":null,
            "status":"finished",
            "description":"Описание",
            "tags":[
                "тег 1",
                "тег 2"
            ],
            "iframe_url":"http://cloud.tvigle.ru/video/1/?playerId=1",
            "show_ad":true,
            "embed_object":"<object class='TviglePlayer'>
                    <param name='id' value='1'>
                    <param name='adv_cat_id' value='1'>
                    <param name='partnerId' value='1'>
                    <param name='autoStart' value='true'>
                    <param name='forceFlashObject' value='true'>
                    <param name='wmode' value='opaque'>
                    <param name='playerId' value='1'>
                    <param name='width' value=''>
                    <param name='height' value=''>
                    <param name='useAPI' value='true'>
                    <param name='autoChangeVideo' value='false'>
                    <!--<param name='api_sign' value='play_token=111&expire=222&key=333'>-->
                    <!--<param name='trace' value='true'>-->
            </object>
            <script language='JavaScript'
                    type='text/javascript'
                    data-hang='false'
                    src='//cloud.tvigle.ru/static/player/player_builder.min.js'></script>",
            "is_active":true,
            "is_playable":true,
            "duration_in_ms":146680,
            "status_display":"обработан",
            "publication_date":"2013-02-20 15:40:00",
            "is_banned":false,
            "rightholder":1,
            "name":"Название",
            "publication_start_date":"",
            "created_at":"2014-08-18 20:43:48",
            "url":"/client/videos/1/",
            "aspect_ratio":null,
            "distribution":1,
            "freezeFrame":null,
            "order":1
        }
    ]
}

07Даданне відэа

POST/api/playlists/{playlist_id}/videos/{video_id}/
playlist_id
required, numeric, 1 — id плэй-ліста
video_id
required, numeric, 1 — id відэа
Response 201

08Выдаленне відэа

DELETE/api/playlists/{playlist_id}/videos/{video_id}/
playlist_id
required, numeric, 1 — id плэй-ліста
video_id
required, numeric, 1 — id відэа
Response 204

Праца з кантэнтам · Катэгорыі

01Спіс

GET/api/library/{?q}{?parent_id}{?level}
q
optional, string, запыт — радок запыту, па якім фільтраваць катэгорыі
parent_id
optional, numeric, 1 — id бацькоўскай катэгорыі
level
optional, numeric, 1 — узровень укладзенасці катэгорыі. Напрыклад, каб атрымаць катэгорыі толькі 1-га ўзроўню, неабходна перадаць level=1
Response 200 (application/json)
{
    "total_count": 11,
    "result": [
        {
            "description": "description",
            "has_children": false,
            "is_active": true,
            "id": 20114,
            "name": "ttt",
            "level": 0,
            "url": "/client/categories/20114/",
            "priority": 0,
            "parent_id": null,
            "number_of_videos": 0,
            "thumbnail": ""
        }
    ]
}

02Спіс партнёрскіх

GET/api/library/{?partner_id}{?parent_id}
partner_id
required, numeric, 1 — id партнёра, кантэнт якога даступны бягучаму партнёру
parent_id
optional, numeric, 1 — id бацькоўскай катэгорыі
Response 200 (application/json)
{
    "total_count": 11,
    "result": [
        {
            "description": "description",
            "has_children": false,
            "is_active": true,
            "id": 20114,
            "name": "ttt",
            "level": 0,
            "url": "/client/categories/20114/",
            "priority": 0,
            "parent_id": null,
            "number_of_videos": 0,
            "thumbnail": ""
        }
    ]
}

03Стварэнне

POST/api/library/
Request (application/json)
{
    "description": "description",
    "has_children": false,
    "is_active": true,
    "name": "ttt",
    "url": "/client/categories/20115/",
    "parent_id": null,
    "thumbnail": ""
}
Response 201 (application/json)
{
    "description": "description",
    "has_children": false,
    "is_active": true,
    "id": 20115,
    "name": "ttt",
    "level": 0,
    "url": "/client/categories/20115/",
    "priority": 0,
    "parent_id": null,
    "number_of_videos": 0,
    "thumbnail": ""
}

04Змяненне

PUT/api/library/{id}/
id
required, numeric, 1 — id катэгорыі
Request (application/json)
{
    "description": "desc2",
    "name": "cat2",
    "parent": 20103
}
Response 201 (application/json)
{
    "description": "desc2",
    "has_children": false,
    "is_active": true,
    "id": 20115,
    "name": "cat2",
    "level": 0,
    "url": "/client/categories/20115/",
    "priority": 0,
    "parent_id": null,
    "number_of_videos": 0,
    "thumbnail": ""
}

05Выдаленне

DELETE/api/library/{id}/
id
required, numeric, 1 — id катэгорыі
Response 204

06Даданне відэа

POST/api/library/{id}/videos/
id
required, numeric, 1 — id катэгорыі
Response 201 (application/json)
{
    video_id:111
}

07Спіс відэа

GET/api/library/{id}/videos/
id
integer
Response 200 (application/json)
{
    "total_count":3064,
    "result":[
        {
            "status":"published",
            "embed_html":"<iframe src='http://127.0.0.1:8000/video/5350456/?playerId=13&amp;partnerId=1'
                width='854'
                height='405'
                frameborder='no'
                scrolling='no'
                webkitAllowFullScreen
                mozallowfullscreen
                allowfullscreen></iframe>",
            "subtitle":null,
            "description":"поп-музыка La Vtornik!",
            "tags":[
                "поп-музыка",
                "La Vtornik",
                "поп"
            ],
            "iframe_url":"http://127.0.0.1:8000/video/5350456/?playerId=13&partnerId=1",
            "show_ad":true,
            "embed_object":"<object class='TviglePlayer'>
                    <param name='id' value='5350456'>
                    <param name='adv_cat_id' value='6'>
                    <param name='partnerId' value='1'>
                    <param name='autoStart' value='true'>
                    <param name='forceFlashObject' value='true'>
                    <param name='wmode' value='opaque'>
                    <param name='playerId' value='13'>
                    <param name='width' value='854'>
                    <param name='height' value=''>
                    <param name='useAPI' value='true'>
                    <param name='autoChangeVideo' value='false'>
                    <!--<param name='api_sign' value='play_token=111&expire=222&key=333'>-->
                    <!--<param name='trace' value='true'>-->
                </object>
                <script language='JavaScript'
                        type='text/javascript'
                        data-hang='false'
                        src='/static/player/player_builder.min.js'></script>",
            "is_active":true,
            "is_playable":true,
            "duration_in_ms":201762,
            "callback_url":null,
            "errors":[],
            "meta":{
                "country_restrictions":[]
            },
            "license": {
                "date_from": "2017-03-20",
                "date_to": "2018-03-20"
            },
            "duration":"3:21",
            "publication_date":"2013-12-28 21:00:00",
            "is_banned":false,
            "freezeFrame":"//127.0.0.1:8000/res/2016/01/11/0f113cb6-ccb7-448d-83b0-32611fb2648f.png",
            "partner_id":1,
            "id":5350456,
            "category":27774,
            "rightholder":18799,
            "country_restrictions":[],
            "name":"Зацепила",
            "publication_start_date":"",
            "age_restrictions":"12+",
            "created_at":"2016-01-11 18:18:20",
            "url":"/client/videos/5350456/",
            "publication_end_date":"",
            "aspect_ratio":null,
            "progress":100,
            "distribution":1,
            "status_display":"опубликован",
            "thumbnail":"//127.0.0.1:8000/res/2016/01/11/18da8e2d-3f87-4bf8-bcc6-c14e917b2738.jpg",
            "resources":[
                {
                    "status":"finished",
                    "errors":[],
                    "format":"flv",
                    "progress":100,
                    "quality":"1080p",
                    "id":9632266
                },
                {
                    "status":"finished",
                    "errors":[],
                    "format":"mp4",
                    "progress":100,
                    "quality":"480p",
                    "id":9632263
                }
            ],
            "tv_id":null
        }
    ]
}

08Выдаленне відэа

DELETE/api/library/{category_id}/videos/{video_id}/
category_id
integer
video_id
integer
Response 204

Праца з кантэнтам, які захоўваецца на баку кліента (self-hosted)

01Даданне відэа

POST/api/videos/
quality
якасць відэа, выкарыстоўваюцца значэнні 240, 360, 480, 720, 1080
URL
адрас відэа, пачынаючы з https://
Request (application/json)
{
    "name":"…",
    "resources":[
        {
            "quality":"240p",
            "url":"https://dl.dropboxusercontent.com/u/589071/H264_test5_voice_mp4_480x360.mp4"
        },
        {
            "quality":"720p",
            "url":"https://dl.dropboxusercontent.com/u/589071/H264_test5_voice_mp4_480x360.mp4"
        }
    ]
}
Response
{
    "status": "queued",
    "embed_html": "<iframe src='http://127.0.0.1:8000/video/5236513/?partnerId=23'
        width='702'
        height='405'
        frameborder='no'
        scrolling='no'
        webkitAllowFullScreen
        mozallowfullscreen
        allowfullscreen></iframe>",
    "subtitle": null,
    "description": "",
    "tags": [],
    "iframe_url": "http://127.0.0.1:8000/video/5236513/?partnerId=23",
    "show_ad": true,
    "embed_object": "<object class='TviglePlayer'>
            <param name='id' value='5236513'>
            <param name='partnerId' value='23'>
            <param name='forceFlashObject' value='true'>
            <param name='width' value='702'>
            <param name='height' value='405'>
            <param name='useAPI' value='true'>
            <param name='autoChangeVideo' value='false'>
        </object>
        <script language='JavaScript'
                type='text/javascript'
                data-hang='false'
                src='/static/player/player_builder.min.js'></script>",
    "is_active": true,
    "is_playable": false,
    "duration_in_ms": null,
    "callback_url": null,
    "errors": [],
    "duration": null,
    "publication_date": null,
    "is_banned": false,
    "freezeFrame": null,
    "partner_id": 23,
    "id": 5236513,
    "category": null,
    "rightholder": 24,
    "country_restrictions": [],
    "name": "megatest",
    "publication_start_date": "",
    "age_restrictions": "0+",
    "created_at": "2014-12-05 11:17:08",
    "url": "/client/videos/5236513/",
    "publication_end_date": "",
    "aspect_ratio": null,
    "progress": 0,
    "distribution": 1,
    "status_display": "в очереди",
    "thumbnail": null,
    "resources":
        [
            {
                "status": "queued",
                "errors": [],
                "format": null,
                "progress": 0,
                "quality": "640p",
                "id": 2913816
            },
            {
                "status": "queued",
                "errors": [],
                "format": null,
                "progress": 0,
                "quality": "240p",
                "id": 2913815
            }
        ],
    "tv_id": null
}

02Даданне прэвʼю

POST/api/videos/{id}/thumbnail/
id
required, integer — id відэа

RSS

01Відэа

GET/api/rss/videos/{?partner_id}
partner_id
integer
Палі паводле спецыфікацыі RSS 2.0 з выкарыстаннем atom:link
Response 200 (application/rss+xml; charset=utf-8)
<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
    <channel>
        <title>Videos for Partner</title>
        <link>http://127.0.0.1:8000</link>
        <description></description>
        <atom:link href="/api/rss/videos/" rel="self"></atom:link>
        <language>ru</language>
        <lastBuildDate>Wed, 13 Apr 2016 12:08:09 -0000</lastBuildDate>
        <item>
            <title>Назва відэа</title>
            <link>http://127.0.0.1:8000/client/videos/id/</link>
            <description>Апісанне відэа</description>
            <pubDate>Wed, 13 Apr 2016 12:08:09 -0000</pubDate>
            <guid>id відэа</guid>
            <category>Катэгорыя відэа</category>
        </item>
    </channel>
</rss>

Метады выдачы відэа

01Публічны метад выдачы відэа

GET/api/public/video/{id}/{?partner_id}
id
required, integer — id відэа
partner_id
required, integer — id пляцоўкі, на якой прайграваецца відэа
Response 200 (application/json)
{
    "video":{
        "description":"Апісанне відэа",
        "title":"Назва відэа",
        "age_restrictions":"18+",
        "id":1,
        "freeze_frame":"//example.com/freeze_frame.png",
        "thumbnail":"//example.com/thumbnail.png",
        "duration":2916002,
        "category_id":1,
        "is_geo_blocked":false,
        "resources":{
            "mp4":{
                "480p":{
                    "link":"//example.com/video_480.mp4",
                    "size":402070623
                },
                "360p":{
                    "link":"//example.com/video_360.mp4",
                    "size":284513502
                }
            },
            "flv":{
                "480p":{
                    "link":"//example.com/video_480.flv",
                    "size":402070623
                },
                "360p":{
                    "link":"//example.com/video_360.flv",
                    "size":284513502
                }
            }
        },
        "owner_id":1
    }
}

Кіраўніцтва карыстальніка Video Publisher Cloud

Асабісты кабінет, загрузка і наладжванне відэа, плэеры, рэклама і статыстыка — поўнае кіраўніцтва ў PDF.

Падтрымка

Задайце сваё пытанне

Адкажам у працоўны час

Пытанні наконт плэера, асабістага кабінета, API і падключэння. Ліст паступае ў тэхнічную падтрымку Video Publisher Cloud.

support@tvigle.ruтэхнічная падтрымка
sales@tvigle.ruпадключэнне, партнёрства, манетызацыя
Кіраўніцтва карыстальнікаасабісты кабінет, загрузка відэа, плэер, рэклама