API (酷Q SDK 帮助手册)

```
public interface API
```

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`int`	`addLog(Log_ 优先级, string 类型, string 内容)` 增加运行日志
`int`	`deleteMsg(long MsgId)` 撤回消息 Auth=180
`string`	`getAppDirectory()` 取应用目录,返回的路径末尾带"\"
`int`	`getAuthCode()` 获取调用api所需的AuthCode.
`string`	`getCookies()` 取Cookies Auth=20 慎用,此接口需要严格授权
`int`	`getCsrfToken()` 取CsrfToken (慎用，此接口需要严格授权) Auth=20 即QQ网页用到的bkn/g_tk等慎用,此接口需要严格授权
`map<java.lang.Long,string>`	`getGroupList()` 取群列表 Auth=161
`GroupMemberInfo`	`getGroupMemberInfo(long 群号, long QQID, boolean 不使用缓存)` 取群成员信息 (支持缓存) Auth=130
`vector<GroupMemberInfo>`	`getGroupMemberList(long 群号)` 取群成员列表 Auth=160
`string`	`getlasterrmsg()` 如果API调用返回错误代码, 则可以使用本函数获取相关中文信息
`string`	`getLoginNick()` 取登录昵称
`long`	`getLoginQQ()` 取登录QQ
`string`	`getRecord(string file, string outformat)` 接收消息中的语音(record) Auth=30 返回保存在 \data\record\ 目录下的文件名 //getRecord
`StrangerInfo`	`getStrangerInfo(long QQID, boolean 不使用缓存)` 取陌生人信息 (支持缓存) Auth=131
`int`	`sendDiscussMsg(long 讨论组号, string msg)` 发送讨论组消息 Auth=103 失败返回负值,成功返回消息ID
`int`	`sendGroupMsg(long 群号, string msg)` 发送群消息 Auth=101 失败返回负值,成功返回消息ID
`int`	`sendLike(long QQID, int times)` 发送赞 Auth=110
`int`	`sendPrivateMsg(long QQ, string msg)` 发送好友消息 Auth=106, 失败返回负值,成功返回消息ID.
`int`	`setDiscussLeave(long 讨论组号)` 置讨论组退出 Auth=140
`int`	`setFatal(string 错误信息)` 置致命错误提示,暂时不知道干什么用的
`int`	`setFriendAddRequest(string 请求反馈标识, int 反馈类型, string 备注)` 置好友添加请求 Auth=150
`int`	`setGroupAddRequest(string 请求反馈标识, int 请求类型, int 反馈类型, string 理由)` 置群添加请求 Auth=151
`int`	`setGroupAdmin(long 群号, long QQID, boolean 成为管理员)` 置群管理员 Auth=122
`int`	`setGroupAnonymous(long 群号, boolean 开启匿名)` 置群匿名设置 Auth=125
`int`	`setGroupAnonymousBan(long 群号, string 匿名, long 禁言时间)` 置匿名群员禁言 Auth=124
`int`	`setGroupBan(long 群号, long QQID, long 禁言时间)` 置群员禁言 Auth=121
`int`	`setGroupCard(long 群号, long QQID, string 新名片_昵称)` 置群成员名片 Auth=126
`int`	`setGroupKick(long 群号, long QQID, boolean 拒绝再加群)` 置群员移除 Auth=120
`int`	`setGroupLeave(long 群号, boolean 是否解散)` 置群退出 Auth=127 慎用,此接口需要严格授权
`int`	`setGroupSpecialTitle(long 群号, long QQID, string 头衔, long 有效期)` 置群成员专属头衔 Auth=128 需群主权限
`int`	`setGroupWholeBan(long 群号, boolean 开启禁言)` 置全群禁言 Auth=123

- 方法详细资料
  - getAuthCode
```
int getAuthCode()
```
    获取调用api所需的AuthCode. 一般情况不需要调用
    
    返回:
    
    AuthCode
  - addLog
```
int addLog(Log_ 优先级,
           string 类型,
           string 内容)
```
    增加运行日志
    
    参数:
    
    优先级 - 整数型.具体查看枚举,可以直接使用枚举名称
    
    类型 - void
    
    内容 - void
    
    返回:
    
    秘制返回
  - setFatal
```
int setFatal(string 错误信息)
```
    置致命错误提示,暂时不知道干什么用的
    
    参数:
    
    错误信息 - 错误信息
    
    返回:
    
    秘制返回
  - sendPrivateMsg
```
int sendPrivateMsg(long QQ,
                   string msg)
```
    发送好友消息 Auth=106, 失败返回负值,成功返回消息ID.
    
    参数:
    
    QQ - void
    
    msg - void
    
    返回:
    
    失败返回负值,成功返回消息ID
  - sendGroupMsg
```
int sendGroupMsg(long 群号,
                 string msg)
```
    发送群消息 Auth=101 失败返回负值,成功返回消息ID
    
    参数:
    
    群号 - void
    
    msg - void
    
    返回:
    
    失败返回负值,成功返回消息ID
  - sendDiscussMsg
```
int sendDiscussMsg(long 讨论组号,
                   string msg)
```
    发送讨论组消息 Auth=103 失败返回负值,成功返回消息ID
    
    参数:
    
    讨论组号 - 讨论组号
    
    msg - 消息主体
    
    返回:
    
    失败返回负值,成功返回消息ID
  - sendLike
```
int sendLike(long QQID,
             int times)
```
    发送赞 Auth=110
    
    参数:
    
    QQID - QQID
    
    times - 次数
    
    返回:
    
    void
  - getCookies
```
string getCookies()
```
    取Cookies Auth=20 慎用,此接口需要严格授权
    
    返回:
    
    Cookies
  - getRecord
```
string getRecord(string file,
                 string outformat)
```
    接收消息中的语音(record) Auth=30 返回保存在 \data\record\ 目录下的文件名 //getRecord
    
    参数:
    
    file - 收到消息中的语音文件名 (file)
    
    outformat - 应用所需的格式 mp3,amr,wma,m4a,spx,ogg,wav,flac
    
    返回:
    
    文件名文件位于(酷Q\data\record\)
  - getCsrfToken
```
int getCsrfToken()
```
    取CsrfToken (慎用，此接口需要严格授权) Auth=20 即QQ网页用到的bkn/g_tk等慎用,此接口需要严格授权
    
    返回:
    
    CsrfToken
  - getAppDirectory
```
string getAppDirectory()
```
    取应用目录,返回的路径末尾带"\"
    
    返回:
    
    应用目录
  - getLoginQQ
```
long getLoginQQ()
```
    取登录QQ
    
    返回:
    
    登录QQ
  - getLoginNick
```
string getLoginNick()
```
    取登录昵称
    
    返回:
    
    登录昵称
  - setGroupKick
```
int setGroupKick(long 群号,
                 long QQID,
                 boolean 拒绝再加群)
```
    置群员移除 Auth=120
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    拒绝再加群 - 可以不填,默认为假,如果为真，则“不再接收此人加群申请”，请慎用
    
    返回:
    
    秘制返回
  - setGroupBan
```
int setGroupBan(long 群号,
                long QQID,
                long 禁言时间)
```
    置群员禁言 Auth=121
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    禁言时间 - 可以不填,默认60秒,单位为秒。如果要解禁，这里填写0
    
    返回:
    
    秘制返回
  - setGroupAdmin
```
int setGroupAdmin(long 群号,
                  long QQID,
                  boolean 成为管理员)
```
    置群管理员 Auth=122
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    成为管理员 - 默认为真,假为取消管理
    
    返回:
    
    秘制返回
  - setGroupSpecialTitle
```
int setGroupSpecialTitle(long 群号,
                         long QQID,
                         string 头衔,
                         long 有效期)
```
    置群成员专属头衔 Auth=128 需群主权限
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    头衔 - 如果要删除，这里填空
    
    有效期 - 默认为永久(-1),单位为秒。
    
    返回:
    
    秘制返回
  - setGroupWholeBan
```
int setGroupWholeBan(long 群号,
                     boolean 开启禁言)
```
    置全群禁言 Auth=123
    
    参数:
    
    群号 - 群号
    
    开启禁言 - 默认为真,假为解除禁言
    
    返回:
    
    秘制返回
  - setGroupAnonymousBan
```
int setGroupAnonymousBan(long 群号,
                         string 匿名,
                         long 禁言时间)
```
    置匿名群员禁言 Auth=124
    
    参数:
    
    群号 - 群号
    
    匿名 - 群消息事件收到的“匿名”参数
    
    禁言时间 - 默认60秒,不支持解禁
    
    返回:
    
    秘制返回
  - setGroupAnonymous
```
int setGroupAnonymous(long 群号,
                      boolean 开启匿名)
```
    置群匿名设置 Auth=125
    
    参数:
    
    群号 - 群号
    
    开启匿名 - 真为开启,假为关闭
    
    返回:
    
    秘制返回
  - setGroupCard
```
int setGroupCard(long 群号,
                 long QQID,
                 string 新名片_昵称)
```
    置群成员名片 Auth=126
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    新名片_昵称 - 新名片_昵称
    
    返回:
    
    秘制返回
  - setGroupLeave
```
int setGroupLeave(long 群号,
                  boolean 是否解散)
```
    置群退出 Auth=127 慎用,此接口需要严格授权
    
    参数:
    
    群号 - 群号
    
    是否解散 - 默认为假,真/解散本群 (群主),假/退出本群 (管理、群成员)
    
    返回:
    
    秘制返回
  - setDiscussLeave
```
int setDiscussLeave(long 讨论组号)
```
    置讨论组退出 Auth=140
    
    参数:
    
    讨论组号 - 讨论组号
    
    返回:
    
    秘制返回
  - setFriendAddRequest
```
int setFriendAddRequest(string 请求反馈标识,
                        int 反馈类型,
                        string 备注)
```
    置好友添加请求 Auth=150
    
    参数:
    
    请求反馈标识 - 请求事件收到的“反馈标识”参数
    
    反馈类型 - #请求_通过或 #请求_拒绝
    
    备注 - 添加后的好友备注
    
    返回:
    
    秘制返回
  - setGroupAddRequest
```
int setGroupAddRequest(string 请求反馈标识,
                       int 请求类型,
                       int 反馈类型,
                       string 理由)
```
    置群添加请求 Auth=151
    
    参数:
    
    请求反馈标识 - 请求事件收到的“反馈标识”参数
    
    请求类型 - 根据请求事件的子类型区分 #请求_群添加或 #请求_群邀请
    
    反馈类型 - #请求_通过或 #请求_拒绝
    
    理由 - 操作理由，仅 #请求_群添加且 #请求_拒绝时可用
    
    返回:
    
    秘制返回
  - getGroupMemberInfo
```
GroupMemberInfo getGroupMemberInfo(long 群号,
                                   long QQID,
                                   boolean 不使用缓存)
```
    取群成员信息 (支持缓存) Auth=130
    
    参数:
    
    群号 - 群号
    
    QQID - QQID
    
    不使用缓存 - 默认为假
    
    返回:
    
    秘制返回
  - getStrangerInfo
```
StrangerInfo getStrangerInfo(long QQID,
                             boolean 不使用缓存)
```
    取陌生人信息 (支持缓存) Auth=131
    
    参数:
    
    QQID - QQID
    
    不使用缓存 - 强制获取最新信息,多次调用可能会冻结QQ,默认为假
    
    返回:
    
    陌生人信息
  - getGroupMemberList
```
vector<GroupMemberInfo> getGroupMemberList(long 群号)
```
    取群成员列表 Auth=160
    
    参数:
    
    群号 - 群号
    
    返回:
    
    群成员列表
  - getGroupList
```
map<java.lang.Long,string> getGroupList()
```
    取群列表 Auth=161
    
    返回:
    
    Map[群号,群名称]
  - deleteMsg
```
int deleteMsg(long MsgId)
```
    撤回消息 Auth=180
    
    参数:
    
    MsgId - MsgId
    
    返回:
    
    秘制返回
  - getlasterrmsg
```
string getlasterrmsg()
```
    如果API调用返回错误代码, 则可以使用本函数获取相关中文信息
    
    返回:
    
    错误代码关联的中文信息

接口 API

方法概要

方法详细资料

getAuthCode

addLog

setFatal

sendPrivateMsg

sendGroupMsg

sendDiscussMsg

sendLike

getCookies

getRecord

getCsrfToken

getAppDirectory

getLoginQQ

getLoginNick

setGroupKick

setGroupBan

setGroupAdmin

setGroupSpecialTitle

setGroupWholeBan

setGroupAnonymousBan

setGroupAnonymous

setGroupCard

setGroupLeave

setDiscussLeave

setFriendAddRequest

setGroupAddRequest

getGroupMemberInfo

getStrangerInfo

getGroupMemberList

getGroupList

deleteMsg

getlasterrmsg