Changes

Jump to: navigation, search

Engine API/en

1,867 bytes removed, 13:00, 26 December 2012
Исходящие команды
100 - 100% of video has been played
== Исходящие команды Outgoing commands ==
<tt>'''HELLOTS'''</tt>
ответная команда в рамках процедуры рукопожатияresponse command as a part of handshake procedure
<tt>'''AUTH''' <auth_level></tt>
Уровень доступа пользователяUser's access level
<tt>auth_level</tt> - целое число integer - уровень доступаaccess level
На данный момент возможны два значения уровня доступаAt this moment two values of access level are available:
0 - пользователю не доступны расширенные функции advanced features are not available for user (перемотка и проигрывание файлов из торрента с несколькими видео-файламиrewind and playback of torrent files with several video files)
1 - пользователю доступны расширенные функцииadvanced features are available for user
<tt>'''STATE''' <state_id></tt>
Информация о текущем статусе Information about current state of TS Engine
<tt>'''SHUTDOWN'''</tt>
TS Engine завершил работуfinished its work
<tt>'''PLAYADI''' <video_url></tt>
Начать проигрывание видео по ссылке Start playing video by video_url link (данная ссылка ведет на this link leads to http-серверserver, встроенный в embedded in TS Engine).
<tt>'''PLAY'''</tt> - проигрывание основного видеоplayback of the main video
<tt>'''PLAYAD'''</tt> - проигрывание непрерываемого рекламного ролика playback of uninterrupted advertising video (пользователь не может перемотать либо пропустить данный рекламный роликuser can't rewind or skip this advertising video)
<tt>'''PLAYADI'''</tt> - проигрывание прерываемого рекламного ролика playback of interrupted advertising video (пользователь может перемотать либо пропустить данный рекламный роликuser can rewind or skip this advertising video)
<tt>'''PAUSE'''</tt>
TS Engine начал буферизациюbegan buffering, так как недостаточно данных для проигрывания видео без остановкиbecause there's not enough data for video playback without interruptions
<tt>'''RESUME'''</tt>
TS Engine завершил буферизациюfinished buffering
<tt>'''LOADRESP''' <request_id> <response></tt>
Ответ на команду Response to LOADcommand
<tt>'''request_id'''</tt> - идентификатор запросаrequest identifier
<tt>'''response'''</tt> - список файлов в формате a list of files in json в такого видаformat in this form:
{
"status": 1,
}
<tt>'''status'''</tt> - 0: в торренте нет видео файловthere are no video files in torrent, 1 - в торренте один видео файлthere is one video file in torrent, 2 - в торренте более одного видео файлаthere are more than one video files in torrent
<tt>'''infohash'''</tt> - torrent infohash торрента
<tt>'''files'''</tt> - список файловa list of files; это массивthis is an array, каждый элемент в котором состоит из массива из двух элементовeach element of which consists of an array with two elements: первый the first - название файлаfile's name, второй the second - позиция файла в торренте file's position in torrent (эта позиция должна отправляться в команде this position must be sent inside START для указанияcommand to specify which file to download, какой именно файл необходимо загружать, если их несколькоif there are several of them).
Имена файлов передаются в кодировке Files' names are transferred in UTF-8 в encoding in urlencoded видеform.
<tt>'''INFO''' <message_id>;<message_text></tt>
Информационное сообщениеInfo message
<tt>'''message_id'''</tt> - код сообщенияmessage code
<tt>'''message_text'''</tt> - текст сообщенияmessage text
<tt>'''STATUS''' <status_string></tt>
Данное сообщение отправляется периодически для информирования клиента о текущем статусе загрузки контентаThis message is sent periodically to inform client about current state of content download.
<tt>'''status_string'''</tt> - строка описанного ниже форматаstring in format described below
Если идет проигрывание основного контентаIf the main content is being played:
<tt>STATUS main:status_string</tt>
Если идет проигрывание рекламного роликаIf advertising video is being played:
<tt>STATUS main:status_string|ad:status_string</tt>
<tt>'''status_string:'''</tt>
TS Engine ничего не делает does nothing - <tt>'''idle'''</tt>
ошибка error - <tt>'''err;error_id;error_message'''</tt> (код и описаниеcode and description)
проверка checking - <tt>'''check;progress'''</tt>
пребуферизация prebuffering - <tt>'''prebuf;progress;time'''</tt>
закачка download - <tt>'''dl'''</tt>
буферизация buffering - <tt>'''buf;progress;time'''</tt>
ожидание достаточной скорости waiting for sufficient speed - <tt>'''wait;time'''</tt>
Ко всем Common data is added to all <tt>status_string</tt> (кроме except <tt>idle, err, check</tt>) добавляются общие данные:
<tt>total_progress;immediate_progress;speed_down;http_speed_down;speed_up;peers;http_peers;downloaded;http_downloaded;uploaded</tt>
<tt>'''total_progress'''</tt> - сколько всего закачано по данному файлуhow much of this file is downloaded
<tt>'''immediate_progress'''</tt> - сколько непрерывных данных закачано начиная с текущей позиции how much uninterruptible data is downloaded starting from the current position (для отображения кол-ва закачанного в бегункеto show amount of downloaded data)
Все числа передаются как All numbers are sent as integer.
Все All progress принимают значение от takes values from 0 до to 100.
'''ПримерыExamples:'''
<tt>STATUS main:prebuf;45;30|ad:buf;69
STATUS main:dl|ad:dl</tt>
'''Пример трансформация статусов в текстовые сообщения, понятные пользователюExample of tranformation statuses into text messages that user can understand:'''
<tt>check - Checking xx%
buf - Buffering xx%
wait - Waiting sufficient download speed
err - выводим сообщение об ошибкеshowing an error message dl, idle - ничего не выводимdoing nothing</tt>
== Events ==

Navigation menu