# maa的rust绑定，及http api ## rust绑定: 对unsafe ffi进行最基础的绑定，只依赖std ## http api 以下api调用方式均为http post 使用方式:将server程序放入maa文件夹内并运行server #### 接口名称 获取版本号 ###### 1) 请求地址 > ###### 2) 请求参数: 无 ###### 3) 返回结果示例: ```json { "core": "2022-07-24-16-43-52-8218e7f", "result": 0, "server": "v0.0.1" } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | core | maa本体版本号 | string | - | | server | 本服务器版本号 | string | - | #### 接口名称 创建maa实例 ###### 1) 请求地址 > ###### 2) 请求参数: 无 ###### 3) 返回结果示例: ```json { "id": 1, "result": 0, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | --- #### 接口名称 删除maa实例 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, } ``` --- #### 接口名称 获取所有maa实例 ###### 1) 请求地址 > ###### 2) 请求参数:无 ###### 3) 返回结果示例 ```json { "instances": [ 1 ], "result": 0 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | instances |实例的id的列表| []int | - | --- #### 接口名称 连接模拟器 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "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) 返回结果示例 ```json { "result": 0 } ``` --- #### 接口名称 获取实例连接的adb地址 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, "target": "127.0.0.1:62025" } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | target |连接的地址| string | - | --- #### 接口名称 获取最近nums条回调消息 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "uuid":"af01fba4f43da740\r\n", "nums":5 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | uuid |设备的uuid| string | - | | nums |消息条数| int or null | nums为null时，一次性返回所有消息 | ###### 3) 返回结果示例 ```json { "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) 请求地址 > ###### 2) 请求参数: ```json { "uuid":"af01fba4f43da740\r\n", } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | uuid |设备的uuid| string | - | ###### 3) 返回结果示例 ```json { "result": 0 } ``` --- #### 接口名称 获取数据库内所有uuid ###### 1) 请求地址 > ###### 2) 请求参数:无 ###### 3) 返回结果示例 ```json { "result": 0, "uuid": [ "af01fba4f43da740" ] } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | uuid |uuid列表| []string | 即使uuid没有对应的实例，依旧会返回uuid | --- #### 接口名称 获取实例对应的uuid ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, "uuid": "af01fba4f43da740\r\n" } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | uuid |设备的uuid| string | - | --- #### 接口名称 创建任务 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, "types":"StartUp", "params":{} } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | | types |任务类型| string | - | | params |任务参数| object | 具体参考maa abi文档 | ###### 3) 返回结果示例 ```json { "result": 0, "task_id": 1 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | task_id |任务的id| int | - | --- #### 接口名称 设置任务参数 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, "task_id":1, "params":{} } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | | task_id |任务的id| int | - | | params |任务参数| object | 具体参考maa abi文档 | ###### 3) 返回结果示例 ```json { "result": 0, } ``` --- #### 接口名称 获取当前任务队列 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, "tasks": { "1": { "params": "{}", "type": "StartUp" } } } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | tasks |任务队列| []object | tasks字段内的键值对，键为task_id，不一定从1开始 | --- #### 接口名称 开始运行 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, } ``` --- #### 接口名称 中止运行 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 ```json { "result": 0, } ``` --- #### 接口名称 获取安卓截图 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | ###### 3) 返回结果示例 | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | 无 |无| 一张截图(png格式) | 建议自己想象一个 | --- #### 接口名称 点击安卓屏幕 ###### 1) 请求地址 > ###### 2) 请求参数: ```json { "id":1, "x":114, "y":514 } ``` | 字段名称 | 字段说明 | 类型 | 备注 | |------|------------|--------|---- | | id |实例的id| int | - | | x |横坐标| int | 坐标原点在屏幕左上角 | | y |纵坐标| int | - | ###### 3) 返回结果示例 ```json { "result": 0, } ``` ---