Changes
Новая страница: «== Установка == === Установка TS Engine на Debian === Для установки TS Engine необходимо добавить репозит…»
== Установка ==
=== Установка TS Engine на Debian ===
Для установки TS Engine необходимо добавить репозиторий Torrent Stream в файл <tt>/etc/apt/sources.list:
deb http://torrentstream.net/repo ubuntu main</tt>
Если при установке пакета выводится сообщение про неизвестный ключ, можно его добавить в систему:
<tt>wget -O - http://torrentstream.net/repo/torrentstream.public.key | apt-key add -</tt>
После этого нужно установить пакет torrentstream-engine:
<tt>apt-get update</tt>
<tt>apt-get install torrentstream-engine</tt>
=== Установка пакет TorrentStream Full на Ubuntu из deb-пакета ===
* скачать пакет по ссылке
http://torrentstream.org/downloads/linux/test/torrentstream_1.0.6-0ubuntu8_amd64.deb
либо
http://torrentstream.org/downloads/linux/test/torrentstream_1.0.6-0ubuntu8_i386.deb
(в зависимости от нужной архитектуры)
* установить пакет через менеджер пакетов (например, двойным кликом на скачанный файл пакета)
=== Установка пакет TorrentStream Full на Ubuntu из репозитория ===
Добавить репозиторий Torrent Stream в файл /etc/apt/sources.list:
<tt>deb http://torrentstream.net/repo ubuntu main</tt>
Если при установке пакета выводится сообщение про неизвестный ключ, можно его добавить в систему:
<tt>sudo wget -O - http://torrentstream.net/repo/torrentstream.public.key | apt-key add -</tt>
После этого нужно установить пакет torrentstream-engine:
<tt>sudo apt-get update</tt>
<tt>sudo apt-get install torrentstream-full</tt>
== Запуск трансляции ==
Для запуска трансляции используется команда tsengine-stream, которая принимает такие параметры:
<tt>'''--name'''</tt>
Название трансляции
<tt>'''--source'''</tt>
Источник - URL потока, который будет транслироваться. В данный момент поддерживаются HTTP потоки с инкапсуляцией MPEG-TS
<tt>'''--destdir'''</tt>
Директория, в которую будет сохранен .tslive файл для данной трансляции и некоторые служебные файлы.
<tt>'''--bitrate'''</tt>
Битрейт потока в килобайтах в секунду. Для корректной работы потока следует указывать средний битрейт потока, который используется в качестве источника.
<tt>'''--piecesize'''</tt>
Размер в байтах куска для работы bittorrent-протокола. По умолчанию данный параметр принимает значение auto, при котором размер куска определяется автоматически.
<tt>'''--duration'''</tt>
Длительность потока в формате ЧЧ:ММ:СС. Этот параметр задает объем кэша для потока. Значение по умолчанию - 01:00:00 (т.е. система будет держать в кэше приблизельно один час трансляции).
<tt>'''--host'''</tt>
IP-адрес либо название хоста, на котором запускается трансляция. Для работы трансляции данный адрес должен быть доступен пользователям, которые будут смотреть трансляцию.
<tt>'''--port'''</tt>
Порт, на который будут приниматься входящие соединения. По умолчанию 7764.
<tt>'''--trackers'''</tt>
Список дополнительных трекеров, которые будут использоваться для обмена пирами. Адреса трекеров указываются через запятую. По умолчанию дополнительные трекеры не используются.
<tt>'''--provider-key'''</tt>
Ключ лицензии для коммерческих трансляций. По умолчанию не используется.
<tt>'''--maxclients'''</tt>
Максимальное количество клиентов, которые будут получать данные непосредственно от источника трансляции. По умолчанию 7.
'''Пример:'''
<tt>tsengine-stream --name test --source http://84.22.159.204:8006 --bitrate 350000 --host mysite.com --destdir /tmp/streams</tt>
После запуска трансляции в директории /tmp/streams будут созданы такие файлы:
<tt>'''test'''</tt> - кэш трансляции. Размер этого файла примерно равен длительность_потока_в_секундах * битрейт байт
<tt>'''test.tslive'''</tt> - с помощью этого файла пользователи могут подключаться к трансляции
<tt>'''test.restart'''</tt> - здесь хранится информация для корректного перезапуска трансляции
<tt>'''test.sauth'''</tt> - ключ для цифровой подписи трансляции
Также после запуска можно зайти на страницу трекера, встроенного в TS Engine:
<tt>http://mysite.com:7764/</tt>
На данной странице отображается некоторая информация по трансляции, а также здесь можно скачать файл трансляции .tslive по такой ссылке:
<tt>http://mysite.com:7764/file?name=test</tt>
== Просмотр трансляции пользователями. ==
Если два основных способа просмтра трансляции
# пользователь скачивает файл .tslive и запускает его в TS Player
# организатор трансляции создает веб-страницу для просмотра трансляции, пользователи заходят на данную страницу и смотрят трансляцию через браузер.
В качестве шаблона для такой страницы можно использовать http://torrentstream.org/stream/test.php. Необходимо только изменить ссылку на файл .tslive в этой строке:
<tt>this.loadTorrent("http://torrentstream.net/streams/test2.mpegts.tslive");</tt>
== Мониторинг трансляции ==
Программа tsengine-stream выводит всю отладочную информацию в STDERR. Успешный страрт трансляции выглядит примерно таким образом:
<tt>host:~# tsengine-stream --name test --source http://84.22.159.204:8006 --bitrate 350000 --host mysite.com --destdir /tmp/streams
tracker url: http://mysite.com:7764/announce/
bitrate: 350000
piece size: 262144
dest dir: /tmp/streams
------------------------
createlivestream: open stream: url http://84.22.159.204:8006 reader builtin
2012-07-16 12:56:36 stream: started input thread
2012-07-16 12:56:37 stream: created piece 0 speed 131.12 KiB/s
2012-07-16 12:56:38 stream: created piece 1 speed 183.15 KiB/s
2012-07-16 12:56:39 stream: created piece 2 speed 198.34 KiB/s
2012-07-16 12:56:40 stream: created piece 3 speed 196.96 KiB/s
2012-07-16 12:56:41 stream: created piece 4 speed 199.23 KiB/s
2012-07-16 12:56:43 stream: created piece 5 speed 203.08 KiB/s
2012-07-16 12:56:44 stream: created piece 6 speed 206.37 KiB/s</tt>
Основная выводимая информация: номера создаваемых кусков и скорость загрузки данных от источника трансляции.
Остановка трансляции осуществляется нажатием Ctrl-C
=== Установка TS Engine на Debian ===
Для установки TS Engine необходимо добавить репозиторий Torrent Stream в файл <tt>/etc/apt/sources.list:
deb http://torrentstream.net/repo ubuntu main</tt>
Если при установке пакета выводится сообщение про неизвестный ключ, можно его добавить в систему:
<tt>wget -O - http://torrentstream.net/repo/torrentstream.public.key | apt-key add -</tt>
После этого нужно установить пакет torrentstream-engine:
<tt>apt-get update</tt>
<tt>apt-get install torrentstream-engine</tt>
=== Установка пакет TorrentStream Full на Ubuntu из deb-пакета ===
* скачать пакет по ссылке
http://torrentstream.org/downloads/linux/test/torrentstream_1.0.6-0ubuntu8_amd64.deb
либо
http://torrentstream.org/downloads/linux/test/torrentstream_1.0.6-0ubuntu8_i386.deb
(в зависимости от нужной архитектуры)
* установить пакет через менеджер пакетов (например, двойным кликом на скачанный файл пакета)
=== Установка пакет TorrentStream Full на Ubuntu из репозитория ===
Добавить репозиторий Torrent Stream в файл /etc/apt/sources.list:
<tt>deb http://torrentstream.net/repo ubuntu main</tt>
Если при установке пакета выводится сообщение про неизвестный ключ, можно его добавить в систему:
<tt>sudo wget -O - http://torrentstream.net/repo/torrentstream.public.key | apt-key add -</tt>
После этого нужно установить пакет torrentstream-engine:
<tt>sudo apt-get update</tt>
<tt>sudo apt-get install torrentstream-full</tt>
== Запуск трансляции ==
Для запуска трансляции используется команда tsengine-stream, которая принимает такие параметры:
<tt>'''--name'''</tt>
Название трансляции
<tt>'''--source'''</tt>
Источник - URL потока, который будет транслироваться. В данный момент поддерживаются HTTP потоки с инкапсуляцией MPEG-TS
<tt>'''--destdir'''</tt>
Директория, в которую будет сохранен .tslive файл для данной трансляции и некоторые служебные файлы.
<tt>'''--bitrate'''</tt>
Битрейт потока в килобайтах в секунду. Для корректной работы потока следует указывать средний битрейт потока, который используется в качестве источника.
<tt>'''--piecesize'''</tt>
Размер в байтах куска для работы bittorrent-протокола. По умолчанию данный параметр принимает значение auto, при котором размер куска определяется автоматически.
<tt>'''--duration'''</tt>
Длительность потока в формате ЧЧ:ММ:СС. Этот параметр задает объем кэша для потока. Значение по умолчанию - 01:00:00 (т.е. система будет держать в кэше приблизельно один час трансляции).
<tt>'''--host'''</tt>
IP-адрес либо название хоста, на котором запускается трансляция. Для работы трансляции данный адрес должен быть доступен пользователям, которые будут смотреть трансляцию.
<tt>'''--port'''</tt>
Порт, на который будут приниматься входящие соединения. По умолчанию 7764.
<tt>'''--trackers'''</tt>
Список дополнительных трекеров, которые будут использоваться для обмена пирами. Адреса трекеров указываются через запятую. По умолчанию дополнительные трекеры не используются.
<tt>'''--provider-key'''</tt>
Ключ лицензии для коммерческих трансляций. По умолчанию не используется.
<tt>'''--maxclients'''</tt>
Максимальное количество клиентов, которые будут получать данные непосредственно от источника трансляции. По умолчанию 7.
'''Пример:'''
<tt>tsengine-stream --name test --source http://84.22.159.204:8006 --bitrate 350000 --host mysite.com --destdir /tmp/streams</tt>
После запуска трансляции в директории /tmp/streams будут созданы такие файлы:
<tt>'''test'''</tt> - кэш трансляции. Размер этого файла примерно равен длительность_потока_в_секундах * битрейт байт
<tt>'''test.tslive'''</tt> - с помощью этого файла пользователи могут подключаться к трансляции
<tt>'''test.restart'''</tt> - здесь хранится информация для корректного перезапуска трансляции
<tt>'''test.sauth'''</tt> - ключ для цифровой подписи трансляции
Также после запуска можно зайти на страницу трекера, встроенного в TS Engine:
<tt>http://mysite.com:7764/</tt>
На данной странице отображается некоторая информация по трансляции, а также здесь можно скачать файл трансляции .tslive по такой ссылке:
<tt>http://mysite.com:7764/file?name=test</tt>
== Просмотр трансляции пользователями. ==
Если два основных способа просмтра трансляции
# пользователь скачивает файл .tslive и запускает его в TS Player
# организатор трансляции создает веб-страницу для просмотра трансляции, пользователи заходят на данную страницу и смотрят трансляцию через браузер.
В качестве шаблона для такой страницы можно использовать http://torrentstream.org/stream/test.php. Необходимо только изменить ссылку на файл .tslive в этой строке:
<tt>this.loadTorrent("http://torrentstream.net/streams/test2.mpegts.tslive");</tt>
== Мониторинг трансляции ==
Программа tsengine-stream выводит всю отладочную информацию в STDERR. Успешный страрт трансляции выглядит примерно таким образом:
<tt>host:~# tsengine-stream --name test --source http://84.22.159.204:8006 --bitrate 350000 --host mysite.com --destdir /tmp/streams
tracker url: http://mysite.com:7764/announce/
bitrate: 350000
piece size: 262144
dest dir: /tmp/streams
------------------------
createlivestream: open stream: url http://84.22.159.204:8006 reader builtin
2012-07-16 12:56:36 stream: started input thread
2012-07-16 12:56:37 stream: created piece 0 speed 131.12 KiB/s
2012-07-16 12:56:38 stream: created piece 1 speed 183.15 KiB/s
2012-07-16 12:56:39 stream: created piece 2 speed 198.34 KiB/s
2012-07-16 12:56:40 stream: created piece 3 speed 196.96 KiB/s
2012-07-16 12:56:41 stream: created piece 4 speed 199.23 KiB/s
2012-07-16 12:56:43 stream: created piece 5 speed 203.08 KiB/s
2012-07-16 12:56:44 stream: created piece 6 speed 206.37 KiB/s</tt>
Основная выводимая информация: номера создаваемых кусков и скорость загрузки данных от источника трансляции.
Остановка трансляции осуществляется нажатием Ctrl-C
