Команды

Click to Display Table of Contents

Navigation:  Работа с программой > Планировщик >

Команды

Список доступных команд планировщика. Все команды, за исключением некоторых, могут быть вызваны через Карт-машину или использованы непосредственно в плейлисте (меню Плейлист -> Добавить команду...).

 

Информация: в окне задания есть кнопка Мастера, с помощью которой большинство команд не нужно вводить вручную.

 

Воспроизведение

play

stop

pause

next

prev

setvol

fadeout

stopoverlays

eqpreset

dsp

 

Плейлист

generate

getrandomplaylist

clearplaylist

[folder_path]

getfile

playrequestedsong

playlist tab

resetplayedstate

 

Вещание

connect

disconnect

setencodersource

setcasttitle

 

Планировщик

scheduler on/off

enablegroup

disablegroup

enableevent

disableevent

runevent

setdtmfsource

 

Ретрансляция

relaystart

relaystop

 

Функции

streamarchive

silencedetector

enablevo

disablevo

autointro

set

 

Рекламный планировщик

adsupdate

adsremote

 

Музыкальная база

makelibrary

 

Система

run

reboot

poweroff

 

Прочее

createbackup

load

download

weather

COM port

send

 

 

play X

Запустить трек номер X в плейлисте

stop

Остановить воспроизведение

pause

Пауза воспроизведения

next [FadeOut] [CueNextOnEnd]

Перейти к следующему треку. Если указан параметр FadeOut, текущий трек будет затихать в течение указанного времени (в миллисекундах, 1 секунда = 1000 миллисекунд). Модификатор CueNextOnEnd указывает, что нужно дождаться окончания фейда и затем перейти к следующему треку.

 

Пример: перейти к следующему треку

next

 

Пример: переход к следующему треку и затухание текущего трека в течение 2х секунд

next 2000

 

Пример: затухание текущего трека в течение 5 сеунд и затем переход к следующему треку:

next 5000 CueNextOnEnd

 

Заметка: команда "next" с модификатором "CueNextOnEnd" может быть использована заданиях с несколькими действиями как первое действие, в этом случае команда будет исполнена до запуска задания; это работает только с заданиями со включенной опцией "Запускать не дожидаясь окончания играющего трека".

prev

Перейти к предыдущему треку

run filename parameters

Запустить любую программу или .bat файл

 

Пример:

run C:\dosomething.bat

run C:\AnyProgram.exe -switch1 -switch2

generate preset_name

Сгенерировать плейлист используя пресет preset_name, созданный в генераторе плейлистов. Например, пресет под названием "ROCK 2 Hours" (без кавычек), чтобы по расписанию создать плейлист по этому шаблону, используется команда generate Rock 2 hours

setvol x

Установить громкость эфира в x (от 0 до 100). Например, setvol 70 . Также, можно указать период, в течение которого будет меняться громкость (в миллисекундах, 1000мс = 1сек), например, setvol 70 500 - изменит уровень громкости до 70 в течение 0.5 секунды

load filename

Загрузка файла filename. Это может быть профиль (.prf), плейлист (.m3u) или список заданий планировщика (.sdl). Если не указано полное имя файла, то профиль ищется в папке \Profile, плейлист в папке \Playlist, файл расписания в папке \Presets\Schedule. Плейлисты загружаются в список Main.

load text ZN:Name; filename|text

Загрузить текст во вкладку с блокнотом.

ZN: - номер зоны (Z2, Z3)

Name - название вкладки

filename|text - путь к файлу, из которого нужно загрузить текст или сам текст.

 

Пример: загрузить текст "this is test" во вкладке NOTE0 во 2 зоне

load text Z2:NOTE0; this is test

getrandomplaylist Path

Загрузить случайный плейлист из папки folder_name.

Пример:

getrandomplaylist d:\music\playlists

clearplaylist [up|down]

Очистить плейлист. Если указан модификатор up, будут удалены только треки сверху от играющего трека. Если указан модификатор down будут удалены треки снизу от играющего.

reboot

Перезагрузить компьютер

poweroff

Выключить компьютер

connect

disconnect

connect - подключиться к серверу вещания, если не указан параметр, то происходит подключение ко всем серверам, указанным в настройках. Также в качестве параметра можно указать число от 1 до 5 чтобы подключиться к определенному серверу. Можно указать несколько серверов через запятую, например: connect 1,3,5

disconnect - параметры аналогично команде connect, только команда выполняет отключение от сервера

scheduler on

scheduler off [timeout]

Команды для временного включения или отключения расписания

 

Команда выключения расписания scheduler off переводит планировщик в режим ожидания - в этом режиме никакие задания расписания не работают, кроме задания с командой включения расписания: scheduler on

 

Можно указать время в минутах, на которое планировщик будет выключен, например:

scheduler off 15

 

Команда scheduler on также отключает опцию Manual

streamarchive on|off

streamarchive FILENAME

streamarchive DURATION FILENAME

Включить или выключить функцию Запись потока

(меню: Инструменты->Запись потока)

 

streamarchive on - включить запись потока

 

streamarchive off - остановить запись (включая запись в отдельном экземпляре, см. ниже)

 

Начать запись и сохранить в указанное имя файла:

streamarchive D:\myshow.mp3

 

Начать запись и сохранить в файл, лимит длительности записи 3600 секунд:

streamarchive 3600 D:\myshow.mp3

 

Если указано имя файла, запись производится во втором экземпляре записи эфира - запись в окне Запись эфира не затрагивается. Если продолжительность записи не указана, запись можно остановить командой streamarchive off или нажатием кнопки Stop в окне Запись эфира. Если будет начата другая запись с указанным именем файла, она остановит текущую запись, выполняемую во втором экземпляре.

makelibrary LibraryName|Dir1|Dir2|...

makelibrary <options> LibraryName|Dir1|Dir2|...

Создать или обновить музыкальную базу. Параметры команды разделяются с помощью символа "|" или пробела.

 

Первый параметр указывает название музыкальной базы, которую нужно создать. Второй и последующие - папки, которые должны быть просканированы (включая подпапки). Также, вместо папки можно указать путь к плейлисту, название базы, или путь к отдельному файлу. Если указана папка или плейлист, то база будет создана заново с треками из указанных источников. Если указан отдельный трек - он будет добавлен в базу.

 

Пример: создать музыкальную базу music и добавляет в него треки из папки C:\Music

makelibrary music|C:\Music

 

Пример: аналогичен предыдущему примеру, но добавляет треки из двух папок: C:\Music и D:\MoreMusic:

makelibrary music|C:\Music D:\MoreMusic

 

Пример: Использование плейлиста в качестве источника треков

makelibrary music|C:\playlist.m3u8

 

Options указывает дополнительные параметры: сканирование тишины, BPM, нормализация треков. Рекомендуется создавать команду с опциями, используя Сервис -> Запланировать автообновление базы в меню Музыкальной базы.

 

Пример: нормализовать треки до -9.0 LUFS; отрезать тишину; сканировать для точки микширования -14 дБ; определить BPM; определить Mix Start с уровнем -4 дБ. Пропустить треки, которые уже отсканированы.

makelibrary <normalize:-9.0;skip|silence:skip|mixpoint:-14.0;skip|bpm:skip|mixstart:-4.0;skip> music|C:\Music

 

Пример: нормализовать треки до -9.0 LUFS; пропустить треки с установленным уровнем тега.

makelibrary <normalize:-9.0;skip> my.xml|C:\Music

 

Пример: нормализовать треки до -9.0 LUFS; отрезать тишину; сканировать для точки микширования -14 dB; определить BPM. Пересканировать треки, где установлены значения (без пропуска модификатора)

makelibrary <normalize:-9.0|silence|mixpoint:-14.0|bpm> music|C:\Music

adsupdate

adsupdate -skipevents

Обновить задания и плейлисты из рекламного планировщика. Выполнение этой команды аналогично нажатию кнопки "Создать задания и плейлисты" в рекламном планировщике.

 

Если присутствует модификатор -skipevents задания в RadioBOSS не будут добавлены, произойдет только обновление плейлистов.

adsremote

Обновить задания и плейлисты на удаленной установке RadioBOSS.

createbackup FileName

Создать резервную копию насторек и заданий планировщика. Если используется база данных SQLite, также создается ее резервная копия.

 

Пример:

createbackup C:\RB_backup.7z

createbackup C:\RB_Backup_?yyyy-?mm-?dd.7z

 

Во втором примере используется макрозамена.

folder_path

folder_path/

Добавить треки из папки в плейлист. Если в конце пути добавить слеш "/", то файлы будут добавлены в случайном порядке, иначе - в алфавитном порядке.

 

Пример:

D:\Music или D:\Music\ - добавить треки из папки D:\Music folder в алфавитном порядке

D:\Music/ - добавить треки из папки D:\Music в случайном порядке

download [podcast|podcast_today] URL FILENAME

Скачать файл с интернета и сохранить как FILENAME.

Чтобы запустить определенный URL без сохранения каких-либо файлов, опустите параметр FILENAME (это можно использовать для отправки уведомлений).

Если указано ключевое слово podcast, URL должен указывать адрес подкаста, RadioBOSS выберет самый новый подкаст и скачает его.

podcast_today работает аналогично podcast за исключением того, что будет загружен только сегодняшний поток (если на сегодня потока нет, ничего загружено не будет)

При скачивании с FTP, если в URL указан логин и пароль будет использован пассивный режим передачи, иначе активный.

 

Пример:

download http://www.example.com/file1.exe D:\savedfile.ext

 

Пример: скачать подкаст (будет скачиваться последняя версия)

download podcast http://www.example.com/podcast.xml D:\podcast.mp3

 

Пример: скачать сегодняшний подкаст

download podcast_today http://www.example.com/podcast.xml D:\podcast.mp3

 

Пример: скачать файл, содержащий имя пользователя и пароль для авторизации

download http://USERNAME:PASSWORD@www.example.com/file1.exe D:\savedfile.ext

 

Пример: вызвать скрипт по указанному адресу, но не сохранять

download http://www.example.com/thescript.php

fadeout time_ms

Плавно выключить плейлист (сбавление громкости до нуля за время time_ms с последующей остановкой). Например, fadeout 500

set com(1-9) (dtr|txd)

clr com(1-9) (dtr|txd)

Установить/сбросить значение на выходе com-порта; выход может быть одним из dtr (пин 4) или txd (пин 3).

Например:

set com1 dtr - установить высокий уровень на dtr com1.

clr com2 txd - сбросить (установить низкий уровень) на выходе txd порта com2. Низкий уровень на com-портах соответствует -12В, высокий +12В

send COMX text

Отправить строку text на COM-порт COMX.

COMX - имя ком-порта, например, COM1

text - текст, который нужно отправить в порт

set OPTION [on|off]

 

Включить или выключить функцию OPTION.

 

set OPTION on - включить функцию

set OPTION off - выключить функцию

 

Пример: set shuffle on - включить случайное воспроизведение; set shuffle off - выключить случайное воспроизведение

 

Возможные значения OPTION:

shuffle - режим shuffle (случайное воспроизведение)

repeat_track - повтор трека

repeat_list - повтор плейлиста

break - остановка после текущего трека

autoamp - автоматический контроль громкости (AutoAmp)

http_request - HTTP запрос

manual - ручной режим (Manual) в планировщике

autointro - Auto Intro (Авто интро)  

 

Также команда set может использоваться, чтобы установить значение переменной %showname:

set %showname=TEXT

Переменную %showname можно использовать в HTTP запросе.

setencodersource SRC

Изменить источник звука для вещания.

 

Возможные значения SRC:

0 - Audio mix

1 - Вход 1

2 - Вход 2

3 - Вход 3

 

Для более подробной информации: Вещание интернет радио

 

Пример:

setencodersource 0

setcasttitle TITLE

Обновить название трека на сервере.

 

Пример:

setcasttitle My Show

silencedetector on

silencedetector off 

Включить и выключить детектор тишины

silencedetector on - включить

silencedetector off - выключить

 

Команда может также использоваться для изменения параметров:

silencedetector timeout N - изменить время срабатывания (в секундах)

silencedetector playlist FILENAME - изменить имя файла плейлиста, запускаемого при обнаружении тишины

getfile C:\path_to_folder [/random|/newest|/oldest]

[/delete|/move]

Команда добавляет один файл (трек или плейлист) из папки в плейлист. Команда может выбрать самый старый или самый новый (по дате добавления) файл или же случайный файл. В выборке могут быть как музыкальные треки, так и файлы плейлистов.

 

Синтаксис:

getfile C:\path_to_folder [/random|/newest|/oldest] [/delete]

 

Если путь к папке содержит пробелы, его нужно заключить в кавычки.

 

/random - выбрать случайный трек

/newest - выбрать самый новый трек из папки

/oldest - выбрать самый старый трек из папки

/delete - удалить файл после воспроизведения

/move=path - переместить файл в папку path после воспроизведения; если путь содержит пробелы, параметр нужно заключить в кавычки: "/move=C:\path with spaces"

 

Например: играть один файл из папки обьявлений и удалить его с диска после воспроизведения:

getfile C:\announcements /newest /delete

 

Параметр удаления (/delete) можно опустить, если вы не хотите, чтобы файл удалялся после воспроизведения.

playrequestedsong

playrequestedsong N

Запустить один из запрошенных пользователями треков.

 

Вы также можете указать минимальный интервал времени, который должен пройти между запросом и постановкой песни в эфир. Например, playrequestedsong 30 - задержать воспроизведение запрошенного трека на 30 минут. Рекомендуется поставить задание с этой командой на повтор, например, каждые 10 минут в течение периода, когда вы хотите принимать заказы песен.

 

См. также команды API: songrequest, songrequestclear

weather city, country

Обновить данные о погоде, см. Автоматическое объявление погоды

 

Например: weather New York, US

setdtmfsource 1|2|3|URL

Установить источник для детектора DTMF.

1 - Вход 1

2 - Вход 2

3 - Вход 3

URL - указать URL потока

 

Пример: setdtmfsource http://example.com:8000

stopoverlays

Остановить все играющие задания "поверх эфира"

enablegroup GROUP

disablegroup GROUP

Включить (enablegroup) или выключить (disablegroup) группу заданий

 

GROUP - название группы, которую нужно включить/выключить. Могут быть указаны несколько групп, разделенные запятой, например, enablegroup Group 1, Group 2

enableevent EVENTNAME

disableevent EVENTNAME

Включить (enableevent) или выключить (disableevent) задание

 

EVENTNAME - имя задания

 

enableevent MyShow

runevent EVENTNAME|EVENTID

Запустить задание, в качестве параметра указывается название задания или его идентификатор

 

runevent MyShow - запустить задание по имени

runevent MMHDBYQSNUEF - запустить задание по идентификатору

enablevo

disablevo

Включить (enablevo) или выключить (disablevo) Войсдропы.

autointro [disable|enable] rule1, rule2, ...

Включить или выключить отдельные правила Авто интро. Названия правил не чувствительны к регистру.

 

Пример: выключить правила Утро и День

autointro disable Утро, День

 

Пример: включить правило Исполнитель

autointro enable Исполнитель

eqpreset NAME

Изменить пресет эквалайзера.

 

Пример: изменить пресет на "Rock"

eqpreset Rock

dsp enable|disable [index]

Включить или выключить DSP

 

Примеры:

dsp enable - включить все DSP

dsp enable 1 - включить DSP #1 в списке

dsp disable 1 - выключить DSP #1 в списке

playlist TABNAME

Изменить активную вкладку плейлиста. Если используется "Несколько действий" в задании, эта команда всегда исполняется первой, вне зависимости от позиции в списке действий.

 

Пример: изменить активный плейлист на вкладку "Main"

playlist Main

relaystart 1|2|3|URL

Начать ретрансляцию.

 

1 - Вход 1

2 - Вход 2

3 - Вход 3

URL - указать URL потока

 

Пример: ретранслировать сетевой поток

relaystart http://example.com/stream

 

Пример: ретранслировать line input 1

relaystart 1

relaystop

Остановить ретрансляцию.

resetplayedstate

Сбросить статус "проигранный трек" у треков в плейлисте.

 

 


Дополнительная информация

Планировщик

API для удаленного управления