# botjava

**Repository Path**: wenjasx/botjava

## Basic Information

- **Project Name**: botjava
- **Description**: QQ机器人SDK
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-04-04
- **Last Updated**: 2023-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JavaSDK 接入指南

## 介绍

`JavaSDK`主要基于[基础 API](https://bot.q.qq.com/wiki/develop/api/)封装，提供给用户一种简单、高效的使用方式。

## 安装 

在项目的pom.xml的dependencies中加入以下内容:

```xml
<dependency>
    <groupId>io.gitee.geminidev.bot</groupId>
    <artifactId>botjava</artifactId>
    <version>0.0.2-SNAPSHOT</version>
</dependency>
```



## 使用示例

使用前请先确保已在机器人平台[创建机器人 (opens new window)](https://bot.q.qq.com/wiki/#_4-创建机器人)，并拿到相应的`BotAppID`及`BotToken`。

```java
import io.gitee.geminidev.bot.domain.MessageResponse;
import io.gitee.geminidev.bot.type.Code;
import io.gitee.geminidev.bot.type.IntentType;

/**
 * @Author Gemini
 * @Date 2023/4/2 22:14
 * @description: 使用示例
 */
public class Main {
    public static void main(String[] args) {
        Bot bot = BotFactory.createBot(
                "APPID", // 申请机器人时获取到的机器人 BotAppID
                "TOKEN", // 申请机器人时获取到的机器人令牌
                false // 沙箱支持，可选，默认false
        );
        bot.intents(IntentType.GUILDS,
                        IntentType.GUILD_MEMBERS,
                        IntentType.GUILD_MESSAGE_REACTIONS,
                        IntentType.OPEN_FORUMS_EVENT,
                        IntentType.AUDIO_OR_LIVE_CHANNEL_MEMBER,
                        IntentType.INTERACTION,
                        IntentType.AUDIO_ACTION,
                        IntentType.GUILD_MESSAGES)
                .onReady(message -> Code.CONTINUE)
                .onGuildCreate(message -> {
                    System.out.println(message.getDescription());
                    return Code.CONTINUE;
                })
                .onChannelCreate(message -> {
                    System.out.println(message.getGuild_id());
                    return Code.CONTINUE;
                })
                .onMessageCreate(message -> {
                    MessageResponse content = MessageResponse.create().messageReference(message.getId())
                            .content(String.format("收到频道消息: %s", message.getContent()));
                    bot.messageApi().sendMessage(message.getChannelId(), content);
                    return Code.CONTINUE;
                })
                .onAtMessageCreate(message -> {
                    MessageResponse content = MessageResponse.create().messageReference(message.getId())
                            .content(String.format("收到频道At消息: %s", message.getContent()));
                    bot.messageApi().sendMessage(message.getChannelId(), content);
                    return Code.CONTINUE;
                })
                .start();
    }
}
```

Run 启动后可在频道中艾特机器人发送消息，机器人即可回复