# ChatApi-QQ

**Repository Path**: webget/ChatApi-QQ

## Basic Information

- **Project Name**: ChatApi-QQ
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-03-21
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WebQQ已于2019年1月1日停止运营，本项目代码无法再使用，将停止更新，感谢大家一直以来的支持。

# ChatApi-QQ
Java版本QQ聊天接口，使用网页QQAPI，让你能够开发自己的QQ聊天机器人。

Java版本微信聊天接口请看[ChatApi-WeChat](https://github.com/xuxiaoxiao-xxx/ChatApi-WeChat)

## 有何优点？
* 对接口、流程、实体类进行了封装，更加简单易用
* 暴露了一个监听器，可以自己实现监听器以开发自己的业务功能
* 网页版QQ全部功能的支持
    * 监听好友、群、讨论组消息
    * 向好友、群、讨论组发送消息
    * 改变登录状态

## 测试数据
* 最后测试可用时间：2018-06-10
* 最长在线时间：5天

## 如何使用
* maven依赖

```xml
<dependency>
    <groupId>me.xuxiaoxiao</groupId>
    <artifactId>chatapi-qq</artifactId>
    <version>1.1.0</version>
</dependency>
```

* gradle依赖

```gradle
implementation 'me.xuxiaoxiao:chatapi-qq:1.1.0'
```

* jar包

[点击进入下载页](https://github.com/xuxiaoxiao-xxx/ChatApi-QQ/releases)

* 以下是一个学别人说话的小机器人，用到了该库提供的大部分功能
```java

public class QQDemo {
    
    public static final QQClient QQ_CLIENT = new QQClient(new QQClient.QQChatListener() {
        @Override
        public void onQRCode(File qrCode) {
            System.out.println(String.format("获取到登录二维码：%s", qrCode.getAbsolutePath()));
        }
        
        @Override
        public void onAvatar(String base64Avatar) {
            System.out.println(String.format("获取到用户头像：%s", base64Avatar));
        }
        
        @Override
        public void onException(String reason) {
            System.out.println(String.format("程序异常：%s", reason));
        }
        
        @Override
        public void onLogin() {
            System.out.println("登录成功");
        }
        
        @Override
        public void onMessage(QQMessage qqMessage) {
            System.out.println(QQTools.GSON.toJson(qqMessage));
            if (qqMessage.fromGroup != null && qqMessage.fromGroupMember.id != QQ_CLIENT.userMe().id) {
                QQ_CLIENT.sendText(qqMessage.fromGroup, qqMessage.content);
            }
            if (qqMessage.fromDiscuss != null && qqMessage.fromDiscussMember.id != QQ_CLIENT.userMe().id) {
                QQ_CLIENT.sendText(qqMessage.fromDiscuss, qqMessage.content);
            }
            if (qqMessage.fromUser != null && qqMessage.fromUser.id != QQ_CLIENT.userMe().id) {
                QQ_CLIENT.sendText(qqMessage.fromUser, qqMessage.content);
            }
        }
        
        @Override
        public void onLogout() {
            System.out.println("退出登录");
        }
    });
    
    public static void main(String[] args) {
        QQ_CLIENT.startup();
        Scanner scanner = new Scanner(System.in);
        while (true) {
            System.out.println("请输入指令");
            switch (scanner.nextLine()) {
                case "sendFriend": {
                    System.out.println("friendId:");
                    long friendId = Long.parseLong(scanner.nextLine());
                    System.out.println("content:");
                    String content = scanner.nextLine();
                    QQ_CLIENT.sendText(QQ_CLIENT.userFriend(friendId), content);
                }
                break;
                case "sendGroup": {
                    System.out.println("groupId:");
                    long groupId = Long.parseLong(scanner.nextLine());
                    System.out.println("content:");
                    String content = scanner.nextLine();
                    QQ_CLIENT.sendText(QQ_CLIENT.userGroup(groupId), content);
                }
                break;
                case "sendDiscuss": {
                    System.out.println("discussId:");
                    long discussId = Long.parseLong(scanner.nextLine());
                    System.out.println("content:");
                    String content = scanner.nextLine();
                    QQ_CLIENT.sendText(QQ_CLIENT.userDiscuss(discussId), content);
                }
                break;
                case "quit":
                    System.out.println("logging out");
                    QQ_CLIENT.shutdown();
                    return;
                default:
                    System.out.println("未知指令");
                    break;
            }
        }
    }
}

```