Rust

maa的rust绑定，及http api

rust绑定:

对unsafe ffi进行最基础的绑定，只依赖std

http api

以下api调用方式均为http post
使用方式:将server程序放入maa文件夹内并运行server

接口名称 获取版本号

1) 请求地址

http://127.0.0.1:11451/version

2) 请求参数: 无

3) 返回结果示例:

{
  "core": "2022-07-24-16-43-52-8218e7f",
  "result": 0,
  "server": "v0.0.1"
}

字段名称	字段说明	类型	备注
core	maa本体版本号	string	-
server	本服务器版本号	string	-

接口名称 创建maa实例

1) 请求地址

http://127.0.0.1:11451/instance/create

2) 请求参数: 无

3) 返回结果示例:

{
  "id": 1,
  "result":  0,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

---

接口名称 删除maa实例

1) 请求地址

http://127.0.0.1:11451/instance/delete

2) 请求参数:

{
  "id":1
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result":  0,
}

---

接口名称 获取所有maa实例

1) 请求地址

http://127.0.0.1:11451/instance/all

2) 请求参数:无

3) 返回结果示例

{
    "instances": [
        1
    ], 
    "result": 0
}

字段名称	字段说明	类型	备注
instances	实例的id的列表	[]int	-

---

接口名称 连接模拟器

1) 请求地址

http://127.0.0.1:11451/connect/attach

2) 请求参数:

{
    "id":1,
    "adb_path":"adb.exe",
    "target":"127.0.0.1:62025",
    "config":null
}

字段名称	字段说明	类型	备注
id	实例的id	int	-
adb_path	adb的地址	string	-
target	连接的地址	string	-
config	设置	object	具体参考maa abi文档

3) 返回结果示例

{
    "result": 0
}

---

接口名称 获取实例连接的adb地址

1) 请求地址

http://127.0.0.1:11451/connect/target

2) 请求参数:

{
    "id":1,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result": 0,
    "target": "127.0.0.1:62025"
}

字段名称	字段说明	类型	备注
target	连接的地址	string	-

---

接口名称 获取最近nums条回调消息

1) 请求地址

http://127.0.0.1:11451/message/get

2) 请求参数:

{
    "uuid":"af01fba4f43da740\r\n",
    "nums":5
}

字段名称	字段说明	类型	备注
uuid	设备的uuid	string	-
nums	消息条数	int or null	nums为null时，一次性返回所有消息

3) 返回结果示例

{
    "msgs": [
        {
            "body": {
                "details": {
                    "adb": "adb.exe", 
                    "address": "127.0.0.1:62025", 
                    "config": "General"
                }, 
                "uuid": "af01fba4f43da740", 
                "what": "Connected", 
                "why": ""
            }, 
            "time": 1658687213962, 
            "type": 2
        }
    ], 
    "result": 0
}

字段名称	字段说明	类型	备注
msgs	消息的列表	[]object	-
msg.body	消息正文	object	具体参考maa回调文档
msg.time	时间戳	int	-
msg.type	消息类型	int	具体参考maa回调文档

---

接口名称 删除uuid对应的所有消息

1) 请求地址

http://127.0.0.1:11451/message/drop

2) 请求参数:

{
    "uuid":"af01fba4f43da740\r\n",
}

字段名称	字段说明	类型	备注
uuid	设备的uuid	string	-

3) 返回结果示例

{
    "result": 0
}

---

接口名称 获取数据库内所有uuid

1) 请求地址

http://127.0.0.1:11451/uuid/all

2) 请求参数:无

3) 返回结果示例

{
    "result": 0, 
    "uuid": [
        "af01fba4f43da740"
    ]
}

字段名称	字段说明	类型	备注
uuid	uuid列表	[]string	即使uuid没有对应的实例，依旧会返回uuid

---

接口名称 获取实例对应的uuid

1) 请求地址

http://127.0.0.1:11451/uuid/get

2) 请求参数:

{
    "id":1
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result": 0,
    "uuid": "af01fba4f43da740\r\n"
}

字段名称	字段说明	类型	备注
uuid	设备的uuid	string	-

---

接口名称 创建任务

1) 请求地址

http://127.0.0.1:11451/task/create

2) 请求参数:

{
    "id":1,
    "types":"StartUp",
    "params":{}
}

字段名称	字段说明	类型	备注
id	实例的id	int	-
types	任务类型	string	-
params	任务参数	object	具体参考maa abi文档

3) 返回结果示例

{
    "result": 0,
    "task_id": 1
}

字段名称	字段说明	类型	备注
task_id	任务的id	int	-

---

接口名称 设置任务参数

1) 请求地址

http://127.0.0.1:11451/task/set

2) 请求参数:

{
    "id":1,
    "task_id":1,
    "params":{}
}

字段名称	字段说明	类型	备注
id	实例的id	int	-
task_id	任务的id	int	-
params	任务参数	object	具体参考maa abi文档

3) 返回结果示例

{
    "result": 0,
}

---

接口名称 获取当前任务队列

1) 请求地址

http://127.0.0.1:11451/task/all

2) 请求参数:

{
    "id":1,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result": 0, 
    "tasks": {
        "1": {
            "params": "{}", 
            "type": "StartUp"
        }
    }
}

字段名称	字段说明	类型	备注
tasks	任务队列	[]object	tasks字段内的键值对，键为task_id，不一定从1开始

---

接口名称 开始运行

1) 请求地址

http://127.0.0.1:11451/run/start

2) 请求参数:

{
    "id":1,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result": 0,
}

---

接口名称 中止运行

1) 请求地址

http://127.0.0.1:11451/run/stop

2) 请求参数:

{
    "id":1,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

{
    "result": 0,
}

---

接口名称 获取安卓截图

1) 请求地址

http://127.0.0.1:11451/device/screenshot

2) 请求参数:

{
    "id":1,
}

字段名称	字段说明	类型	备注
id	实例的id	int	-

3) 返回结果示例

字段名称	字段说明	类型	备注
无	无	一张截图(png格式)	建议自己想象一个

---

接口名称 点击安卓屏幕

1) 请求地址

http://127.0.0.1:11451/device/click

2) 请求参数:

{
    "id":1,
    "x":114,
    "y":514
}

字段名称	字段说明	类型	备注
id	实例的id	int	-
x	横坐标	int	坐标原点在屏幕左上角
y	纵坐标	int	-

3) 返回结果示例

{
    "result": 0,
}  

---