Skip to content

Latest commit

 

History

History
93 lines (59 loc) · 3.52 KB

1.1-快速开始.md

File metadata and controls

93 lines (59 loc) · 3.52 KB

快速开始

  1. 下载 MaaFramework 发行版
  2. 准备资源文件
  3. 使用通用 GUI / 自行编写集成代码

下载 MaaFramework 发行版

根据您的平台下载并解压：Releases

准备资源文件

您需要准备一些资源文件，典型的文件结构 如下：

my_resource
├── image
│   ├── my_image_1.png
│   └── my_image_2.png
├── model
│   └── ocr
│       ├── det.onnx
│       ├── keys.txt
│       └── rec.onnx
├── pipeline
│   ├── my_pipeline_1.json
│   └── my_pipeline_2.json
└── properties.json

其中以 my_ 开头的文件/文件夹均可自行修改名称，其他的则为固定文件名，不可修改，下面依次介绍：

Pipeline JSON 文件

my_resource/pipeline 中的文件，包含主要的脚本执行逻辑，会递归读取目录中所有的 json 格式文件。

可参考 任务流水线协议 进行编写，一个简单的 demo

小工具：

图片文件

my_resource/image 中的文件，主要为 pipeline 所用到的模板匹配图片、特征检测图片等，会按照 pipeline 中设定的 template 等字段读取对应的文件。

小工具：

文字识别模型文件

my_resource/model/ocr 中的文件，为 PaddleOCR 转 ONNX 后的模型文件。

可使用我们的预转换文件：MaaCommonAssets，选择需要的语种，按照 上述 目录结构存放即可。

若有需要也可以自行对 PaddleOCR 的官方预训练模型进行 fine-tuning （请自行参考 PaddleOCR 官方文档），并转换成 ONNX 文件使用，转换命令可参考 这里

目录属性文件

properties.json 可用于设置部分当前目录下的属性，典型 JSON 结构如下：

请注意，JSON 不支持注释，以下仅为演示，请勿直接复制使用。

{
    "is_base": true,     // 是否是基准资源
                         // 若为 true，在读取本目录下的资源时，会清除之前读取的所有内容
}

集成

使用 MaaY（通用 GUI）或者 自行编写集成代码

使用 MaaY

使用 MaaY，参考 MaaY 中对应的文档整理 .maay 文件夹，并在 GUI 中直接导入使用。

实践:

自行编写集成代码

请参考 集成文档

实践:

  • M9A 基于 C++ & cmake 的集成实践
  • MBA 基于 C# .NET 的集成实践