- 能力描述
- 应用场景
- 功能展示
- 帮助文档
能力描述
自动识别 角度校正
本API能够实现对文档翻拍过程的辅助增强功能，自动识别图片中的文档，返回文档在原图中的位置信息。 根据文档在原始图片中的位置信息校正文档的拍摄角度，自动将拍摄视角调整到正对文档的角度上。 此功能在纸质旧照片、信件、画作等翻拍为电子版的场景中，有出色表现。
应用场景
翻拍优化 高效记录
自动识别图片中文档位置并校正角度，适用于基于文档翻拍优化的业务场景，如纸质文档翻拍、艺术画作翻拍等。
纸质照片、信件翻拍校正
通过本API可以实现对纸质照片、信件的翻拍及位置校正，存留记忆。
博物馆、艺术展览中的妙手偶得
通过本API，能够突破角度、人流等客观因素，将展览中的好作品轻松记录。
功能演示
Request
复制代码
文档检测请求参数：
DocRefine docRefine = new DocRefine（this）;
Frame frame = new Frame();
frame.setBitmap(bitmap);
JSONObject obj2 = docRefine.docDetect(frame, null);
文档校正请求参数：
ds = docRefine.convertResult(obj2);
newbmp = docRefine.docRefine(frame, ds, null);
Response
复制代码
文档检测返回结果：
{"resultCode":0,"doc":"{\"bottom_left\":
{\"x\":4,\"y\":426},\"bottom_right\":
{\"x\":588,\"y\":592},\"top_left\":
与华为一同开发从这里开始
FAQ
1没有调用接口的prepare()方法可以直接使用faceCompare()方法吗？
可以的，在faceCompare()方法中会默认启动引擎，如果引擎已经启动则不会再次启动，开发者可以放心使用。
2release()方法是什么时候调用？
release()方法会卸载在NPU芯片中已经加载的模型，请在应用不再使用文档检测校正时及时卸载模型，释放资源。
3是否支持多线程调用？
HUAWEI HiAI Engine 不支持同一应用使用多线程调用同一接口，这样会导致某一线程调用release方法后，卸载模型，导致正在运行的另一些线程出错。事实上，由于NPU硬件底层也是排队执行多任务，所以多线程执行同一功能达不到并行的效果。另外，引擎支持使用多线程调用不同接口，如开启两个线程同时使用美学评分和文档校验接口。
华为开发者联盟 版权所有 ©2025
