mirror of
https://gitee.com/hotlcc/wechat4j.git
synced 2025-06-08 03:24:09 +08:00
80 lines
2.9 KiB
Markdown
80 lines
2.9 KiB
Markdown
# wechat4j
|
||
|
||
> 一个基于Web微信API的Java版微信客户端
|
||
|
||
作者：Allen
|
||
|
||
码云主页：[https://gitee.com/hotlcc](https://gitee.com/hotlcc)
|
||
|
||
[](https://gitee.com/hotlcc)
|
||
[](https://github.com/hotlcc)
|
||
[](https://www.toutiao.com/c/user/3341863552/#mid=51655113888)
|
||
[](https://weibo.com/hotloveu?is_hot=1)
|
||
[](http://www.apache.org/licenses/LICENSE-2.0.html)
|
||
|
||
## Web微信API文档
|
||
|
||
详见：[Web微信API文档](doc/web-weixin-api.md)
|
||
|
||
## 简单使用
|
||
|
||
```java
|
||
WebWeixinApi api = new WebWeixinApi();
|
||
// 实例化微信客户端
|
||
Wechat wechat = new Wechat();
|
||
wechat.setWebWeixinApi(api);
|
||
// 自动登录
|
||
wechat.autoLogin();
|
||
```
|
||
|
||
## 发送消息
|
||
|
||
### 文本消息
|
||
|
||
```java
|
||
// 通过userName发送文本消息
|
||
JSONObject sendText(String content, String userName);
|
||
// 通过昵称发送文本消息
|
||
JSONObject sendTextToNickName(String content, String nickName);
|
||
// 通过备注名发送文本消息
|
||
JSONObject sendTextToRemarkName(String content, String remarkName);
|
||
// 发送文本消息（根据多种名称）
|
||
JSONObject sendText(String userName, String nickName, String remarkName, String content);
|
||
```
|
||
|
||
### 图片消息
|
||
|
||
```java
|
||
// 通过userName发送图片消息
|
||
JSONObject sendImage(String userName, byte[] mediaData, String mediaName, ContentType contentType);
|
||
JSONObject sendImage(String userName, File image);
|
||
// 通过昵称发送图片消息
|
||
JSONObject sendImageToNickName(String nickName, byte[] mediaData, String mediaName, ContentType contentType);
|
||
JSONObject sendImageToNickName(String nickName, File image);
|
||
// 通过备注名发送图片消息
|
||
JSONObject sendImageToRemarkName(String remarkName, byte[] mediaData, String mediaName, ContentType contentType);
|
||
JSONObject sendImageToRemarkName(String remarkName, File image);
|
||
// 发送图片消息（根据多种名称）
|
||
JSONObject sendImage(String userName, String nickName, String remarkName, byte[] mediaData, String mediaName, ContentType contentType);
|
||
JSONObject sendImage(String userName, String nickName, String remarkName, File image);
|
||
```
|
||
|
||
> 更多消息类型支持尽请期待。
|
||
|
||
## 消息处理器
|
||
|
||
> 通过在实例化时添加消息处理器来处理接收到的消息<br>
|
||
> 消息处理器需要实现`ReceivedMsgHandler`接口
|
||
|
||
```java
|
||
wechat.addReceivedMsgHandler(new ReceivedMsgHandler() {
|
||
@Override
|
||
public void handleAllType(Wechat wechat, ReceivedMsg msg) {
|
||
UserInfo contact = wechat.getContactByUserName(false, msg.getFromUserName());
|
||
String name = StringUtil.isEmpty(contact.getRemarkName()) ? contact.getNickName() : contact.getRemarkName();
|
||
System.out.println(name + ": " + msg.getContent());
|
||
}
|
||
});
|
||
```
|
||
|