Skip to content

Latest commit

 

History

History
 
 

Rust

Readme.md

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,
}