Contents
Общие понятия
ACE Stream Engine (далее - "движок") - приложение, которое обеспечивает весь функционал системы ACE Stream. Данное приложение работает в фоновом режиме и имеет минимальный графический интерфейс для
изменения различных настроек.
ACE Stream Engine API (далее - API) - программный интерфейс, позволяющий сторонним приложениям работать с движком. Под сторонними приложениями, как правило, подразумеваются медиа плееры, работающе
с системой ACE Stream.
Клиент - стороннее приложение, которое работает с движком посредством API.
Схема работы API
Обмен данными с движком происходит по протоколу TCP. Общая схема работы выглядит так:
- клиент устанавливает TCP-соединение с движком
- клиент и движок обмениваются рукопожатиями
- клиент и движок обмениваются сообщениями
- одна из сторон завершает соединение
Установление соединения
Для установления соединения клиент должен знать порт, на котором работает API движка. Методы определения порта зависят от операционной системы, на которой запущен движок.
На Linux используется фиксированный порт: 62062
На Windows используется динамический порт. Движок после запуска создает файл acestream.port в директории, в которой находится сам движок (файл tsengine.exe), и записывает в данный файл порт, на
котором работает API. Для того, чтобы узнать порт, клиент должен прочитать указанный файл. Отсутствие данного файла указывает на то, что движок в не запущен. Путь к папке, в которую устанавливается
движок, можно считать из реестра:
HKEY_CURRENT_USER\Software\TorrentStream\EnginePath
Ключ EnginePath содержит абсолютный путь к исполняемому файлу движка (tsengine.exe). По умолчанию это %APPDATA%\TorrentStream\engine\tsengine.exe
Алгоритм установления соединения (Windows):
- считать из реестра ключ HKEY_CURRENT_USER\Software\TorrentStream\EnginePath
- если ключ отсутствует - движок не установлен
- запомнить путь к исполняемому файлу движка (engine_path) и директории движка (engine_dir)
- считать содержимое файла engine_dir/acestream.port и запомнить порт
- если данный файл отсутствует - запустить движок, дождаться создания файла acestream.port и считать его содержимое
- установить TCP-соединение на localhost на указанный порт
- если не получилось установить соединение - движок не запущен и его нужно запустить
- обменяться рукопожатием и начать обмен сообщениями
Алгоритм установления соединения (Linux):
- установить TCP-соединение на localhost на порт 62062
- если не получилось установить соединение - движок не запущен и его нужно запустить (/usr/bin/acestreamengine-client-gtk)
- обменяться рукопожатием и начать обмен сообщениями
Рукопожатие
После установления соединения клиент и движок должны обменяться рукопожатием:
- клиент отсылает сообщение
HELLOBG version=<api_version>
- движок отсылает в ответ
HELLOTS version=<engine_version>
Каждое сообщение должна завершаться символами перевода строки CRLF (\r\n)
- <api_version>
- версия API, которую поддерживает клиент. Этот параметр служит для поддержки обратной совместимости новых версий движка со старыми клиентами. Текущая версия API - 3. Если клиент не указал версию,
по умолчанию используется версия 1. Для всех сообщений API в документации указано, начиная с какой версии они поддерживаются.
- <engine_version>
- версия движка (например, 2.0.8)
Если клиент в течение некоторого времени после отправки рукопожатия не получил ответ, соединение необходимо завершить.
Обмен сообщениями
Каждое сообщение представляет собой ASCII-строку, которая завершается символами перевода строки CRLF (\r\n)
Примерный алгоритм приема сообщений выглядит таким образом:
- клиент в цикле ждет поступления данных по TCP-соединению
- при получении данных они добавляются в буфер
- клиент проверяет, есть ли в буфере символы CRLF. Если есть, то из буфера вырезается сообщение (строка от начала буфера до символов CRLF) и отправляется в обработчик сообщений
- клиент должен учитывать возможность получения нескольких сообщений одновременно (т.е. повторять предыдущий шаг, пока в буфере не будет символов CRLF)
===Завершение соединения Движок при завершении работы отправляет команду SHUTDOWN и закрывает сокет. При получении данной команды клиент должен прекратить обработку команд и закрыть свой сокет.
То же самое должен делаь клиент при закрытии - перед закрытием отослать движку команду SHUTDOWN
Сообщения
Типы сообщений
Все сообщения условно делятся на две группы: команды и события.
Команды подразумевают выполнение какого-либо действия от принимающей стороны. Например, командой START клиент просит движок начать пребуферизацию указанного контента.
События носят информационный характер. Например, событие STATUS информирует клиента о статусе загрузки (идет ли в данный момент пребуферизация, буферизация, какая скорость загрузки и т.д.)
Синхронные команды
Практически все команды являются асинхронными, т.е. не предполагают наличие ответа от другой стороны.
Исключением являются две команды:
- LOAD (сихронная загрузка информации о потоке)
- GETCID (получение Content ID для потока)
Для этих команд есть понятие ответа на команду. Ответ передается в виде строки, которая начинается на ##.
Алгоритм обработки синхронных команд такой:
- клиент отправляет движку синхронную команду (например, GETCID 4c78e1cf0df23b4f5a16a106829ebed710cb52e0 0 0 0) и ждет данных от движка
- когда от движка приходят данные, клиент проверяет, начинается ли полученный ответ на ## (например, ##36ae4c89ab45b4010b1461c513da38d007356195)
- если это так, то строка от символов ## до CRLF является ответом на синхронную команду (причем ответ может быть пустой, т.е. выглядеть так: ##)
- если нет, значит ответ на команду не может быть получен
Мы не рекомендуем использовать синхронную команду LOAD, так как она подразумевает блокирование потока на стороне клиента. Эта команда является устаревшей и вместо нее следует использовать
асинхронную версию LOADASYNC
Ответ на команду GETCID приходит практически мгновенно, поэтому ее использование не приводит к блокированию. Однако есть одно замечание по использованию данной команды:
Команду GETCID не следует отправлять, если движок находится в состоянии starting
Список сообщений
В примерах сообщения от клиента к движку отмечены >>, от движка к клиенту - <<
Команды от клиента к движку
READY
- Версия API
- >= 1
- Описание
- Информирует движок о том, что клиент готов принимать команды. Это должна быть первая команда после рукопожатия.
- Синтаксис
READY
- Параметры
- нет
- Пример
>>READY
LOADASYNC
- Версия API
- >= 1
- Описание
- Получить описание контента по идентификатору. Идентификатором может быть content id, ссылка на транспортный файл (.torrent, .acelive), инфохеш транспортного файла и т.п. Описание представляет
собой список названий файлов либо потоков, которые содержатся в транспортном файле. Основное назначение этой команды - возможность сформировать и показать пользователю плейлист.
- Синтаксис
LOADASYNC request_id TORRENT url developer_id affiliate_id zone_id LOADASYNC request_id INFOHASH infohash developer_id affiliate_id zone_id LOADASYNC request_id RAW data developer_id affiliate_id zone_id LOADASYNC request_id PID content_id
- Параметры
- request_id: случайное целое число - идентификатор запроса LOADASYNC; этот же идентификатор будет отослан клиенту в команде LOADRESP после того,как будет получен список файлов; данный
идентификатор служит для того, чтобы клиент в случае отправки нескольких запросов LOADASYNC точно знал, на какой из этих запросов получен ответ
- url: ссылка на транспортный файл
- infohash: инфохеш транспортного файла
- data: содержимое транспортного файла в кодировке base64
- content_id: идентификатор контента в системе ACE Stream (Content ID)
- developer_id: код разработчика (если неизвестно, необходимо передавать 0)
- affiliate_id: код партнера (если неизвестно, необходимо передавать 0)
- zone_id: код зоны партнера (если неизвестно, необходимо передавать 0)
- Формат ответа
- Ответ приходит в формате JSON со следующими полями:
- status:
- 0 - транспортный файл не содержит аудио/видео файлов
- 1 - транспортный файл содержит один аудио/видео файл
- 2 - транспортный файл содержит более одного аудио/видео файла
- 100 - ошибка получения данных
- files: список файлов/потоков; это массив, каждый элемент в котором состоит из массива из двух элементов: первый - название файла, второй - позиция в транспортном файле (эта позиция
должна отправляться в команде START для указания, какой именно файл необходимо загружать, если их несколько)
- infohash: инфохеш транспортного файла
- checksum: хешсумма транспортного файла
- Параметры infohash и checksum клиенту нужны для того, чтобы в дальнейшем получить Content ID с помощью команды GETCID
- Названия файлов возвращаются в виде urlencoded строк в кодировке UTF-8
- Пример
Загрузить контент по Content ID: >>LOADASYNC 126500 PID 1ccf192064ee2d95e91a79f91c6097273d582827 В ответ клиент получает от движка: <<LOADRESP 126500 { "status": 1, "files": [["sintel-1024-surround.mp4", 0]], "infohash": "5410b27fc567c35c8547e3b69b141215ce3a1fd7", "checksum": "504275dd71a32d51c63c45ced37807751f5ccfa2" }
START
- Версия API
- >= 1
- Описание
- Начать проигрывание указанного контента
- Синтаксис
START TORRENT url file_indexes developer_id affiliate_id zone_id stream_id START INFOHASH infohash file_indexes developer_id affiliate_id zone_id START PID content_id file_indexes START RAW data file_indexes developer_id affiliate_id zone_id START URL direct_url file_indexes developer_id affiliate_id zone_id START EFILE efile_url
- Параметры
- url: ссылка на транспортный файл
- infohash: инфохеш транспортного файла
- content_id: идентификатор контента в системе ACE Stream (Content ID)
- data: содержимое транспортного файла в кодировке base64
- direct_url: прямая http-ссылка на контент (для проигрывания без транспортного файла)
- efile_url: ссылка на acemedia-файл (зашифрованный медиа-файл, который можно воспроизвести с помощью ПО ACE Stream)
- file_indexes: список индексов файлов из торрент-файла, которые необходимо загружать. Индексы файлов клиент получает в сообщении LOADRESP разделенных запятой. Индексы начинаются с нуля и соответствуют списку файлов, который был получен в результате выполнения команды LOAD. Например, если в торрент-файле всего один видео-файл, то необходимо отправлять индекс 0.
- developer_id: код разработчика (если неизвестно, необходимо передавать 0)
- affiliate_id: код партнера (если неизвестно, необходимо передавать 0)
- zone_id: код зоны партнера (если неизвестно, необходимо передавать 0)
- stream_id: номер потока для multi-stream файлов (значение клиент получает из сообщения LOADRESP)
Если необходимо в параметрах передать ссылку на файл, который находится в локальной файловой системе, следует использовать формат file:///path/to/file.
- Примеры
Начать проигрывание по ссылке на транспортный файл: >>START TORRENT http://rutor.org/download/67346 0 0 0 0 Начать проигрывание по Content ID: START PID 1ccf192064ee2d95e91a79f91c6097273d582827 0 Начать проигрывание acemedia-файла c:\acestream\test.acemedia: START EFILE file%3A%2F%2F%2Fc%3A%5Cacestream%5Ctest.acemedia
STOP
- Версия API
- >= 1
- Описание
- Остановить воспроизведение и загрузку
- Синтаксис
STOP
- Параметры
- нет
- Пример
>>STOP
GETPID
- Версия API
- 1
Эта команда устарела и больше не используется. Вместо нее следует использовать команду GETCID
GETCID
- Версия API
- >= 2
- Описание
- Получение кода плеера по набору параметров. Эта команда является синхронной командой (см.ниже). В ответ отправляется код плеера, либо пустая строка, если код плеера не может быть получен
- Синтаксис
GETCID checksum=checksum infohash=infohash developer=developer_id affiliate=affiliate_id zone=zone_id
- Параметры
- checksum: хешсумма транспортного файла (значение клиент из команды LOADRESP)
- infohash: инфохеш транспортного файла (значение клиент из команды LOADRESP)
- developer_id: код разработчика (если неизвестно, необходимо передавать 0 либо не передавать данный параметр)
- affiliate_id: код партнера (если неизвестно, необходимо передавать 0 либо не передавать данный параметр)
- zone_id: код зоны партнера (если неизвестно, необходимо передавать 0 либо не передавать данный параметр)
- Пример
>>GETCID infohash=bc57456ca38b365477e07fa7e912693a7adc57da checksum=888e9891f82a045ea639256b468041fb8c9ac315 developer=0 affiliate=0 zone=0 <<##68dba76ad7d0b9992581bf72f7835a0de4f84234
GETADURL
- Версия API
- >= 3
- Описание
- Запрос к движку на получение ссылки на рекламную страницу. Данную команду могут использовать клиенты, которые имеют возможность отображать встроенный браузер в плеере, для того, чтобы показывать пользователям рекламу перед началом проигрывания контента либо когда пользователь нажимает паузу. Если движок определит, что есть доступная к показу реклама, то после получения этой команды отправит клиенту событие EVENT showurl
- Синтаксис
GETADURL width=width height=height infohash=infohash action=action
- Параметры
- width: ширина видео окна клиента (в пикселях)
- height: высота видео окна клиента (в пикселях)
- infohash: infohash текущего контента (значение клиент получает из сообщения LOADRESP)
- action: описание события, возможные значения:
- load - загрузка (клиент загрузился, готов к проигрыванию, но пользователь еще не начала проигрывание)
- pause - пользователь нажал паузу
- Примеры
>>GETADURL width=1328 height=474 infohash=5410b27fc567c35c8547e3b69b141215ce3a1fd7 action=load >>GETADURL width=1328 height=474 infohash=5410b27fc567c35c8547e3b69b141215ce3a1fd7 action=pause
USERDATA
- Версия API
- >= 3
- Описание
- Данная команда используется для передачи движку информации о пользователе. Информация передается в формате JSON.
- Синтаксис
USERDATA [{"gender": gender_id}, {"age": age_id}]
- Параметры
- gender_id: пол пользователя. Возможные значения:
- 1 - мужчина
- 2 - женщина
- age_id: возрастная группа пользователя. Возможные значения:
- 1 - младше 13 лет
- 2 - 13-17
- 3 - 18-24
- 4 - 25-34
- 5 - 35-44
- 6 - 45-54
- 7 - 55-64
- 8 - старше 64
- Пример
мужчина, от 18 до 24 лет: >>USERDATA [{"gender": 1}, {"age": 3}]
SAVE
- Версия API
- >= 2
- Описание
- Сохранить контент в указанном месте.
- Синтаксис
SAVE infohash=infohash index=index path=path
- Параметры
- infohash - infohash контента, который неободимо сохранить (значение клиент получает из сообщения EVENT cansave)
- index - индекс файла, который необходимо сохранить (значение клиент получает из сообщения EVENT cansave)
- path - абсолютный путь к файлу, в который необходимо сохранить контент. Если указанный файл не существует, он будет создан. Если существует, файл будет перезаписан. Путь должен передаваться в виде urlencoded строки в кодировке UTF-8.
- Пример
Сохранить файл с индексом 0 в папку d:\media под названием sintel-1024-surround.mp4 >>SAVE infohash=5410b27fc567c35c8547e3b69b141215ce3a1fd7 index=0 path=D%3A%2Fmedia%2Fsintel-1024-surround.mp4
LIVESEEK
Описание скоро будет
SHUTDOWN
- Версия API
- >= 1
- Описание
- Клиент завершил работу
- Синтаксис
SHUTDOWN
- Параметры
- нет
- Пример
>>SHUTDOWN
Команды от движка к клиенту
PLAY, PLAYAD, PLAYADI
- Версия API
- 1
Эти команды устарели и больше не используется. Вместо них следует использовать команду START
START
- Версия API
- >= 2
- Описание
- Начать прогрывание контента. Эта команда отправляется после завершения пребуферизации. Движок отсылает плееру http-ссылку, по которой плеер может начать проигрывание контента. Данная ссылка
обрабатывается http-серверов, встроенным в движок.
- Синтаксис
START url [ad=1 [interruptable=1]] [stream=1] [pos=position]
- Параметры
- url: ссылка для проигрывания
- ad=1: флаг, указывающий на то, что ссылка url ведет на рекламный видеоролик, который клиент должен проиграть перед началом воспроизведения основного контента
- interruptable=1: флаг, указывающий на то, что должен проиграться прерываемый рекламный ролик
- stream=1: флаг, указывающий на то, что проигрываемый контент является живой трансляцией (Live Stream).
- position: целое число от 0 до 100, которое указывает с какой позиции клиент должен начать проигрывание (например, position=50 означает, что клиент должен начать проигрывание с
позиции 50%, т.е. с середины контента)
- Примеры
Начать проигрывание контента по указанной ссылке: <<START http://127.0.0.1:6878/content/5410b27fc567c35c8547e3b69b141215ce3a1fd7/0.628180567194 Начать проигрывание непрерываемого рекламного ролика: <<START http://127.0.0.1:6878/content/6081f31fe7f1db2ea7183686b46ba382820df574/0.456623456572 ad=1 Начать проигрывание прерываемого рекламного ролика: <<START http://127.0.0.1:6878/content/6081f31fe7f1db2ea7183686b46ba382820df574/0.456623456572 ad=1 interruptable=1 Начать проигрывание live: <<START http://127.0.0.1:6878/content/553b7d4cfec8974752d386844cb67e0ee64eae05/0.728180367195 stream=1 Начать проигрывание с середины (50%): <<START http://127.0.0.1:6878/content/5410b27fc567c35c8547e3b69b141215ce3a1fd7/0.828180567196 pos=50
PAUSE
- Версия API
- >= 1
- Описание
- Движок начал буферизацию, клиент по возможности должен остановиться на паузу до получения команды RESUME
- Синтаксис
PAUSE
- Параметры
- нет
- Пример
<<PAUSE
RESUME
- Версия API
- >= 1
- Описание
- Движок завершил буферизацию, клиент может продолжить воспроизведение.
- Синтаксис
RESUME
- Параметры
- нет
- Пример
<<RESUME
STOP
- Версия API
- >= 1
- Описание
- Клиент должен остановить воспроизведение контента
- Синтаксис
STOP
- Параметры
- нет
- Пример
<<STOP
SHUTDOWN
- Версия API
- >= 1
- Описание
- Движок завершил работу
- Синтаксис
SHUTDOWN
- Параметры
- нет
- Пример
<<SHUTDOWN
События от клиента к движку
DUR
- Версия API
- >= 1
- Описание
- Сообщить движку о длительности контента, который в данный момент проигрывается клиентом. Данная команда должна отправлять сразу после того, как клиент определил длительность контента.
- Синтаксис
DUR video_url duration
- Параметры
- video_url: ссылка на видео, которая была отправлена клиенту после окончания пребуферизации в команде START
- duration: длительность в миллисекундах
- Пример
Клиент определить длительность контента: 3780 секунд: >>DUR http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 3780000
PLAYBACK
- Версия API
- >= 1
- Описание
- Сообщить движку о прогрессе проигранного контента (сколько процентов проигралось).
- Данная команда особенно важна, когда идет прогрывание рекламных роликов - переход к основному контенту происходит только после того, как движок получил команду PLAYBACK 100 (т.е. после того, как
клиент полность проиграл рекламный ролик)
- Синтаксис
PLAYBACK video_url event
- Параметры
- video_url: ссылка на видео, которая была отправлена клиенту после окончания пребуферизации в команде START
- event: одно из указанных событий:
- 0: начало проигрывания
- 25: проиграно 25% видео
- 50: проиграно 50% видео
- 75: проиграно 75% видео
- 100: проиграно 100% видео (воспроизведение завершено)
- Пример
>>PLAYBACK http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 0 >>PLAYBACK http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 25 >>PLAYBACK http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 50 >>PLAYBACK http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 75 >>PLAYBACK http://127.0.0.1:6878/content/5b5ba8c462f4014d8b57377c97d2e13caee52cdd/0.685119063624 100
EVENT
- Версия API
- >= 3
- Описание
- Отправка событий движку. С помощью этого сообщения клиент может отправлять движку события, касающиеся действий пользователя относительно воспроизведения контента (поставил на паузу, перемотал и т.п.)
- Синтаксис
EVENT event_name [param1=value1 [param2=value2] ...]
- Параметры
- event_name: название события. Возможные значения:
- play - начало воспроизведения либо продолжение после паузы
- pause - пользователь поставил воспроизведение на паузу
- stop - остановка воспроизведения
- seek - пользователь осуществил перемотку. Для этого события необходимо отправлять параметр position, в котором указывается позиция в секундах
- Примеры
>>EVENT play >>EVENT pause >>EVENT seek position=1487 >>EVENT stop
События от движка к клиенту
STATE
- Версия API
- >= 1
- Описание
- Информация о текущем статусе движка
- Синтаксис
STATE state_id
- Параметры
- state_id: состояние движка:
- 0 (IDLE) - движок ничего не делает
- 1 (PREBUFFERING) - началась пребуферизация
- 2 (DOWNLOADING) - идет загрузка контента в обычном режиме
- 3 (BUFFERING) - началась буферизация
- 4 (COMPLETED) - загрузка контента завершена
- 5 (CHECKING) - выполняется инициализация перед началом загрузки
- 6 (ERROR) - ошибка
- Пример
<<STATE 0
INFO
- Версия API
- >= 1
- Описание
- Отобразить текстовое сообщение пользователю.
- Синтаксис
INFO message_id;message_text
- Параметры
- message_id: числовой идентификатор сообщения
- 1: сообщение "На данный момент нет активных пиров" (отправляется в том случае, если в течение минуты после начала загрузки не удалось найти ни одного пира)
- 2: сообщение "Рекламный блок" (отправляется после начала воспроизведения рекламного ролика).
- 3: сообщение "Основной контент" (отправляется после начала воспроизведения основного контента).
- 0: другое сообщение (текст сообщения берется из параметра message_text)
- message_text: текст сообщения, которое необходимо отобразить
- Пример
<<MESSAGE 1;Cannot find active peers <<MESSAGE 2;Advertising video <<MESSAGE 3;Main content <<MESSAGE 0;Display some message
STATUS
- Версия API
- >= 1
- Описание
- Данное сообщение отправляется периодически для информирования клиента о текущем статусе загрузки контента. Основное назначение этого сообщение - дать клиенту возможность отображать пользователю о том, что сейчас происходит на движке.
- Синтаксис
STATUS status_string
- Параметры
- status_string - строка описанного ниже формата
Если идет проигрывание основного контента
STATUS main:status_description
Если идет проигрывание рекламного ролика (рекламный ролик и основной контент описываются отдельно; например, рекламный ролик уже полность загружен, а основной контент проходит стадию пребуферизации):
STATUS main:status_description|ad:status_description
- Возможные значения status_description:
- движок ничего не делает - idle
- движок загружает транспортный файл (обрабатывает команду LOADASYNC) - loading
- движок выполняет предварительную инициализацию воспроизведения (движок переходит в это состояние после получения команды START от клиента) - starting
- ошибка - err;error_id;error_message (код и описание)
- проверка - check;progress
- пребуферизация - prebuf;progress;time
- контент загружается либо уже полностью загружен - dl
- буферизация - buf;progress;time
- ожидание достаточной скорости - wait;time
Ко всем status_string (кроме idle, loading, starting, err, check) добавляются общие данные:
total_progress;immediate_progress;speed_down;http_speed_down;speed_up;peers;http_peers;downloaded;http_downloaded;uploaded
- total_progress - сколько всего закачано по данному файлу
- immediate_progress - сколько непрерывных данных закачано начиная с текущей позиции (для отображения кол-ва закачанного в бегунке)
- speed_down - скорость загрузки (Кбайт/с)
- http_speed_down - скорость загрузки от прямых http-источников (Кбайт/с)
- speed_up - скороть отдачи (Кбайт/с)
- peers - количество подсоединенных пиров
- http_peers - количество подсоединенных прямых http-источников
- downloaded - объем загруженных данных (байт)
- http_downloaded - объем загруженных по http данных (байт)
- uploaded - объем отданных данных (байт)
Все числа передаются как integer.
Все progress принимают значение от 0 до 100.
- Примеры
Движок ничего не делает: <<STATUS main:idle Загружается транспортный файл: <<STATUS main:loading Инициализация воспроизведения: <<STATUS main:starting Пребуферизация 0%, еще нет подсоединенных пиров: <<STATUS main:prebuf;0;2147483648;0;0;0;0;0;0;0;0;0;0; Пребуферизация 20%, скорость загрузки 328 Кбайт/с, подсоединено 7 пиров, загружено 5505024 байт: <<STATUS main:prebuf;20;2723;0;0;328;0;0;7;0;5505024;0;0 Пребуферизация 90%, скорость загрузки 420 Кбайт/с, подсоединено 9 пиров, загружено 11659264байт: <<STATUS main:prebuf;90;3299;1;0;420;0;0;9;0;11659264;0;0 Идет загрузка контента, загружен 1%, скорость загрузки 442 Кбайт/с, подсоединено 10 пиров, загружено 13920256: <<STATUS main:dl;1;0;442;0;0;10;0;13920256;0;0 Рекламный ролик полность загружен и воспроизводится, основной контент пребуферизируется (20%): <<STATUS main:prebuf;20;2723;0;0;328;0;0;7;0;5505024;0;0|ad:dl;100;0;0;0;0;0;0;13920256;0;0
- Пример трансформации статусов в текстовые сообщения, понятные пользователю
check - Проверка xx% prebuf - Пребуферизация xx% buf - Буферизация xx% wait - Ожидание достаточной скорости err - выводим сообщение об ошибке loading - Загрузка... starting - Запуск... dl, idle - ничего не выводим
AUTH
- Версия API
- >= 1
- Описание
- Уровень доступа пользователя
- Синтаксис
AUTH user_auth_level
- Параметры
- user_auth_level: уровень доступа пользователя
- Пример
Пользователь не зарегистрирован: <<AUTH 0 Пользователь зарегистрирован: <<AUTH 1
EVENT
Описание скоро будет
Примеры
>> - сообщения от клиента к движку
<< - сообщения от движка к клиенту
1) Проигрывание торрент-файла по ссылке без рекламных роликов (необходимость проигрывания рекламных роликов определяет движок).
Для загрузки содержимого торрента используется асинхронная команда LOADASYNC.
Торрент файл содержит один видео-файл.
рукопожатие
>>HELLOBG <<HELLOTS
клиент готов принимать сообщения
>>READY
пользователю доступны расширенные функции
<<AUTH 1
загрузить торрент по ссылке
>>LOADASYNC 467763 TORRENT http://rutor.org/download/67346 0 0 0 <<LOADRESP 467763 {"status": 1, "files": [["Prey%202_%20E3%202011%20Official%20Trailer_2.mp4", 0]], "infohash": "4c78e1cf0df23b4f5a16a106829ebed710cb52e0"}
узнать код плеера (например, чтобы показать его пользователю)
>>GETPID 4c78e1cf0df23b4f5a16a106829ebed710cb52e0 0 0 0 <<##36ae4c89ab45b4010b1461c513da38d007356195
начать пребуферизацию видео
>>START TORRENT http://rutor.org/download/67346 0 0 0 0
идет процесс пребуферизации
<<STATE 1 <<STATUS main:prebuf;0;2147483447;0;0;0;0;0;0;0;0;0;0 <<STATUS main:prebuf;0;2132;0;0;29;0;0;8;0;131072;0;0 <<STATUS main:prebuf;8;942;0;0;60;0;0;9;0;393216;0;0 <<STATUS main:prebuf;50;591;0;0;87;0;0;8;0;835584;0;0 <<STATUS main:prebuf;75;497;0;0;98;0;0;8;0;1146880;0;0 <<STATUS main:prebuf;91;448;0;0;105;0;0;8;0;1441792;0;0
пребуферизация завершена, клиент получает ссылку для проигрывания контента
<<PLAY http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 <<STATE 2
клиент отправляет длительность контента (~201 секунда)
>>DUR http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 201964
клиент информирует о том, что началось проигрывание
>>PLAYBACK http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 0
движок загружает контент
<<STATUS main:dl;0;0;110;0;0;8;0;1622016;0;0 <<STATUS main:dl;0;0;128;0;0;8;0;2965504;0;0 <<STATUS main:dl;0;0;130;0;0;8;0;3129344;0;0
движку недостаточно данных для проигрывания, начинает буферизация
<<PAUSE <<STATE 3 <<STATUS main:buf;0;315;0;0;130;0;0;8;0;3260416;0;0 <<STATUS main:buf;90;299;0;0;133;0;0;8;0;3866624;0;0 <<STATUS main:buf;90;278;0;0;138;0;0;8;0;4390912;0;0
буферизация завершена
<<RESUME <<STATE 2 <<STATUS main:dl;0;0;141;0;0;8;0;4898816;0;0
клиент проиграл 25% контента
>>PLAYBACK http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 25 <<STATUS main:dl;0;0;141;0;0;8;0;4898816;0;0 <<STATUS main:dl;0;0;146;0;0;7;0;8388608;0;0
клиент проиграл 50% контента
>>PLAYBACK http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 50 <<STATUS main:dl;0;0;145;0;0;7;0;9404416;0;0
клиент проиграл 75% контента
>>PLAYBACK http://127.0.0.1:6878/content/4c78e1cf0df23b4f5a16a106829ebed710cb52e0/0.673752283974 75 <<STATUS main:dl;0;0;146;0;0;7;0;9568256;0;0
остановить загрузку контента
>>STOP <<STATE 0
разорвать соединение
>>SHUTDOWN <<SHUTDOWN