Difference between revisions of "Multi Stream/en"

From Ace Stream Wiki
Jump to: navigation, search
(Поддерживаемые версии)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
Multi Stream is a function that allows to combine several streams in one acelive-file. The main purpose of this function is to provide ability to organize a broadcast with several options for quality (bitrate), between which user can switch.
 
Multi Stream is a function that allows to combine several streams in one acelive-file. The main purpose of this function is to provide ability to organize a broadcast with several options for quality (bitrate), between which user can switch.
  
==Как это работает==
+
==How does it work?==
Предположим, что есть два потока, которые представляют собой одну и ту же трансляцию в разных качествах (с разными битрейтами). Для начала необходимо как обычно запустить два источника (по одному на каждый поток). В результате получим два acelive-файла, например /tmp/stream_sd.acelive и /tmp/stream_hd.acelive.
+
Let's suppose that there are two streams, which represent the same broadcast in different qualities (with different bitrates). First we have to start two sources as usual (one for each stream). As a result we'll get two acelive-files, for example, /tmp/stream_sd.acelive and /tmp/stream_hd.acelive.
  
Для создания мультипотокового acelive-файла необходимо выполнить следующую команду:
+
To create multistream acelive-file we have to run the following command:
 
  <tt>acestreamengine --create-transport-multi \
 
  <tt>acestreamengine --create-transport-multi \
 
  --name "SD" --path /tmp/stream_sd.acelive \
 
  --name "SD" --path /tmp/stream_sd.acelive \
Line 10: Line 10:
 
  --out /tmp/stream_multi.acelive</tt>
 
  --out /tmp/stream_multi.acelive</tt>
  
В результате выполнения данной команды будет создан мультипотоковый файл /tmp/stream_multi.acelive, который необходимо отдавать клиентам.
+
As a result of this command a multistream file /tmp/stream_multi.acelive, which should be given to clients, will be created.
  
Параметры:
+
Parameters:
*<tt>--name</tt>: название потока
+
*<tt>--name</tt>: stream's name
*<tt>--path</tt>: путь к acelive-файлу, который нужно добавить к результирующему файлу (можно использовать http-ссылки)
+
*<tt>--path</tt>: path to acelive-file, which we have to add to the result file (http-links can be used)
*<tt>--out</tt>: путь к результирующему acelive-файлу с несколькими потоками (этот файл будет создан в результате работы команды)
+
*<tt>--out</tt>: path to the result acelive-file with several streams (this file will be created as a result of command's work)
  
Параметры <tt>--name</tt> и <tt>--path</tt> должны передаваться парами. Команда принимает столько пар этих параметров, сколько потоков нужно объединить в один.
+
Parameters <tt>--name</tt> and <tt>--path</tt> must be passed in pairs. The command takes as many pairs of these parameters, as many streams have to be combined in one.
  
Параметр <tt>--name</tt> задает название потока, которое будет выводиться у пользователя в переключателе. Также в переключателе будет автоматически добавляться битрейт потока в Kbit/s.
+
Parameter <tt>--name</tt> sets stream's name, which will be displayed in user's switch. Also a bitrate of the stream in Kbit/s will be automatically added to the switch.
  
==Поддерживаемые версии==
+
==Supported versions==
Функция Multi Stream доступна начиная с версии 2.0.8. Клиенты более ранних версий не смогут распознать файл, содержащий несколько потоков. В связи с эти рекомендуется на веб-страницах, где размещены плееры для проигрывания таких файлов, выполнять проверку версии и выводить соответствующее сообщение для не поддерживаемых версий. Пример здесь: http://torrentstream.org/test/multi.html
+
Multi Stream function is available starting from version 2.0.8. Clients of older versions will not be able to recognize the file that contains several streams. Due to the above we recommend to perform version checking and display an appropriate message for unsupported versions on web pages where players are placed for playback of these files.

Latest revision as of 16:47, 22 September 2014

Multi Stream is a function that allows to combine several streams in one acelive-file. The main purpose of this function is to provide ability to organize a broadcast with several options for quality (bitrate), between which user can switch.

How does it work?

Let's suppose that there are two streams, which represent the same broadcast in different qualities (with different bitrates). First we have to start two sources as usual (one for each stream). As a result we'll get two acelive-files, for example, /tmp/stream_sd.acelive and /tmp/stream_hd.acelive.

To create multistream acelive-file we have to run the following command:

acestreamengine --create-transport-multi \
--name "SD" --path /tmp/stream_sd.acelive \
--name "HD" --path /tmp/stream_hd.acelive \
--out /tmp/stream_multi.acelive

As a result of this command a multistream file /tmp/stream_multi.acelive, which should be given to clients, will be created.

Parameters:

  • --name: stream's name
  • --path: path to acelive-file, which we have to add to the result file (http-links can be used)
  • --out: path to the result acelive-file with several streams (this file will be created as a result of command's work)

Parameters --name and --path must be passed in pairs. The command takes as many pairs of these parameters, as many streams have to be combined in one.

Parameter --name sets stream's name, which will be displayed in user's switch. Also a bitrate of the stream in Kbit/s will be automatically added to the switch.

Supported versions

Multi Stream function is available starting from version 2.0.8. Clients of older versions will not be able to recognize the file that contains several streams. Due to the above we recommend to perform version checking and display an appropriate message for unsupported versions on web pages where players are placed for playback of these files.