// 设置ip端口，连接超时时长
SocketClient socketClient = new SocketClient(new SocketClientAddress("127.0.0.1", "21998", 15 * 1000));

// 设置发送和接收String消息的默认编码，若为空无法发送string类型的信息，若不为空在接收时将自动尝试转换byte[]为string
socketClient.setCharsetName("UTF-8");

// 设置自动发送的包头信息
socketClient.getSocketPacketHelper().setSendHeaderData(CharsetUtil.stringToData("Header:", "UTF-8"));

// 设置自动发送的包尾信息
socketClient.getSocketPacketHelper().setSendTrailerData(new byte[]{0x13, 0x10});

// 设置将（包正文与包尾长度之和）转换为byte[]的转换器，此部分由通信双方自定义协议
socketClient.getSocketPacketHelper().setSendPacketLengthDataConvertor(new SocketPacketHelper.SendPacketLengthDataConvertor() {
    @Override
    public byte[] obtainSendPacketLengthDataForPacketLength(SocketPacketHelper helper, int packetLength) {
        byte[] data = new byte[4];
        data[3] = (byte) (packetLength & 0xFF);
        data[2] = (byte) ((packetLength >> 8) & 0xFF);
        data[1] = (byte) ((packetLength >> 16) & 0xFF);
        data[0] = (byte) ((packetLength >> 24) & 0xFF);
        return data;
    }
});

// 设置发送正文的分段长度，用于回调显示进度
socketClient.getSocketPacketHelper().setSendSegmentLength(1);

// 设置是否分段发送正文
socketClient.getSocketPacketHelper().setSendSegmentEnabled(true);

SocketClient socketClient = new SocketClient(new SocketClientAddress("192.168.1.1", 80, 15 * 1000)); // 设置ip端口，连接超时时长
socketClient.registerSocketClientDelegate(new SocketClientDelegate() {
     @Override
     public void onConnected(SocketClient client) {
         SocketPacket packet = socketClient.sendData(new byte[]{0x02}); // 发送消息
         packet = socketClient.sendString("sy hi!"); // 发送消息

         socketClient.cancelSend(packet); // 取消发送，若在等待发送队列中则从队列中移除，若已发送完成则无法取消，若正在发送且分段发送则取消发送剩余数据（此时若没有设置包头用于远程端判断下一个信息包的开始可能出现粘包或数据不全问题）
     }

     @Override
     public void onDisconnected(SocketClient client) {
        // 断开连接回调，可在此实现自动重连
        socketClient.connect();
     }

     @Override
     public void onResponse(SocketClient client, @NonNull SocketResponsePacket responsePacket) {
        byte[] data = responsePacket.getData(); // 获取接收的byte数组，不为null
        String message = responsePacket.getMessage(); // 获取按默认设置的编码转化的String，可能为null
     }
 });

socketClient.getAddress().setRemoteIP("192.168.1.123"); // 设置IP
socketClient.getAddress().setRemotePort(8080); // 设置端口
socketClient.getAddress().setConnectionTimeout(30 * 1000); // 设置连接超时时长

socketClient.setCharsetName("UTF-8"); // 设置发送和接收String消息的默认编码

socketClient.getHeartBeatHelper().setHeartBeatInterval(1000 * 30); // 设置自动发送心跳包的时间间隔，若值小于0则不发送心跳包
socketClient.getHeartBeatHelper().setRemoteNoReplyAliveTimeout(1000 * 60); // 设置远程端多长时间内没有消息发送到本地就自动断开连接，若值小于0则不自动断开

socketClient.getHeartBeatHelper().setSendString("$HB$"); // 设置自动发送心跳包的字符串，若为null则不发送心跳包
socketClient.getHeartBeatHelper().setSendData("$HB$".getBytes()); // 同上

socketClient.getHeartBeatHelper().setReceiveString("$HB$"); // 设置从远程端接收的心跳包字符串，onResponse回调将过滤此信息，若为null则不过滤
socketClient.getHeartBeatHelper().setReceiveData("$HB$".getBytes()); // 同上

socketClient.getSocketPacketHelper().setSendHeaderData(new byte[]{0x02}); // 设置发送消息时自动在消息头部添加的信息，远程端收到此信息后表示一条消息开始，用于解决粘包分包问题，若为null则不添加头部信息
socketClient.getSocketPacketHelper().setSendTrailerString("\r\n"); // 设置发送消息时自动在消息尾部添加的信息，远程端收到此信息后表示一条消息结束，用于解决粘包分包问题，若为null则不添加尾部信息
socketClient.getSocketPacketHelper().setReceiveHeaderData(new byte[]{0x02}); // 设置接收消息时判断消息开始的头部信息，用于解决粘包分包问题，若为null则不判断
socketClient.getSocketPacketHelper().setReceiveTrailerString("\r\n"); // 设置接收消息时判断消息结束的尾部信息，用于解决粘包分包问题，若为null则每次读取InputStream直到其为空，可能出现粘包问题

socketClient.getSocketPacketHelper().setSegmentLength(4 * 1024); // 设置每次发送消息的分段长度，即20KB的数据将分段为4KB分5次发送，每次发送完一段都会回调发送的进度

socketClient.registerSocketClientSendingDelegate(new SocketClientSendingDelegate() {
    @Override
    public void onSendPacketBegin(SocketClient client, SocketPacket packet) {
        // 数据包发送开始，packet为调用send方法的返回值
    }

    @Override
    public void onSendPacketCancel(SocketClient client, SocketPacket packet) {
        // 数据包发送撤销，packet为调用send方法的返回值，此回调表示撤销成功
    }

    @Override
    public void onSendPacketEnd(SocketClient client, SocketPacket packet) {
        // 数据包发送结束，packet为调用send方法的返回值
    }

    @Override
    public void onSendPacketProgress(SocketClient client, SocketPacket packet, float progress) {
        // 数据包发送进度，packet为调用send方法的返回值，progress值为0-1
    }
});

socketClient.connect(); // 连接，异步进行

socketClient.disconnect(); // 断开连接

socketClient.getState(); // 获取当前状态，Connecting, Connected, Disconnected