前言

为了提高插件兼容性、可扩展性。华景推出插件API v2版本。本版本采用json等通用编码格式传递调用信息。

调用方式

int api_invoke_json(string msg, string* ret, int& len)

{"method": "msg.send", "param": {}, "method_ver": 1, "charset": "utf-8", "auth_token": "", "api_id": "", "async": true, "callback": 0, "ret":["timestamp", "result", "msgId"]}

公共参数

参数 说明
method API方法
param API方法对应的参数,详细需要看每个方法的说明文档
method_ver 调用版本, 默认为最新版本
runtime_auth_code 从FirstLoad函数获得
app_id 暂不支持,插件id,在开发者中心获得
async 暂不支持,是否异步调用
callback 暂不支持,异步调用时填写,回调函数地址
ret 暂不支持,需要返回的内容,可以在对应方法的说明文档查看

调用 - api_invoke_json

int api_invoke_json(string msg, string* ret, int& len)

以json编码格式调用机器人API。msg为指定格式的json字符串,ret返回json字符串,int为返回的字符串长度。ret使用完后必须使用api_free(ret)释放内存。

释放内存 - api_free

void api_free (string* ret)

申请内存 - api_alloc

void* api_alloc (int len)

Msg

Friend.MSG

{"msg_type": "Friend.MSG", "sender": {"uin": "4321111", "nick": "aa", "sex": 0, "age": 1}, "msg": "nihao", "extra": {}}

Friend.STATUS_CHANGED

Friend.ADDING_REQUEST

Group.MSG

Group.ADMIN_CHANGED

Group.JOINING_INVITATION

Group.JOINING_REQUEST

Group.EXIT

Discussion.MSG

TempSession.MSG_FROM_WEB

TempSession.MSG_FROM_GROUP

TempSession.MSG_FROM_DISCUSSION

TempSession.MSG_FROM_NEARBY

Plugin

Plugin.RELOAD

Plugin.FIRST_LOAD

Plugin.STOP

Plugin.START

Plugin.INSTALLED

Plugin.UNINSTALLED

System

System.SHUTDOWN

####

文档更新时间: 2019-03-06 05:57   作者:admin