Java-разработка с использованием simple-robot и плагина LEMOC

Для лучшего чтения документации перейдите к оригинальному документу -> компоненты - CoolQ - LEMOC -> быстрый старт или попробуйте перейти непосредственно к быстрому старту

Нажмите правой кнопкой мыши на значок проекта в верхнем углу справа и выберите star, чтобы открыть полную документацию

Быстрый старт

1. Установка

1. Загрузка и установка CoolQ

Перейдите на страницу официальной загрузки CoolQ, скачайте приложение и установите его (запустив хотя бы один раз), затем закройте.### 2. Загрузка и установка плагина LEMOC 1. Перейдите на страницу сообщества LEMOC и загрузите последнюю версию. 2. Переместите скачанный файл .cpk в папку /app корневого каталога CoolQ. 3. Запустите программу CoolQ один раз, щелкните правой кнопкой мыши на значок CoolQ и выберите: Приложения > Управление приложениями, как показано на следующих изображениях: Затем откроется окно управления приложениями, где вы можете выбрать плагин LEMOC и активировать его, как показано ниже: >[успех] Интерфейс конфигурации LEMOC очень прост (хотя возможны проблемы совместимости).

3. Создание Java-проекта

Вы можете использовать любую поддерживаемую среду для автоматической сборки проекта, далее приведены примеры:>[информация] Убедитесь, что заменили номер версии на последнюю доступную в Maven репозитории:

1. Maven

<dependency>
  <groupId>io.github.ForteScarlet.simple-robot-core</groupId>
  <artifactId>component-forlemoc</artifactId>
  <version>${version}</version>
</dependency>

2. Gradle

implementation 'io.github.ForteScarlet.simple-robot-core:component-forlemoc:${version}'

3. Grape

@Grapes(
  @Grab(group='io.github.ForteScarlet.simple-robot-core', module='component-forlemoc', version='${version}')
)

4. Настройка

Необходимо выполнить две настройки:

• Конфигурация LEMOC
• Начальная конфигурация Java программы

Давайте начнем с конфигурации Java.

[предупреждение] В связи с тем, что текущие файловые конфигурации пока сложны, мы временно ограничимся описанием конфигураций через код. Если вас интересует более сложная файловая конфигурация, пожалуйста, прочтите этот раздел после изучения конфигураций через код.

Сначала создайте класс, реализующий интерфейс com.forte.qqrobot.component.forlemoc.LemocApp, и реализуйте методы before и after.

[информация] Предположим, что ваш класс называется RunApp, чтобы было удобнее ссылаться на него. Конечно, это имя может быть любым.Вы заметили, что в методе before есть параметр LinkConfiguration. Именно через этот объект вы будете выполнять настройки. Основные настройки в этом объекте следующие:

// Получение IP адреса для соединения, то есть IP адрес LEMOC, по умолчанию localhost
setLinkIp(String linkIp);
// Номер порта для соединения, по умолчанию 25303
setPort(Integer port);
// Установка QQ номера бота
setLocalQQCode(String qqcode);
// Установка псевдонима бота
setLocalQQNick(String nick);

[success] Эти настройки довольно просты. Вернитесь к интерфейсу конфигурации LEMOC, и вы уже должны знать, как правильно их заполнить!

Да, просто установите номер порта соединения таким же, как и в настройках LEMOC, а также укажите IP адрес LEMOC.

5. Запуск

После всех усилий наконец пришло время запустить программу. Сначала настройте ваши данные в плагине LEMOC. Затем создайте метод main, где угодно. Добавьте следующий код, помня, что RunApp представляет собой конкретный класс вашего проекта.```java LemocApplication application = new LemocApplication(); // Запуск application.run(new RunApp());

>[success] Если в это время в консоли появится сообщение "соединение успешно" и нет ошибок, то значит WS соединение установлено успешно. В текущей версии LEMOC компонентной системы автоматическое получение информации о роботе не поддерживается, поэтому потребуется вручную настроить `LinkConfiguration`.Можно ли прослушивать сообщения? Давайте напишем несколько строк кода для проверки.

## **6\. Первый слушатель**

### **①. Создание нового класса**

>[info] По возможности создайте этот класс в одном уровне с `RunApp` или ниже.
> После создания пометьте его аннотацией: `@com.forte.qqrobot.anno.depend.Beans`, то есть `@Beans`.

### **②. Написание метода для прослушивания приватных сообщений**

Напишите метод для прослушивания приватных сообщений, удовлетворяющих регулярному выражению: `hello.*`. Когда вы получаете сообщение, повторите его.
Полный код представлен ниже:

```java
@Beans
public class TestListener {

    @Listen(MsgGetTypes.privateMsg)
    @Filter("hello.*")
    public void testListen1(PrivateMsg msg, MsgSender sender) {
        System.out.println(msg);
        // Ниже приведены три способа отправки ответа, все они эквивалентны
        sender.SENDER.sendPrivateMsg(msg, msg.getMsg());
//        sender.SENDER.sendPrivateMsg(msg.getQQ(), msg.getMsg());
//        sender.SENDER.sendPrivateMsg(msg.getQQCode(), msg.getMsg());
    }
}

③. Попробуйте еще раз

Снова запустите приложение. Если в логах успешной загрузки будет указан этот слушатель, попробуйте послать своему роботу сообщение hello world. Если он также отвечает вам сообщением hello world, то значит вы добились успеха. Теперь исследуйте предоставленные документами различные функции и реализуйте своего робота!

**7. Неудача?**Если вы последовали всем шагам и столкнулись с проблемой, не расстраивайтесь. Попробуйте найти решение в разделе часто задаваемых вопросов или присоединитесь к QQ группе 782930037 для получения помощи.