IQQCoreService
IQQCoreService 主要提供QQ服务的接口。view in github 主要有以下几部分: 账号管理、 好友管理、 讨论组管理、 群管理、 机器人管理。其API如下:
账号管理
GetAllRobots
函数原型:
List
GetAllRobots();
获取所有创建了的机器人, 包括没有登录的。
///
/// 获取所有创建了的机器人, 包括没有登录的
/// 如果没有机器人,返回空的List (不是null)
///
///
List GetAllRobots();
GetLoginedRobots
函数原型:
List
GetLoginedRobots();
///
/// 获取已经初始化和登录的机器人
/// 如果没有机器人,返回空的List
///
///
List GetLoginedRobots();
RobotInited
Boolean RobotInited(uint uin);
函数原型:
判断一个机器人是否被初始化,参数解析:
///
/// 判断一个机器人是否被初始化
/// 初始化了的机器人不代表登录了
///
/// 机器人qq号
/// inited 返回true, 没有初始化返回false
Boolean RobotInited(uint uin);
RobotLogined
函数原型:
Boolean RobotLogined(uint uin);
判断一个机器人是否已经登录, 参数解析:
///
/// 判断一个机器人是否已经登录
///
/// 机器人qq号
/// 登录了返回true, 否则返回false
Boolean RobotLogined(uint uin);
RobotInitedAndLogined
函数原型:
Boolean RobotInitedAndLogined(uint uin);
判断一个机器人是否已经初始化和登录了, 参数解析:
///
/// 判断一个机器人是否已经初始化和登录了
///
/// 机器人qq号
/// 初始化和登录了返回true, 否则返回false
Boolean RobotInitedAndLogined(uint uin);
Login
函数原型:
RobotLoginStatus Login(uint uin, String pwd);
登录qq, 参数解析:
///
/// 登录qq
/// 如果出错, 抛出异常 Exception
///
/// 机器人qq号
/// qq密码
/// 返回登录状态
RobotLoginStatus Login(uint uin, String pwd);
Logout
函数原型:
void Logout(uint uin);
进行下线操作, 参数解析:
///
/// 进行下线操作
/// 只是进行简单的下线,并没有移除这个机器人
/// 如果失败或者找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
void Logout(uint uin);
GetLoginStatus
函数原型:
RobotLoginStatus GetLoginStatus(uint uin);
获取机器人的qq登录状态, 参数解析:
///
/// 获取机器人的qq登录状态
/// 如果失败或者找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
/// 返回登录状态
RobotLoginStatus GetLoginStatus(uint uin);
RobotNick
函数原型:
string RobotNick(uint uin);
获取机器人的昵称,参数解析:
///
/// 获取机器人的昵称
/// 如果没有, 则为 ""
/// 如果失败或者找不到机器人, 会抛出异常 Exception
///
/// 机器人QQ号
///
string RobotNick(uint uin);
RobotHeadImgUrl
函数原型:
string RobotHeadImgUrl(uint uin);
获取机器人头像的url, 参数解析:
///
/// 获取机器人头像的url
///
/// 机器人QQ号
///
string RobotHeadImgUrl(uint uin);
RobotClusterImgUrl
函数原型:
string RobotClusterImgUrl(uint code);
获取群的头像url, 参数类型:
///
/// 获取群的头像url
///
/// 群号
///
string RobotClusterImgUrl(uint code);
RobotHeadImg
函数原型:
HeadImg RobotHeadImg(uint uin);
从缓存中获取机器人的头像, 参数解析:
///
/// 获取机器人的头像
/// 如果发生异常或者找不到图片, 返回null
///
/// 机器人QQ号
///
HeadImg RobotHeadImg(uint uin);
ClusterHeadImg
函数原型:
HeadImg ClusterHeadImg(uint code);
从缓存中获取机器人某个群的头像, 参数解析:
///
/// 获取机器人某个群的头像
/// 如果发生异常或者找不到图片, 返回null
///
/// 群号
///
HeadImg ClusterHeadImg(uint code);
好友管理
GetFriendGroupList
函数原型:
List
GetFriendGroupList(uint uin);
获取qq的朋友分组, 参数解析:
///
/// 获取qq的朋友分组
/// 如果失败或者找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
/// 分组列表
List GetFriendGroupList(uint uin);
GetFriendList
函数原型:
List
GetFriendList(uint uin);
获取好友列表, 参数列表
///
/// 获取好友列表
/// 如果失败或者找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
/// 好友列表
List GetFriendList(uint uin);
GetFriend
函数原型:
QQFriend GetFriend(uint uin, uint friendUin);
从好友列表中获取一个好友
///
/// 从好友列表中获取一个好友
/// 如果找不到对应的friend, 返回null
/// 如果找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
/// 好友账号
///
QQFriend GetFriend(uint uin, uint friendUin);
SendMsg2Friend
函数原型:
Boolean SendMsg2Friend(uint uin, uint friendUin, string msg);
发送消息给朋友, 参数解析:
///
/// 发送消息给朋友
/// 本版本不支持发送图片和表情给朋友
/// 如果找不到机器人, 会抛出异常 Exception
/// 如果返回成功, 不代表朋友会接收到消息,因为发送的频率太快, qq服务器会丢弃消息。
/// 一般发送频率跟人处理消息的频率差不多, 1s ~ 2s
///
/// 机器人qq号
/// 好友账号
/// 消息
///
Boolean SendMsg2Friend(uint uin, uint friendUin, string msg);
注:
当前不支持图片和表情的发送
GetContact
函数原型:
QQContactInfos GetContact(uint uin, uint friendUin);
获取朋友的联系信息, 参数解析:
///
/// 获取朋友的联系信息
/// 如果找不到机器人, 会抛出异常 Exception
///
/// 机器人qq号
/// 好友账号
///
QQContactInfos GetContact(uint uin, uint friendUin);
RefreshRobotContact
函数原型:
QQContactInfos RefreshRobotContact(uint uin);
刷新机器人自己的联系信息, 参数解析:
///
/// 刷新机器人自己的联系信息
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
///
QQContactInfos RefreshRobotContact(uint uin);
AddFriend
函数原型:
int AddFriend(uint uin, uint peeruin, string msg, ref QQAuthType qqAuthtype,
string markName = "", bool needVerify = false, bool needAnwser = false, string anwser = null);
添加好友, 参数解析:
///
/// 添加好友
/// 返回 -2代表请求已经是好友了.
/// 返回 -1代表请求失败.
/// 0 代表成功
/// 1 代表拒绝
/// 2 代表需要验证码
/// 3 操作频繁,被暂停使用加好友功能
/// 4 需要正确回答问题
/// 注意不能频繁调用, 不然悲剧
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号码
/// 好友号码
/// 验证消息
/// 导出好友验证类型
/// 备注名称
/// 是否需要附带验证码继续
/// 是否需要核对问题
/// 问题的答案
///
int AddFriend(uint uin, uint peeruin, string msg, ref QQAuthType qqAuthtype,
string markName = "", bool needVerify = false, bool needAnwser = false, string anwser = null);
AddFriendTryOne
函数原型:
int AddFriendTryOne(uint uin, uint peeruin, string msg);
添加好友,只尝试一次, 只是简单化调用AddFriend接口, 参数解析:
///
/// 添加好友,只尝试一次
/// 只是简单化调用AddFriend接口
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 要加友的QQ号
/// 验证消息
///
int AddFriendTryOne(uint uin, uint peeruin, string msg);
RemoveFriend
函数原型:
Boolean RemoveFriend(uint uin, uint deletedUin);
删除好友, 参数解析:
///
/// 删除好友
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 被删的人
///
Boolean RemoveFriend(uint uin, uint deletedUin);
SearchFriendInfo
函数原型:
List
SearchFriendInfo(uint uin, string keyword, int pageIndex = 0, int count = 20,
int sex = 0, int video = 0, int country = 0, int province = 0, int city = 0,
int district = 0, int hcountry = 0, int hprovince = 0, int hcity = 0, int hdistrict = 0, bool isonline = true);
根据条件搜索好友, 参数解析:
///
/// 根据条件搜索好友
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 关键字
/// 分页序号
/// 每次获取的好友数量
/// 性别
/// 是否有视频
/// 国家
/// 省份
/// 城市
/// 街道
/// 祖国
/// 家乡所在省
/// 家乡所在城市
/// 家乡所在街道
/// 是否在线
/// 资料列表
List SearchFriendInfo(uint uin, string keyword, int pageIndex = 0, int count = 20,
int sex = 0, int video = 0, int country = 0, int province = 0, int city = 0,
int district = 0, int hcountry = 0, int hprovince = 0, int hcity = 0, int hdistrict = 0, bool isonline = true);
GetStrangerInfo
函数原型:
QQContactInfos GetStrangerInfo(uint uin, uint stranger);
获取陌生人的联系信息, 参数解析:
///
/// 获取陌生人的联系信息
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 需要获取的陌生人的qq号
///
QQContactInfos GetStrangerInfo(uint uin, uint stranger);
AllowMakeFriend
函数原型:
Boolean AllowMakeFriend(uint uin, uint senderId, bool isAllow, string note = "");
是否允许加好友, 参数解析:
///
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
///
/// 机器人qq号
///
///
///
///
Boolean AllowMakeFriend(uint uin, uint senderId, bool isAllow, string note = "");
CreateDiscussCluster
函数原型:
uint CreateDiscussCluster(uint uin, List
friendList, string clusterName);
创建讨论组, 参数解析:
///
/// 创建讨论组
/// 必须将机器人号码加入到friendList, 和创建后进行激活
/// friendList 不能为null, 但list可以为空
/// 不会自动刷新 DiscussList
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
///
///
///
uint CreateDiscussCluster(uint uin, List friendList, string clusterName);
ActiveDiscuss
函数原型:
Boolean ActiveDiscuss(uint uin, uint discussId);
激活讨论组, 参数解析:
///
/// 激活讨论组
/// 创建讨论组后需要激活
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
///
///
Boolean ActiveDiscuss(uint uin, uint discussId);
GetDiscussInfo
函数原型:
QQCluster GetDiscussInfo(uint uin, uint discussId);
获取讨论组信息, 参数解析:
///
/// 获取讨论组信息
/// 如果失败返回null
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
///
///
QQCluster GetDiscussInfo(uint uin, uint discussId);
SendDiscussMsg
函数原型:
Boolean SendDiscussMsg(uint uin, uint discussId, string message, List
imageList = null);
向讨论组发送消息, 参数解析:
///
/// 向讨论组发送消息
/// 不能调用太频繁, 不然返回true时也可能被服务器给过滤了
/// 一般频率跟人处理信息频率差不多 1.5s ~ 2.5s
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 发送的消息
/// 图片列表
///
Boolean SendDiscussMsg(uint uin, uint discussId, string message, List imageList = null);
注:
如果需要发送图片, 你可以使用imageList, 或者: 在message加入:"[image=filename]" 这样的格式的字符。其中filename为你要发送的图片路径加名字。
不支持表情发送
GetDiscussList
函数原型:
List
GetDiscussList(uint uin);
获取讨论组列表, 参数解析:
///
/// 获取讨论组列表
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
///
List GetDiscussList(uint uin);
GetDiscuss
函数原型:
QQCluster GetDiscuss(uint uin, uint discussId);
从讨论组列表中获取一个讨论组, 参数解析:
///
/// 从讨论组列表中获取一个讨论组
/// 这个操作不会重新从服务器刷新一次讨论组列表, 如果想拿到最新的讨论组列表, 必须手动刷新
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 讨论组id
///
QQCluster GetDiscuss(uint uin, uint discussId);
GetInviterCode
函数原型:
string GetInviterCode(uint uin, uint discussId, out int expiredTime);
获取讨论组的邀请码, 参数解析;
///
/// 获取讨论组的邀请码
/// 如果失败, 不会返回null, 而是返回 "" 字符串
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 讨论组id
/// 过期时间
///
string GetInviterCode(uint uin, uint discussId, out int expiredTime);
GetInviterUrl
函数原型:
string GetInviterUrl(uint uin, uint discussId);
获取讨论组邀请链接, 参数解析:
///
/// 获取讨论组邀请链接
/// 如果失败, 不会返回null, 而是返回 "" 字符串
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 讨论组id
///
string GetInviterUrl(uint uin, uint discussId);
InviteIntoDiscuss
函数原型:
Boolean InviteIntoDiscuss(uint uin, uint discussId, List
friendList);
邀请好友进入讨论组, 参数解析:
///
/// 邀请好友进入讨论组
/// 注意这里的friendList 元素必须是好友关系, 如果不是好友关系,不会发生异常,qq服务器会忽略不是好友的账号
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 讨论组id
/// 被邀请的人
///
Boolean InviteIntoDiscuss(uint uin, uint discussId, List friendList);
注:
注意这里的friendList 元素必须是好友关系, 如果不是好友关系,不会发生异常,qq服务器会忽略不是好友的账号
RemoveDiscussMembers
函数原型:
Boolean RemoveDiscussMembers(uint uin, uint discussId, List
members);
移除讨论组成员, 参数解析:
///
/// 移除讨论组成员
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 讨论组id
/// 要删除的讨论组成员
///
Boolean RemoveDiscussMembers(uint uin, uint discussId, List members);
QuitDiscuss
函数原型:
Boolean QuitDiscuss(uint uin, uint discussId);
退出讨论组, 参数解析:
///
/// 退出讨论组
/// 如果机器人是这个讨论组的创建人时,会删除讨论组的
/// 如果删除讨论组的话,不能太频繁,不然悲剧,经不完全测试,5次就不能再创建讨论组了
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
///
///
///
Boolean QuitDiscuss(uint uin, uint discussId);
注:
如果删除讨论组的话,不能太频繁,不然悲剧,经不完全测试,5次就不能再创建讨论组了
群管理
SearchClusterByCode
函数原型:
QQCluster SearchClusterByCode(uint uin, uint code);
搜索一个群,参数解析:
///
/// 搜索一个群
/// 如果机器人没有登录或者初始化,会发生异常
///
/// 用于搜索的机器人
/// 要搜索的群
///
注:
从服务器搜索一个群的信息,所以效率是很低的!
GetClusterList
函数原型:
List
GetClusterList(uint uin, bool reGet = false);
获取qq群列表, 参数解析:
///
/// 获取qq群列表
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 是否重新从服务器获取
///
List GetClusterList(uint uin, bool reGet = false);
注:
现在缓存中查找群列表, 如果没有再从服务器获取,这个时候效率会很低,耗时比较长!从服务器获取的内容比较少!
GetCluster
函数原型:
QQCluster GetCluster(uint uin, uint clusterCode);
从群列表中获取指定的群, 参数解析:
///
/// 从群列表中获取指定的群
/// 先从缓存中获取群, 如果找不到会从服务器重新拉取数据
/// 如果找不到指定机器人和群, 返回null
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
///
QQCluster GetCluster(uint uin, uint clusterCode);
GetClusterById
函数原型:
QQCluster GetClusterById(uint uin, uint clusterId);
从群列表中获取指定的群, 参数解析:
///
/// 从群列表中获取指定的群
/// 不会从服务器重新拉取数据
/// 如果找不到指定群, 返回null
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群id, 不是群号
///
QQCluster GetClusterById(uint uin, uint clusterId);
SendMsg2Cluster
函数原型:
Boolean SendMsg2Cluster(uint uin, uint clusterCode, string message, bool isXml = false, bool waitResult = false);
发消息到群里, 参数解析:
///
/// 发消息到群里
/// 如果找不到指定群,将失败
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号码
/// 如果要指定图片, 可以这样: @"哈哈哈哈。[image=D:\Users\Administrator\Desktop\新建文件夹\1.jpg] 是一张图片"
/// 消息是否为xml类型
/// 是否等待
///
Boolean SendMsg2Cluster(uint uin, uint clusterCode, string message, bool isXml = false, bool waitResult = false);
注:
当前不支持发送表情
如果需要发送图片, 可以使用imageList, 或者在message加入 "[image=filename]"格式的字符串,其中filename为图片的路径加名字。
AllowJoinCluster
函数原型:
Boolean AllowJoinCluster(uint uin, uint clusterCode, uint senderUin, byte[] token_00ae, bool isAllow, string note);
是否同意请求者加入到机器人管理的群, 参数解析:
///
/// 是否同意请求者加入到机器人管理的群
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 请求者
/// token
/// 是否允许
///
///
Boolean AllowJoinCluster(uint uin, uint clusterCode, uint senderUin, byte[] token_00ae, bool isAllow, string note);
AllowJoinCluster
函数原型:
Boolean AllowJoinCluster(uint uin, uint clusterCode, uint senderUin);
允许请求者加入到我管理的群, 参数解析:
///
/// 允许请求者加入到我管理的群
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 请求者
///
Boolean AllowJoinCluster(uint uin, uint clusterCode, uint senderUin);
AllowJoinCluster4Invitation
函数原型:
Boolean AllowJoinCluster4Invitation(uint uin, uint clusterCode, uint operateUin);
同意群成员邀请某人入群, 参数解析:
///
/// 同意群成员邀请某人入群
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
///
/// 群号
/// 被邀请者
///
Boolean AllowJoinCluster4Invitation(uint uin, uint clusterCode, uint operateUin);
SetManager
函数原型:
Boolean SetManager(uint uin, uint clusterCode, uint managerUin, bool op = true);
设置或者取消管理员, 参数解析:
///
/// 设置或者取消管理员
/// 必须是群的拥有者
///
/// 群号码
/// 被操作的成员
/// true设置为管理员, false 取消管理员
///
Boolean SetManager(uint uin, uint clusterCode, uint managerUin, bool op = true);
AcceptJionCluster
函数原型:
Boolean AcceptJionCluster(uint uin, uint clusterCode, Boolean isAccept);
受到加群邀请后,是否同意加入群, 参数解析:
///
/// 受到邀请加入群后,是否同意加入群
///
/// 机器人qq号
/// 群号
/// 是否接受加群
///
Boolean AcceptJionCluster(uint uin, uint clusterCode, Boolean isAccept);
InviteJoinCluster
函数原型:
Boolean InviteJoinCluster(uint uin, uint clusterCode, List
friendlist);
邀请好友加入群, 参数解析:
///
/// 邀请好友加入群
/// 要邀请的人必须是好友关系,机器人必须是群的创建人或者管理员
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 好友qq号
///
Boolean InviteJoinCluster(uint uin, uint clusterCode, List friendlist);
注:
要邀请的人必须是好友关系,机器人必须是群的创建人或者管理员
JoinCluster
函数原型:
int JoinCluster(uint uin, uint clusterCode, string msg, bool needVerify = false);
请加入某个群, 参数解析:
///
/// 请加入某个群
/// 成功为0
/// 失败为-1
/// 需要验证码为2
/// 操作繁忙为3
/// 已经存在为-2
///
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 留言
/// 是否需要验证
///
int JoinCluster(uint uin, uint clusterCode, string msg, bool needVerify = false);
SendMsg2ClusterMem
函数原型:
Boolean SendMsg2ClusterMem(uint uin, uint clusterCode, uint receiverUin, string message);
与群成员发起群临时会话, 参数解析:
///
/// 与群成员发起群临时会话
/// 必须已经获取了cluster list
/// 当前版本不支持图片和表情的发送
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 接收者
///
///
Boolean SendMsg2ClusterMem(uint uin, uint clusterCode, uint receiverUin, string message);
注:
必须已经获取了cluster list, 当前版本不支持图片和表情的发送
RemoveClusterMember
函数原型:
Boolean RemoveClusterMember(uint uin, uint clusterCode, uint memberUin);
从管理的群里踢人, 参数解析:
///
/// 从管理的群里踢人
/// 必须已经获取了cluster list
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 要踢走的成员的qq号
///
Boolean RemoveClusterMember(uint uin, uint clusterCode, uint memberUin);
BannedCluster
函数原型:
Boolean BannedCluster(uint uin, uint clusterCode, bool banned);
是否禁言机器人管理的群, 参数解析:
///
/// 是否禁言机器人管理的群
/// 必须已经获取了cluster list
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 是否禁言
///
Boolean BannedCluster(uint uin, uint clusterCode, bool banned);
BannedClusterMember
函数原型:
Boolean BannedClusterMember(uint uin, uint clusterCode, uint memberUin, bool banned, uint bannedTime);
在机器人管理的群里禁言某人, 参数解析:
///
/// 在机器人管理的群里禁言某人
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
/// 要禁言的人
/// 是否禁言
/// 禁言的时间, 秒(s)为单位
///
Boolean BannedClusterMember(uint uin, uint clusterCode, uint memberUin, bool banned, uint bannedTime);
LeaveGroup
函数原型:
Boolean LeaveGroup(uint uin, uint clusterCode);
///
/// 退出群
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 群号
///
Boolean LeaveGroup(uint uin, uint clusterCode);
Convert2Images
函数原型:
List
Convert2Images(uint uin, Object images, uint senderId);
从qq服务器获取群或者讨论组聊天图片, 参数解析:
///
/// 从qq服务器获取群或者讨论组聊天图片
/// 如果获取不到图片,返回空的list
/// 如果找不到机器人或者失败, 会抛出异常 Exception
///
/// 机器人qq号
/// 图片信息的List
/// 图片发送者的ID,注意这里不是qq号
///
List Convert2Images(uint uin, Object images, uint senderId);
GetTimeStamp
函数原型:
string GetTimeStamp();
获取时间戳, 参数解析:
///
/// 获取时间戳
/// TotalSeconds 秒数
/// 1970, 1, 1, 0
///
///
string GetTimeStamp();
SaveImage
函数原型:
string SaveImage(string path, Image image);
将图片对象持久化到磁盘, 参数解析:
///
/// 将图片对象持久化到磁盘
/// 如果 参数为null,抛出异常: 资源不可用
/// 如果保存发送异常, 抛出IO异常。
/// 如果失败, 返回null
/// 如果成功, 返回图片名字(绝对路径下)。名字格式为 {时间戳}_{image.MD5}.jpg
///
/// 路径
/// 图片对象
///
string SaveImage(string path, Image image);
SaveImageByName
函数原型:
string SaveImageByName(string absoluteFileName, Image image, bool force);
保存图片到指定路径和名字, 参数解析:
///
/// 保存图片到指定路径和名字
/// 如果失败返回null,如果异常,抛出EXception, 成功返回文件的绝对名字
///
/// 文件的绝对名字, 包括路径了
///
/// 强制删除已经存在的同名字图片
///
string SaveImageByName(string absoluteFileName, Image image, bool force);
ImageToBytes
函数原型:
byte[] ImageToBytes(Image image);
将图片转换为二进制流, 参数解析:
///
/// 将图片转换为二进制流
///
/// 图片对象
///
byte[] ImageToBytes(Image image);
BytesToImage
函数原型:
Image BytesToImage(byte[] buffer);
将二进制流转换为图片对象, 参数解析:
///
/// 将二进制流转换为图片对象
///
/// 图片二进制流
///
Image BytesToImage(byte[] buffer);
机器人管理
RobotExist
函数原型:
Boolean RobotExist(uint uin);
判断一个机器人是否存在, 参数解析:
///
/// 判断一个机器人是否存在
///
/// 机器人qq号
///
Boolean RobotExist(uint uin);