Difference between revisions of "Engine HTTP API"
(Новая страница: «==Общее описание== Начиная с версии 3.1 появилась возможность управлять движком по протокол…») |
(→Методы API) |
||
| Line 5: | Line 5: | ||
В описаниях методов <tt>''<engine_address>''</tt> - это ip-адрес движка, <tt>''<engine_port>''</tt> - http-порт движка. | В описаниях методов <tt>''<engine_address>''</tt> - это ip-адрес движка, <tt>''<engine_port>''</tt> - http-порт движка. | ||
Все методы принимают такие общие параметры: | Все методы принимают такие общие параметры: | ||
| − | *'''sid''' - идентификатор сессии | + | *'''sid''' - [[#Идентификатор сессии|идентификатор сессии]] (необязательный параметр) |
===Получение потока в формате HLS=== | ===Получение потока в формате HLS=== | ||
| Line 30: | Line 30: | ||
Пример: | Пример: | ||
<nowiki>http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d</nowiki> | <nowiki>http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d</nowiki> | ||
| + | |||
| + | ==Идентификатор сессии== | ||
Revision as of 15:18, 24 April 2015
Contents
Общее описание
Начиная с версии 3.1 появилась возможность управлять движком по протоколу HTTP. Для передачи команды движку нужно отправить HTTP GET запрос на http-порт движка. Порт по умолчанию: 6878.
Методы API
В описаниях методов <engine_address> - это ip-адрес движка, <engine_port> - http-порт движка. Все методы принимают такие общие параметры:
- sid - идентификатор сессии (необязательный параметр)
Получение потока в формате HLS
http://<engine_address>:<engine_port>/ace/manifest.m3u8
В ответ на данную команду движок выдаст HLS плейлист для воспроизведения запрашиваемого контента. В случае ошибки будет возвращен HTTP код 4хх либо 5хх с кратким описанием ошибки.
Воспроизведение в формате HLS доступно только для live-трансляций. При попытке запустить VOD с помощью данной команды движок выдаст ошибку.
Параметры:
- id - идентификатор контента (content id)
Пример:
http://127.0.0.1:6878/ace/manifest.m3u8?id=dd1e67078381739d14beca697356ab76d49d1a2d
Получение потока по HTTP
http://<engine_address>:<engine_port>/ace/getstream
В ответ на данную команду движок будет выдавать данные в виде http progressive download. В случае ошибки будет возвращен HTTP код 4хх либо 5хх с кратким описанием ошибки.
Параметры:
- id - идентификатор контента (content id)
Пример:
http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d
