Ace Stream - Test HTTP API

HTTP API дозволяє керувати двигуном за допомогою HTTP запитів.

ВАЖЛИВО! Технічно неможливо відправити запит двигуна з https-сторінки, оскільки спілкування з двигуном здійснюється за незахищеним протоколом HTTP. Всі такі запити блокуються всіма сучасними браузерами. При необхідності працювати з движком зі свого https-сайту вебмастер повинен створити для цього незахищену http-сторінку.

Команда движка є URL певного формату. Формат залежить від того, який контент ви хочете дивитися і в якому форматі його повинен видати двигун.

У всіх прикладах передбачається, що порт 6878, що використовується за умовчанням, не був змінений в налаштуваннях движка. Також передбачається, що двигун запущений. Процедуру перевірки стану движка та його версії описано тут (TODO: додати посилання). Описане тут HTTP API доступне з версії движка 3.1.0-rc8 (код версії: 3002800) Всі відповіді від движка в рамках HTTP API містять заголовок "Access-Control-Allow-Origin: *", що дозволяє надсилати запити движку за допомогою AJAX-запитів з будь-якого домену, не порушуючи політику безпеки браузера.

Параметри запитів до HTTP API

HLS P2P таймшифт

Розширені можливості HTTP API.

Двигун надає деякі додаткові можливості керування сесією відтворення. Сюди входить можливість відправляти додаткові команди, отримувати інформацію про сесію відтворення, а також отримувати деякі події. Для отримання доступу до розширених можливостей необхідно додати один параметр під час старту сесії відтворення:

При отриманні даного параметра двигун видасть у відповідь медіа-потік, а набір посилань у форматі JSON:

За посиланнямplayback_url двигун віддасть запитаний медіа-потік. Це посилання необхідно передати плеєру.

За посиланням stat_url видається інформація про сесію відтворення у форматі JSON:

За посиланням command_url двигун приймає команди для керування сесією відтворення. Назва команди передається у параметрі method. На даний момент доступна одна команда: stop – зупинити сесію відтворення. Рекомендується завжди зупиняти сесію відтворення за допомогою цієї команди, коли відтворення зупиняється на рівні програвача.

Як відбувається запуск

1. Запуск VOD по infohash, виведення в HLS

2. Запуск VOD за посиланням на транспортний файл

3. Запуск VOD AceStream Content ID з використанням розширених можливостей HTTP API, формат HLS

Media Server API

Media Server API використовується для завдань, не пов'язаних безпосередньо з отриманням медіа-потоку від двигуна. Запит вирушають сюди:

Усі запити повинні мати обов'язковий параметр method.

На даний момент доступні такі методи:

• запуск відтворення у зовнішньому плеєрі
• отримання списку встановлених плеєрів
• додавання контенту в плейлист движка

1. Запустити відтворення в одному зі встановлених у користувача плеєрі.

2. Отримати список доступних плеєрів:

3. Додавання контенту в плейлист движка.

Додавання в плейлист движка відбувається тільки за згодою користувача. У зв'язку з цим у Media Server API немає методу для прямого додавання, але є можливість відкрити iframe з формою для додавання. Для цього необхідно створити iframe на веб-сторінці та завантажити в нього таке посилання:

---