January 8, 2010

Конфигурация Icecast: секция mount

Секция <mount> (mount point) определяет статическую постоянную точку монтирования на сервере Icecast. Динамическая точка — та, которая не задана в конфигурационном файле icecast.xml и создаётся автоматически при подключении источника с заданным им же (источником) именем.

Маунтов на одном сервере может быть несколько. Как правило, это разные радиостанции, разные по качеству/формату каналы, или все вместе.

Вот сожержимое секции <mount>, предложенное в официальной документации по конфигурационному файлу icecast.xml:
<mount>
    <mount-name>/example-complex.ogg</mount-name>
    <username>othersource</username>
    <password>hackmemore</password>
    <max-listeners>1</max-listeners>
    <max-listener-duration>3600</max-listener-duration>
    <dump-file>/tmp/dump-example1.ogg</dump-file>
    <intro>/intro.ogg</intro>
    <fallback-mount>/example2.ogg</fallback-mount>
    <fallback-override>1</fallback-override>
    <fallback-when-full>1</fallback-when-full>
    <public>1</public>
    <stream-name>My audio stream</stream-name>
    <stream-description>My audio description</stream-description>
    <stream-url>http://some.place.com</stream-url>
    <genre>classical</genre>
    <bitrate>64</bitrate>
    <type>application/ogg</type>
    <subtype>vorbis</subtype>
    <hidden>1</hidden>
    <burst-size>65536</burst-size>
    <mp3-metadata-interval>4096</mp3-metadata-interval>
    <authentication type="htpasswd">
        <option name="filename" value="myauth"/>
        <option name="allow_duplicate_users" value="0"/>
    </authentication>
    <on-connect>/home/icecast/bin/source-start</on-connect>
    <on-disconnect>/home/icecast/bin/source-end</on-disconnect>
</mount>
А вот что всё это значит:
  • mount-name — название точки монтирования
  • username и password — необязательные значения, задающие с какими логином и паролем должен подключаться источник к этой точке для трансляции. Если не заданы, используются общие настройки для всего сервера — логин и пароль, указанные в начале файла icecast.xml
  • max-listeners — максимальное количество слушателей этой точки
  • max-listener-duration — максимальная продолжительность прослушивания
  • dump-file — файл, в который будет копироваться весь аудиопоток, проходящий через эту точку
  • intro — файл, который будет проигрываться при каждом подключении слушателя к точке, скажем, вступление
  • fallback-mount — точка монтирования в таком же формате, на которую будет перенаправлен слушатель если в данный момент времени эта точка не работает. Подробнее в статье Icecast Mountpoint Fallback или как настроить автопереключение каналов или в официальной документации
  • fallback-override — определяет возвращать ли слушателей назад если источник вновь подключится и точка монтирования заработает
  • fallback-when-full — переключать ли слушателей на fallback-mount если этот канал переполнен
  • public — показывать ли в каталоге YP
  • stream-name — название потока (не путать с mount-name), отображается в плеере у слушателя в качестве заголовка (также используется для YP)
  • stream-description — описание потока (также используется для YP)
  • stream-url — адрес потока (также используется для YP)
  • genre — жанр трансляции (также используется для YP)
  • bitrate — битрейт трансляции (по умолчанию определяется автоматически, также используется для YP)
  • type — тип аудиопотока (например, vorbis; также используется для YP)
  • subtype — mime-тип аудиопотока, определяющий конкретно его формат (например, vorbis/theora; также используется для YP)
  • hidden — скрывать точку ли на страницах статуса сервера (как например страница status.xsl)
  • burst-size — перезаписывает общую настройку объёма отправляемых в буффер плеера данных
  • mp3-metadata-interval — частота обновления метаданных
  • authentication — настройки аутентификации для прослушивания, подробнее в официальной документации
  • on-connect — адрес (путь) программы, которая будет выполняться при каждом подключении слушателя к точке
  • on-disconnect — адрес (путь) программы, которая будет выполняться при каждом отключении слушателя от точки

No comments: