Новые параметры для acestreamengine-stream/acestreamengine-node, начиная с версии 2.0.3 ( обновление от 15.12.2012)
acestreamengine-stream
Эта команда запускает источник трансляции
обязательные параметры
--name NAME - название трансляции (это название используется при создании файла acelive)
--source SOURCE - источник (ссылка на http поток)
--bitrate BITRATE - средний битрейт потока в байтах в секунду
необязательные параметры
--title TITLE - "читабельное" название транляции (это название выводится у клиентов). Если не задано, берется из --name
--destdir DESTDIR - устаревшний параметр, лучше использовать --cache-dir и --publish-dir
--cache-dir CACHE_DIR - папка для создания служебных файлов (кеш трансляции и другие)
--publish-dir PUBLISH_DIR - папка, в которой будет создан acelive-файл
--piecesize PIECESIZE - размер куска в байтах (если не задан, выставляется автоматически в зависимости от битрейта)
--duration DURATION - размер кеша трансляции в формат ЧЧ:ММ:СС (по умолчанию один час: 01:00:00)
--host HOST - вручную задать адрес локального трекера
--port PORT - порт, на котором работает движок
--skip-internal-tracker - отключить локальный трекер
--add-authorized-peers - добавить список авторизованных пиров в acelive файл
--private-source - сделать источник "приватным"
--support-node SUPPORT_NODE - добавить узел поддержки (в формате ip:port). Этот параметр может встречаться несколько раз, если нужно добавить несколько узлов поддержки.
--tracker TRACKER - добавить трекер (announce url). Этот параметр может встречаться несколько раз.
--trackers TRACKERS - старый формат добавления трекеров (список announce url через запятую)
--provider-key PROVIDER_KEY - ключ провайдера (только для коммерческих трансляций)
--maxclients MAXCLIENTS - максимальное количество пиров, на которые одновременно отдаются данные с источника
--show-pieces - выводить в лог номера кусков по мере их создания
--show-peers - периодически выводить в лог список подключенных пиров
--debug DEBUG - установить уровень отладки
дополнительно:
-h, --help - показать описание команд
Примечания:
"локальный трекер" - это трекер встроенный в источник трансляции. Если он не отключен опцией --skip-internal-tracker, то его адрес будет автоматически добавлен в acelive-файл.
"приватный источник" - это источник, который отдает данные только узлам поддержки, которые заданы опцией --support-node
Авторизованные пиры
Опция --add-authorized-peers добавляет в acelive-файл список пиров, которым клиент может "доверять" при подключении к трансляции. Это означает, что клиенту достаточно установить соединение с таким пиром, чтобы начать воспроизведение трансляции. Если клиент не подключен к авторизованному пиру, то для начала воспроизведение требуется наличие соединения минимум с двумя пирами. В список авторизованных пиров попадает источник трансляции (если это не приватный источник) и все указанные узлы поддержки.
Важно: клиенты со старыми версиями не понимают список авторизованных пиров в acelive-файле. Старые версии считают авторизованным пиром того, чей адрес совпадает с адресом первого трекера в списке трекеров. Раньше это всегда был локальный трекер. Теперь, когда появилась возможность отключения локального трекера, для поддержки старых клиентов мы рекомендуем при отключении локального трекера ставить на первое место трекер, расположенный на том же сервере, что и источник трансляции (чтобы адреса первого трекера и источника совпадали), либо использовать как минимум один узел поддержки (чтобы клиенты при старте могли установить соединение сразу с двумя пирами, даже если больше никто не смотрит трансляцию).
acestreaengine-node
Эта команда запускает узел поддержки
обязательные параметры
--url URL - ссылка на acelive файл трансляции
необязательные параметры
--port PORT - порт (по умолчанию 8621)
--state-dir STATE_DIR - папка для временных файлов (удаляется после остановки узла поддержки)
--source-node SOURCE_NODE - адрес источника трансляции (ip:port)
--support-node SUPPORT_NODE - добавить адрес другого узла поддержки (ip:port). Этот параметр может встречаться несколько раз.
--allow-source-download - разрешить получение данных от источника
--allow-support-download - разрешить получение данных от других узлов поддержки
--allow-peers-download - разрешить получение данных от обычных пиров
--max-incoming-connects MAX_INCOMING_CONNECTS - маскимальное кол-во входящих соединений (от других пиров) (по умолчанию 1000)
--max-outgoing-connects MAX_OUTGOING_CONNECTS - маскимальное кол-во исходящих соединений (к другим пирам) (по умолчанию 50)
--max-upload-slots MAX_UPLOAD_SLOTS - максимальное количество пиров, на которые одновременно отдаются данные с узла поддержки (по умолчанию 7)
--max-download-speed MAX_DOWNLOAD_SPEED - максимальная скорость загрузки (байт/с). По умолчанию 0 (без ограничений).
--max-upload-speed MAX_UPLOAD_SPEED - максимальная скорость отдачи (байс/с). По умолчанию 0 (без ограничений).
--show-pieces - выводить в лог номера кусков по мере их загрузки
--show-peers - периодически выводить в лог список подключенных пиров
--stats-report-interval STATS_REPORT_INTERVAL - задать интервал в секундах для вывода в лог информации о скорости загрузки/отдачи. По умолчанию 0 (не выводить).
--debug DEBUG - установить уровень отладки
дополнительно:
-h, --help - показать описание команд