Управление ботом через чат клиента

Биллинг > База знаний > TS3MusicBot > Управление ботом через чат клиента

Управление музыкальным ботом производится через чат TeamSpeak 3 клиента.

Синтаксис команды должен начинаться с восклицательного знака: !команда.

Некоторые команды имеют ограничения такие обработка только в чате сервера / чате канала / личном чате или наличием административных прав на сервере.

Список доступных команд:

add: Добавляет новый трек в очередь.

clear: Очистка очереди локального приватного плейлиста.

help: Показать все команды или детальную справку по заданной команде.

history: Показать какие треки играли ранее.

link: Получить ссылку на источник текущего трека.

loop: Показать статус режима проигрывания трека на повторе.

next: Включает следующий трек из плейлиста.

pause: Пауза трека. Продолжить воспроизведение через !play.

play: Воспроизвести трек. Попытка автоматического определения ссылки как ресурса (прим. Youtube) или прямого источника (прим. файл ./hello.mp3) и его запуск.

previous: Запуск предыдущего трека из плейлиста.

quiz: Включение режима скрытия информации о треках - сыграйте в игру "Угадай трек".

random: Проверка статуса режима проигрывания плейлистов в случайном порядке.

repeat: Проверка статуса режима проигрывания трека на повторе.

rng: Генерирует случайное число.

seek: Переход к временной метке текущего трека.

song: Получить информацию о текущем треке.

stop: Останавливает текущий трек.

subscribe: Включение режима прослушивания музыки вне зависимости от того в каком канале вы находитесь.

unsubscribe: Отключение режима прослушивания музыки вне зависимости от того в каком канале вы находитесь.

volume: Выставление уровня громкости музыки.

Базовые команды:

Синтакс команд
Каждая команда строится по следующей схеме:

!<команда> <опция1> <опция2> ...

Команда "Справка"
Если вы хотите получить справку по команде или ее опциям , то можете использовать следующую команду:

!help <команда>: для получения подробностей и опций

Опции
Некоторые команды используются в качестве опций, например:

!history play <номер>
!history rename <старое значение> <новое значение>
!history last
!history clean removedefective

и т.д.

Совпадение команд

В строке команд есть возможность допускать некоторые ошибки в корректности написания команд. Например:
!historyy lastt 10
!his la 10

// или даже

!higsndtor latuht 10

Все данные выше описанные строки соответствуют команде:
!history last 10

Данная опция работает благодоря алгоритму подбору команды по максимальному совпадений символов. В данном примере последнее слово совпадает по следующему фильтру: hi_s__tor lat___ по 6 символам в первой комманде и 3 символам во втором слове. Соответсвенно лучшее совпадение по команде history и опции last.

Однако команда !ahistory last 10 не попадает под данный алгоритм , т.к. команды начинающиеся на 'a' не найдено.

Экранирование
Перед пробелами между опциями вы должны экранировать строку кавычками , т.е.
!history rename 123 "Новое название песни"

Но, одиночная кавычка (без закрывания) не будет распознана как управляющий символ , а будет работать как обычный текстовый символ.
!bot name Funky"Name
Данная команда переименует бота в имя Funky"Name

Если же кавычка нужна в качестве символа, то можно заэкранировать его через обратный слеш:
!bot name "Funky\" \"Name"
Данная команда переименует бота в имя Funky" "Name

Добавить в избранное Распечатать статью

Также читают

Определение ID канала (просмотров: 3186)

Заказ музыкального бота (просмотров: 7124)

Работа с плейлистами (просмотров: 2133)

Описание музыкального бота (просмотров: 5588)

Основные команды бота (FAQ / Быстрый запуск) (просмотров: 7658)