Сервис чатов от Августа: качество, надежность, скорость
 
новости новостей нет» все новости

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

Документация

Боты

Увеличить функциональность чата можно с помощью функций-ботов. Отличие функций-ботов от остальных функций чата заключается в том, что боты находятся в чате как обычные посетители и имеют собственные имена, а вызов функций производится путем отправки сообщений в чат на имя бота.

Боты разбиты на две группы:

  1. медиа-боты — позволяют выводить в чат медиа-контент, такой как: музыка, катринки и видео.
  2. инфо-боты — позволяют получать такую информацию как: прогноз погоды, курс валют, перевод текста с одного языка на другой.

Разбиение ботов на группы позволяет более гибко манипулировать привилегиями пользователей для доступа к этим функциям.

Медиа-боты

Запросы на медиа-боты перенаправляются на сторонние сервера для поиска запрашиваемого медиа-контента. Так поиск музыки осуществляется на различных mp3-серверах, поиск видео осуществляется сервером www.youtube.com, поиск картинок — поисковиком www.google.com.

Т.к. поиск медиа-контента может выдавать более одного результата, то по результатам поиска формируется список. Для управления списком служат команды бота, команды начинаются с символа "." (точка) и следом указывается название команды.

Список команд медиа-ботов:

  • where/где — выводит список серверов, на которых осуществляется поиск;
  • list/лист — выводит текущую страницу списка из результата поиска, список всегда содержит не более 10 элементов;
  • page/страница — выводит следующую страницу списка из результата поиска;
  • next/еще — воспроизводит в чате следующий элемент из списка, для нового поиска воспроизведение всегда начинается с первого элемента списка;
  • число — воспроизводит произвольный элемент, номер должен совпадать с номером из списка.

Все медиа-боты имеют одинаковый синтаксис поиска и управления.

Инфо-боты

К ботам группы "инфо-боты" относятся следующие боты:

  • информер — выдает информацию о погоде и курсе валют.
  • переводчик — переводит текст.
  • калькулятор — производит вычисление выражений.

Боты группы "инфо-боты" не так однородны, как боты группы "медиа-боты" и для них не существует общих команд, но некоторым из них можно послать команду "?" (знак вопроса) для получения справки по командам.

Погода

Для получения информации о погоде необходимо информеру послать команду "погода название_города" или "weather название_города". Если не указывать город, то он будет вычислен автоматически на основании данных входа пользователя. Бывает, что информер выдает погоду в городе не той страны, которая ожидалась, это случается когда в разных странах имеются города с одним и тем же названием. Для такого случая необходимо информеру явно указать страну, в которой находится город, используя следующий синтаксис: "погода co:название_города", где co — двухбуквенное обозначение страны, например для России это ru, для США — us.

Курсы валют

Для получения курсов валют необходимо информеру послать команду "курс валюта" или "rate валюта", где валюта указывается трехбуквенным кодом. Чтобы получить все возможные коды, которые понимает информер, необходимо ему послать команду "валюта" или "currency".

Переводчик

Если язык оригинала — русский, то переводчик будет переводить текст на английский язык. Если язык оригинала не русский, то переводчик попытается сам определить язык, на котором написан текст и переведет его на русский язык. Кроме того, переводчику можно явно указать язык оригинала и язык перевода, для этого применяется следующий синтаксис: sl|tl|текст, где sl — код языка оригинала, tl — код языка перевода, коды языков перечислены на этой странице.

Калькулятор

Кроме возможности вычислять простые арифметические выражения в калькулятор встроены мощные механизмы для проведения сложных и длинных расчетов. Так, калькулятор снабжен памятью, в которую заносятся все ваши выражения и их результаты, это позволяет использовать результаты этих выражений в следующих выражениях. Также, каждое выражение можно снабдить комментарием и впоследствии проконтролировать ход всех вычислений. Но самое интересное в калькуляторе — это возможность задавать пользовательские функции, что значительно упрощает проведение сложных расчетов и уменьшает вероятность допустить ошибку.

Удобство пользования калькулятором наглядно можно продемонстрировать на примерах.

Пример 1, простой расчет, демонстрирует работу с памятью и комментарием.

August: калькулятор, 123 // первое число
калькулятор: August: $1 = 123
August: калькулятор, 789 // второе число
калькулятор: August: $2 = 789
August: калькулятор, $1+$2 // сумма
калькулятор: August: $3 = 912
August: калькулятор, $1-$2 // разность
калькулятор: August: $4 = -666
August: калькулятор, $1 / $2 // деление
калькулятор: August: $5 = 0.155894
August: калькулятор, $1 * $2 // умножение
калькулятор: August: $6 = 97047
August: калькулятор, .list
калькулятор: August:
    $1 = 123 // 123 // первое число
    $2 = 789 // 789 // второе число
    $3 = 912 // $1+$2 // сумма
    $4 = -666 // $1-$2 // разность
    $5 = 0.155894 // $1 / $2 // деление
    $6 = 97047 // $1 * $2 // умножение

В этом примере в память заносятся два числа и над ними производятся четыре математических действия

Пример 2, демонстрирует работу пользовательских функций.

August: калькулятор, .clear
калькулятор: August: список очищен
August: калькулятор, .def sh ( $1) = (e ^ $1 - e ^ (-$1)) / 2 // гиперболический синус
калькулятор: August: определена новая функция `sh`
August: калькулятор, .def ch ( $1) = (e ^ $1 + e ^ (-$1)) / 2 // гиперболический косинус
калькулятор: August: определена новая функция `ch`
August: калькулятор, .def
калькулятор: August:
    1: sh ( $1 ) = (e ^ $1 - e ^ (-$1)) / 2 // гиперболический синус
    2: ch ( $1 ) = (e ^ $1 + e ^ (-$1)) / 2 // гиперболический косинус
August: калькулятор, sh (1)
калькулятор: August: $1 = 1.175201
August: калькулятор, ch (1)
калькулятор: August: $2 = 1.543081
August: калькулятор, ch (pi)
калькулятор: August: $3 = 11.591953
August: калькулятор, .def sind ( $1 ) = sin ( pi * $1 / 180 ) // вычисление синуса угла, заданного в градусах
калькулятор: August: определена новая функция `sind`
August: калькулятор, sind (90)
калькулятор: August: $4 = 1
August: калькулятор, sind (30)
калькулятор: August: $5 = 0.5
August: калькулятор, sind (60)
калькулятор: August: $6 = 0.866025
August: калькулятор, sqrt (3) / 2
калькулятор: August: $7 = 0.866025
August: калькулятор, .def
калькулятор: August:
    1: sh ( $1 ) = (e ^ $1 - e ^ (-$1)) / 2 // гиперболический синус
    2: ch ( $1 ) = (e ^ $1 + e ^ (-$1)) / 2 // гиперболический косинус
    3: sind ( $1 ) = sin ( pi * $1 / 180 ) // вычисление синуса угла, заданного в градусах
August: калькулятор, .list
калькулятор: August:
    $1 = 1.175201 // sh (1)
    $2 = 1.543081 // ch (1)
    $3 = 11.591953 // ch (pi)
    $4 = 1 // sind (90)
    $5 = 0.5 // sind (30)
    $6 = 0.866025 // sind (60)
    $7 = 0.866025 // sqrt (3) / 2

Команды калькулятора:

  • .list/.лист — выводит результаты ваших выражений и сами выражения.
  • .def имя ( список_аргументов ) = выражение — определяет пользовательскую функцию с именем имя, список аргументов функции указывается через запятую, отсчет всегда от единицы, например, для функции, которая принимает три аргумента список должен выглядеть как ($1, $2, $3). Команда .def без параметров выводит список всех пользовательских функций.
  • .del имя — удаляет пользовательскую функцию с именем имя.
  • .clear/.reset/.очистить — очищает список выражений и список пользовательских функций.
  • .precision/.точность число — определяет точность, с которой выводятся результаты вычислений, число указывает, сколько знаков после запятой требуется выводить, максимальное значение равно 20.
  • .exp — включает/выключает вывод результатов в экспоненциальной форме.

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

Управление ботами может осуществлять только главный администратор чата. Для управления ботами используются четыре команды: запуск, остановка, стилизация и управление видимостью в комнатах.

Запуск ботов

Для запуска бота необходимо в чат передать команду:

/bot имя_бота start тип_бота
где:
  • имя_бота — любое имя, которые вы хотите дать боту.
  • тип_бота — какого типа бот должен быть запущен.

Допустимые типы ботов:

  • MUSIC — медиа-бот для поиска музыки.
  • YOUTUBE — медиа-бот для поиска видео.
  • IMAGES — медиа-бот для поиска картинок.
  • INFORMER — инфо-бот "информер".
  • TRANSLATOR — инфо-бот "переводчик".
  • CALC — инфо-бот "калькулятор".

В чате не допускается запускать несколько ботов одного типа.

Остановка ботов

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

/bot имя_бота stop
где:
  • имя_бота — имя бота, который находится в чате.

Стилизация ботов

Стилизация ботов позволяет задавать никам и фразам ботов любые цвета и шрифты. Для стилизации бота необходимо в чат передать команду:

/bot имя_бота setup параметры_стилизации
где:
  • имя_бота — имя бота, который находится в чате.
  • параметры_стилизации — такие параметры, как: nickcolor, nickfont, nickstyle, messcolor, messfont, messstyle, синтаксис полностью аналогичен синтаксису команды /setup.

Боты в других комнатах

Запуск ботов всегда произвоится только в одной комнате чата. Если в чате несколько комнат, то в них также можно установить ботов. Чтобы боты были доступны в других комнатах надо выполнить следующую команду:

/bot имя_бота room номер_комнаты
где:
  • имя_бота — имя бота, который находится в чате.
  • номер_комнаты — номер комнаты чата, номера комнат указаны в админке чата в разделе "комнаты". Допускается передавать сразу несколько номеров, номера должны указываться через пробел.

Повторное выполнение команды для той же комнаты отключит бота в этой комнате.

Боты в списке посетителей

Чтобы в списке посетителей боты не смешивались с другими пользователями чата, их можно посместить в отдельный список, для этого необходимо отредактировать шаблон "кто в чате" и указать в функции %CHAT("WHO", ... )% подсписок для ботов (подробнее об этой функции написано в документации Шаблон списка посетителей).

Пример определения функции списка:

%CHAT("WHO", %TABLE%, "<div class=tm>никого нет</div>",
    [
      1, "<div class=bm>мальчики</div>",
      2, "<div class=gm>девочки</div>",
      0, "<div class=nm>инкогнито</div>",
      3, "<div class=vm>на голосовании</div>",
      4, "<div class=nm>боты</div>"
    ],
    "анкета %%NICK%%",
    ""
)%

Обновление от 1.05.2020

С 1 мая 2020 года требуется получить индивидуальный ключ YouTube Data API для бота "YOUTUBE".

Инструкция
  1. Откройте страницу по адресу https://console.developers.google.com/, на странице необходимо принять Условия использования.
  2. Нажмите кнопку "СОЗДАТЬ ПРОЕКТ".
  3. Выберите произвольное название проекта, например "Youtube bot", местоположение — "без организации" => "СОЗДАТЬ".
  4. После создания проекта снова загрузится "Панель управления", на странице нажмите "ВКЛЮЧИТЬ API И СЕРВИСЫ".
  5. В библиотеке выберите "YouTube Data API v3".
  6. На следующей странице нажмите "ВКЛЮЧИТЬ".
  7. Загрузится страница "Общая информация", на ней нажмите кнопку "СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ".
  8. На странице "Учетные данные" установите следующие данные:
    • Какой API вы используете? — "YouTube Data API v3"
    • Откуда вы будете вызывать API? — "Веб-сервер"
    • К каким данным вы будете обращаться? — "Общедоступные данные"
    Нажмите кнопку "Выбрать тип учетных данных".
  9. Будет сгенерирован ключ API, нажмите кнопку "Готово".
  10. На странице "Учетные данные" отобразится таблица с сгенерированным ключом, нажмите на имя ключа (по умолчанию "Ключ API 1").
  11. Настройте следующие ограничения:
    • Допустимый тип приложений: IP-адреса
    • Принимать HTTP-запросы от серверов со следующими IP-адресами: "ДОБАВИТЬ ЭЛЕМЕНТ" => "Адрес" => 86.110.220.130 => "ГОТОВО".
    • Допустимые API: "Применить ограничения для ключа" => выбрать "YouTube Data API v3".
    Нажмите кнопку "СОХРАНИТЬ".
  12. Скопируйте ключ и сохраните его в админке.

© August 2000–2024

Пользовательское соглашение   
www.megastock.ru