程序包 cn.siriusbot.siriuspro.bot.api

接口 C2CApi

public interface C2CApi

方法概要

修饰符和类型	方法	说明
Tuple<GeneralMessageResult,String>	sendGeneralMessage(String bot_id, String user_id, String content, Integer msg_type, MessageMarkdown markdown, MessageKeyboard keyboard, String media, MessageArk ark, String image, String message_reference, String event_id, String msg_id, String msg_seq)	通用发送消息
Tuple<Message,String>	sendMarkdownMessage(String bot_id, String user_id, String msg_id, String event_id, MessageMarkdown markdown, MessageKeyboard keyboard)	发送markdown消息(富文本) 要求操作人在该子频道具有发送消息和对应 Markdown 模版 的权限。
Tuple<Message,String>	sendMessage(String bot_id, String user_id, String content, String msg_id)	用于向 QQ用户发送消息
Tuple<Message,String>	sendRichMediaMessage(String bot_id, String user_id, String content, String event_id, Integer file_type, String url, Boolean srv_send_msg)	用于发送QQ好友发送富文本消息

方法详细资料

sendGeneralMessage

Tuple<GeneralMessageResult,String> sendGeneralMessage(String bot_id,
 String user_id,
 String content,
 Integer msg_type,
 MessageMarkdown markdown,
 MessageKeyboard keyboard,
 String media,
 MessageArk ark,
 String image,
 String message_reference,
 String event_id,
 String msg_id,
 String msg_seq)

通用发送消息

参数:

content - 要发送的消息内容

bot_id - 传入机器人ID

user_id - 群ID

msg_type - 消息类型： 0 文本，2 是 markdown，3 ark 消息，4 embed，7 media 富媒体

markdown - markdown对象

keyboard - 按钮对象

media - {file_info: \"\"} 数据来源\"消息收发=>富媒体消息\"

ark - ark消息对象

image - 【暂不支持】图片

message_reference - 【暂未支持】消息引用

event_id - 事件ID

msg_id - 消息ID

msg_seq - 回复消息的序号，与 msg_id 联合使用，避免相同消息id回复重复发送，不填默认是 1。相同的 msg_id + msg_seq 重复发送会失败。

返回:

消息对象

sendMessage

Tuple<Message,String> sendMessage(String bot_id,
 String user_id,
 String content,
 String msg_id)

用于向 QQ用户发送消息

参数:

bot_id - 传入机器人ID

user_id - 用户ID

content - 要发送的消息内容

msg_id - 消息ID

返回:

消息对象

sendRichMediaMessage

Tuple<Message,String> sendRichMediaMessage(String bot_id,
 String user_id,
 String content,
 String event_id,
 Integer file_type,
 String url,
 Boolean srv_send_msg)

用于发送QQ好友发送富文本消息

参数:

bot_id - 机器人ID

user_id - 用户ID

content - 消息内容

event_id - 事件ID

file_type - 文件类型 业务类型，图片，文件，语音，视频 文件类型，取值:1图片,2视频,3语音(目前语音只支持silk格式)

url - 文件地址

srv_send_msg - 服务器消息

返回:

消息对象

sendMarkdownMessage

Tuple<Message,String> sendMarkdownMessage(String bot_id,
 String user_id,
 String msg_id,
 String event_id,
 MessageMarkdown markdown,
 MessageKeyboard keyboard)

发送markdown消息(富文本) 要求操作人在该子频道具有发送消息和对应 Markdown 模版 的权限。 调用前开发者需要先在“QQ开放平台-机器人-发布设置-消息模板”入口为对应机器人创建申请Markdown消息模板，得到模板 id ，在请求时填在对应的 markdown.template_id 上。 模板参数暂不支持数组。 消息体中所包含的URL需要报备并通过验证，方可使用。 如传入event_id和msg_id其中一个，此条消息视为被动消息

参数:

bot_id - 传入机器人ID

user_id - 用户ID

msg_id - 消息id

event_id - 事件ID

markdown - markdown对象

keyboard - 按钮对象

返回:

返回消息对象