Changes

Jump to: navigation, search

Engine API/en

2,176 bytes removed, 18:08, 24 December 2012
Incoming commands
<tt>'''HELLOBG'''</tt>
Используется в рамках процедуры Used as a part of "рукопожатияhandshake" между клиентом и procedure between client and TS Engine.
Эта команда должна быть отправлена клиентом сразу после установления This commend must be sent by client right after establishing tcp-соединения с connection with TS Engine.
Соединение с TS Engine считается успешным после того, как клиент получил от TS Engine ответ на "рукопожатие" - команду HELLOTS
<tt>'''READY'''</tt>
Информирует Informs TS Engine о том, что клиент готов принимать исходящие командыthat client is ready to receive outgoing commands
'''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).
Более предпочтительным методом является асинхронная загрузка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 LOADcommand. НапримерFor example, если в торрент-файле всего один видео-файлif there is only one video file in torrent file, то необходимо отправлять индекс then 0index has to be sent.
Если в торренте пять видео-файлов и необходимо начать проигрывание первого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,4have to be sent.
Если нужно проиграть третий файлIf the third file has to be played, и не загружать другиеwithout loading others, отправляется 2has to be sent.
<tt>'''torrent_url'''</tt> - ссылка на торрент файл link to torrent file (напримерfor example, http://sometracker.com/torrent/12345)
<tt>'''torrent_infohash'''</tt> - torrent'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, необходимо передавать 0must be sent)
<tt>'''affiliate_id'''</tt> - код партнера partner's code (если неизвестноif unknown, необходимо передавать 0must be sent)
<tt>'''zone_id'''</tt> - код зоны партнера code of partner's zone (если неизвестноif unknown, необходимо передавать 0must be 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.
'''Параметры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
Данная команда особенно важна, когда идет прогрывание рекламных роликов 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)
'''Параметры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
25 - проиграно 25% видеоof video has been played
50 - проиграно 50% видеоof video has been played
75 - проиграно 75% видеоof video has been played
100 - проиграно 100% видеоof video has been played
== Исходящие команды ==

Navigation menu