== Установка ==
=== Установка ACE Stream на Debian/Ubuntu из репозитория ===
'''Шаг 1'''
Добавить ссылку на соответствующий репозиторий в файл <tt>/etc/apt/sources.list</tt>.
Репозиторий следует выбирать в зависимости от операционной системы.
''Debian 6+:''
<tt><nowiki>deb http://repo.acestream.org/debian/ squeeze main</nowiki></tt>
либо
<tt><nowiki>deb http://repo.acestream.org/debian/ sid main</nowiki></tt>
Примечание: пакеты в репозитории sid собраны с зависимостями, которые соответствуют официальным sid-репозиториям Debian.
Если вы не знаете, какой репозиторий выбрать, используйте squeeze.
''Ubuntu 11.10:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ oneiric main</nowiki></tt>
''Ubuntu 12.04:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ precise main</nowiki></tt>
''Ubuntu 12.10:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ quantal main</nowiki></tt>
''Ubuntu 13.04:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ raring main</nowiki></tt>
'''Шаг 2'''
Установка публичного ключа. Для этого необходимо выполнить следующую команду:
''Debian:''
<tt><nowiki>wget -O - http://repo.acestream.org/keys/acestream.public.key | apt-key add -</nowiki></tt>
''Ubuntu:''
<tt><nowiki>sudo wget -O - http://repo.acestream.org/keys/acestream.public.key | sudo apt-key add -</nowiki></tt>
'''Шаг 3'''
Установка нужного пакета. Например, для установки движка нужно установить пакет acestream-engine
''Debian''
<tt>apt-get update</tt>
<tt>apt-get install acestream-engine</tt>
''Ubuntu''
<tt>sudo apt-get update</tt>
<tt>sudo apt-get install acestream-engine</tt>
В репозитории для Ubuntu доступны следующие пакеты:
*'''acestream-engine''' - движок
*'''acestream-mozilla-plugin''' - плагин для браузеров
*'''acestream-player''' - десктопный плеер
*'''acestream-player-data''' - набор общих библиотек для плеера и плагина
*'''acestream-full''' - полный пакет, который включает в себя все вышеперечисленные
Для Debian доступен только движок (acestream-engine).
=== Установка пакет ACE Stream на Ubuntu из deb-пакета ===
Можно установить ACE Stream на Ubuntu без использования репозитория. Для этого необходимо скачать установочный пакет по одной из ссылок ниже и установить пакет через менеджер пакетов (например, двойным кликом на скачанный файл пакета).
Пакет для 32-битных версий Ubuntu:
<tt>http://dl.torrentstream.org/products/acestream-full/ubuntu/i368/latest</tt>
Пакет для 64-битных версий Ubuntu:
<tt>http://dl.torrentstream.org/products/acestream-full/ubuntu/amd64/latest</tt>
Поддерживаемые версии Ubuntu: 11.10, 12.04, 12.10
Данный установочный пакет является аналогом пакета <tt>acestream-full</tt> из репозитория и включает в себя движок, плеер и плагин для браузеров.
=== Установка Ace Stream на CentOS ===
Для установки на CentOS необходимо:
* наличие установленного python 2.6
* наличие установленного модуля python-argparse
* скачать пакет, соответствующий версии CentOS (ссылки ниже)
* распаковать скачанный архив и скопировать содержимое в папку /usr
На данный момент доступны такие пакеты:
*'''CentOS 5 64bit''': http://dl.acestream.org/centos/5/acestream-engine-2.0.8_7-centos5-x86_64.tar.gz
*'''CentOS 6 64bit''': http://dl.acestream.org/centos/6/acestream-engine-2.0.8_7-centos6-x86_64.tar.gz
Данные пакеты тестировались на версиях 5.8 и 6.3 соответственно
=== Android ===
Пакет для установки Ace Stream for Android:
http://dl.acestream.org/android/acestream-2.1.5.apk
==== Информация для разработчиков ====
Ace Stream for Android выполнен в виде сервиса, к которому могут подключаться сторонние приложения.
AIDL-файлы для подключения к Ace Stream:
* http://dl.acestream.org/android/IAceStreamEngine.aidl
* http://dl.acestream.org/android/IAceStreamEngineCallback.aidl
После того, как стороннее приложение подключается к сервису Ace Stream, происходит следующее:
* если Ace Stream не запущен, то он запускается
* приложение получает порт для работы с Ace Stream Engine API через callback onStartEnd()
* приложение начинает работу с движком по API
==Запуск трансляции==
===Переход с версий 2.0.х на версию 2.1 и выше===
С 10 сентября 2013 года доступна обновленная версия движка 2.1.6 под Ubuntu, Debian и CentOS.
Новая версия доступна для тестирования по следующим ссылкам:
'''Ubuntu''':
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1oneiric1_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1oneiric1_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1precise1_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1precise1_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1quantal1_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1quantal1_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1raring1_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.1.6-1raring1_i386.deb
'''Debian''':
* http://dl.acestream.org/debian/acestream-engine_2.1.6-1squeeze1_amd64.deb
* http://dl.acestream.org/debian/acestream-engine_2.1.6-1wheezy1_amd64.deb
* http://dl.acestream.org/debian/acestream-engine_2.1.6-1wheezy1_i386.deb
'''CentOS 6''':
* http://dl.acestream.org/centos/6/acestream-engine-2.1.6_1-centos6-x86_64.tar.gz
В репозитории repo.acestream.net пока доступны старые версии (2.0.8).
Перед полномасштабным использованием новой версии мы рекомендуем по возможности протестировать ее на одной или нескольких трансляциях.
При возникновении каких-либо проблем просьба писать на форум http://forum.torrentstream.org либо на почту support@acestream.net.
Старые версии временно доступны в репозитории и по прямым ссылкам:
'''Ubuntu''':
''обязательные параметры''
*<tt>--name NAME(*)</tt> - название трансляции (это название используется при создании файла acelive и других служебных файлов)
*<tt>--source SOURCE</tt> - источник (ссылка на http-поток)
*<tt>--bitrate BITRATE(*)</tt> - средний битрейт потока в байтах в секунду
''необязательные параметры''
*<tt>--title TITLE(*)</tt> - "читабельное" название трансляции (это название выводится у клиентов). Если не задано, берется из --name
*<tt>--destdir DESTDIR</tt> - устаревший параметр, лучше использовать --cache-dir и --publish-dir
*<tt>--cache-dir CACHE_DIR</tt> - папка для создания служебных файлов (кеш трансляции и другие)
*<tt>--publish-dir PUBLISH_DIR</tt> - папка, в которой будет создан acelive-файл
*<tt>--piecesize PIECESIZE(*)</tt> - размер куска в байтах , в степени 2 (если не задан, выставляется автоматически в зависимости от битрейта)*<tt>--duration DURATION(*)</tt> - размер кеша трансляции в формат ЧЧ:ММ:СС (по умолчанию один час: 01:00:00)*<tt>--host HOST(*)</tt> - вручную задать адрес локального трекера*<tt>--port PORT(*)</tt> - порт, на котором работает движок. По умолчанию 7764.*<tt>--skip-internal-tracker(*)</tt> - отключить локальный трекер*<tt>--add-authorized-peers(*)</tt> - добавить список авторизованных пиров в acelive файл*<tt>--private-source(*)</tt> - сделать источник приватным*<tt>--support-node SUPPORT_NODE(*)</tt> - добавить узел поддержки (в формате ip:port). Этот параметр может встречаться несколько раз, если нужно добавить несколько узлов поддержки.*<tt>--tracker TRACKER(*)</tt> - добавить трекер (announce url). Этот параметр может встречаться несколько раз.
*<tt>--maxclients MAXCLIENTS</tt> - максимальное количество пиров, на которые одновременно отдаются данные с источника. По умолчанию 7.
*<tt>--log-debug DEBUG</tt> - установить уровень отладки (по умолчанию 0 - минимальный)
*<tt>--source-reconnect-interval SECONDS</tt> - интервал в секундах, через который движок попробует повторно подсоединиться к оригинальному источнику при обрыве связи. По умолчанию 5.
*<tt>--pid-file-dir PATH</tt> - папка, в которой будет создан pid-файл движка. По умолчанию /tmp.
*<tt>--provider-key(*)</tt> - ключ провайдера (используется для партнерской программы)*<tt>--content-idsid (*)</tt> - идентификатор контента трансляции для статистики (используется для партнерской программы)*<tt>--permanent(*)</tt> - отметить трансляцию как постоянно действующую, которая идет 24/7 (круглосуточная трансляция)*<tt>--date-start YYYY-MM-DD HH:mm:ss(*)</tt> - указать дату и время начала трансляции (для трансляций с ограниченным временем вещания)*<tt>--date-end YYYY-MM-DD HH:mm:ss(*)</tt> - указать дату и время окончания трансляции (для трансляций с ограниченным временем вещания)*<tt>--premium(*)</tt> - запросить статус "премиум" для трансляции
*<tt>--upload-limit</tt> - ограничить скорость отдачи (в байтах/с, по умолчанию 0 - не ограничивать)
*<tt>--max-connections</tt> - максимальное общее кол-во соединений (по умолчанию 1000)
''дополнительно''
*<tt>-h, --help</tt> - показать описание команд
''примечание''
Изменение параметров, отмеченных звездочками, приводит к изменению Content ID трансляции
===Синтаксис команды acestreamengine --stream-node===
