Changes

Jump to: navigation, search

Engine API/en

2,176 bytes removed, 15:08, 24 December 2012
→‎Incoming commands
<tt>'''HELLOBG'''</tt>
 
Used as a part of "handshake" procedure between client and TS Engine.
Используется в рамках процедуры "рукопожатия" между клиентом и TS Engine.
 
This commend must be sent by client right after establishing tcp-connection with TS Engine.
Эта команда должна быть отправлена клиентом сразу после установления tcp-соединения с TS Engine.
 
Соединение с TS Engine считается успешным после того, как клиент получил от TS Engine ответ на "рукопожатие" - команду HELLOTS
<tt>'''READY'''</tt>
 
Informs TS Engine that client is ready to receive outgoing commands
Информирует TS Engine о том, что клиент готов принимать исходящие команды
 
 
'''LOADASYNC''' <request_id> '''RAW''' <torrent_data> <developer_id> <affiliate_id> <zone_id></tt>
 
These commands perform loading torrent-file's content. They are used to allow client to get a list of files' names in file of interest. LOAD commands are performed synchronously, LOADASYNC commands - asynchronously (response comes in outgoing command LOADRESP).
Данные команды выполняют загрузку содержимого торрент-файла и используются для того, чтобы клиент мог получить список названий
файлов в интересующем торрент-файле. Команды LOAD выполняются синхронно, команды LOADASYNC - асинхронно (ответ приходит в исходящей команде LOADRESP).
 
Preferred method is asynchronous loading.
Более предпочтительным методом является асинхронная загрузка.
 
'''ПараметрыParameters:'''
 
<tt>'''request_id'''</tt> - случайное целое число - идентификатор запроса LOADASYNC; этот же идентификатор будет отослан клиенту в команде LOADRESP после того,как будет получен список файлов; данный идентификатор служит для того, чтобы клиент в случае отправки нескольких запросов LOAD точно знал, на какой из этих запросов получен ответ
Данные команды используются для начала загрузки определенного файла из торрент-файла либо для начала загрузки файла по прямой ссылке (START URL)
 
'''ПараметрыParameters:'''
 
<tt>'''file_indexes'''</tt> - a list of file's indexes from torrent file, which have to be loaded. Client receives file's indexes in a LOADRESP message, separated by commas. Indexes start with zero and match a list of files that was received by LOAD command. For example, if there is only one video file in torrent file, then 0 index has to be sent.
<tt>'''file_indexes'''</tt> - список индексов файлов из торрент-файла, которые необходимо загружать. Индексы файлов клиент получает в сообщении LOADRESP разделенных запятой. Индексы начинаются с нуля и соответствуют списку файлов,
который был получен в результате выполнения команды LOAD. Например, если в торрент-файле всего один видео-файл, то необходимо отправлять индекс 0.
 
If there are 5 video files in torrent and playback has to start from the first one, but others have to be loaded, then 0,1,2,3,4 have to be sent.
Если в торренте пять видео-файлов и необходимо начать проигрывание первого, но при это загружать остальные, то отправляется 0,1,2,3,4.
 
If the third file has to be played, without loading others, 2 has to be sent.
Если нужно проиграть третий файл, и не загружать другие, отправляется 2.
 
<tt>'''torrent_url'''</tt> - ссылкаlink наto торрентtorrent файлfile (напримерfor example, http://sometracker.com/torrent/12345)
 
<tt>'''torrent_infohash'''</tt> - infohashtorrent's торрентаinfohash
 
<tt>'''player_id'''</tt> - кодplayer's плеераcode
 
<tt>'''torrent_data'''</tt> - содержимое торрентtorrent-файлаfile's content, вencoded кодировкеin base64
 
<tt>'''direct_url'''</tt> - прямаяdirect ссылкаlink наto файлfile (напримерfor example, http://somesite.com/files/video.mp4)
 
<tt>'''developer_id'''</tt> - кодdeveloper's разработчикаcode (еслиif неизвестноunknown, необходимо0 передаватьmust 0be sent)
 
<tt>'''affiliate_id'''</tt> - кодpartner's партнераcode (еслиif неизвестноunknown, необходимо0 передаватьmust 0be sent)
 
<tt>'''zone_id'''</tt> - кодcode зоныof партнераpartner's zone (еслиif неизвестноunknown, необходимо0 передаватьmust 0be sent)
 
 
<tt>'''GETPID''' <infohash> <developer_id> <affiliate_id> <zone_id></tt>
 
Getting code of the player through a set of parameters. This command is a synchronous command (see below). In response player's code or empty string (if player's code can't be received) is sent.
Получение кода плеера по набору параметров. Эта команда является синхронной командой (см.ниже). В ответ отправляется код плеера, либо пустая строка, если код плеера не может быть получен
 
 
<tt>'''SHUTDOWN'''</tt>
 
Close connection with client.
Закрыть соединение с клиентом.
 
 
<tt>'''STOP'''</tt>
 
Stop loading file that is being loaded at this moment.
Остановить загрузку файла, который загружается в данный момент.
 
 
<tt>'''DUR''' <video_url> <duration></tt>
 
Inform TS Engine about duration of video file that is being played by client at this moment. This command must be sent right after client had determined content duration.
Сообщить TS Engine о длительности видео-файла, который в данный момент проигрывается клиентом.
Данная команда должна отправлять сразу после того, как клиент определил длительность контента.
 
'''ПараметрыParameters:'''
 
<tt>'''video_url'''</tt> - ссылкаlink наto видеоvideo, котораяwhich былаwas отправленаsent клиентуto послеclient окончанияafter пребуферизацииthe end of pre-buffering
 
<tt>'''duration'''</tt> - длительностьduration вin миллисекундахmilliseconds
 
 
<tt>'''PLAYBACK''' <video_url> <event></tt>
 
Inform TS Engine about percentage of played video
Сообщить TS Engine о процентном соотношении проигранного видео
 
This command is especially important when playing advertising video - transition to the main video happens only after TS Engine gets command PLAYBACK 100 (after client has played advertising video till the end)
Данная команда особенно важна, когда идет прогрывание рекламных роликов - переход к основному видео происходит только после того,
как TS Engine получил команду PLAYBACK 100 (т.е. после того, как клиент полность проиграл рекламный ролик)
 
'''ПараметрыParameters:'''
 
<tt>'''video_url'''</tt> - ссылкаlink наto видеоvideo, котораяwhich былаwas отправленаsent клиентуto послеclient окончанияafter пребуферизацииthe end of pre-buffering
 
<tt>'''event'''</tt> - одноone изof данныхthese событийevents:
 
0 - starting playback
0 - начало проигрывания
 
25 - 25% of video has been played
25 - проиграно 25% видео
 
50 - 50% of video has been played
50 - проиграно 50% видео
 
75 - 75% of video has been played
75 - проиграно 75% видео
 
100 - проиграно 100% видеоof video has been played
 
== Исходящие команды ==
Retrieved from "https://wiki.acestream.media/Special:MobileDiff/81"

Navigation menu