如何在 Kotlin 与 Python 项目间实现图像 OCR 协同处理-Python教程-PHP中文网

如何在 Kotlin 与 Python 项目间实现图像 OCR 协同处理

本文介绍通过 flask 构建轻量级 http api，使 android（kotlin）应用安全、高效地调用 python ocr/图像处理逻辑，无需复杂部署，适合本地开发与中小型生产场景。

本文介绍通过 flask 构建轻量级 http api，使 android（kotlin）应用安全、高效地调用 python ocr/图像处理逻辑，无需复杂部署，适合本地开发与中小型生产场景。

在移动应用与 AI 后端协同开发中，常需将 Kotlin 编写的 Android 客户端（如相机拍照模块）与 Python 的图像处理能力（如 Tesseract OCR、OpenCV 预处理）解耦集成。推荐采用 Flask 搭建 RESTful API 作为桥梁——它轻量、易调试、零配置启动，远比 Django 或云服务（如 AWS Lambda）更适合作为本地或局域网内快速验证方案。

✅ 推荐方案：Flask HTTP API（本地开发首选）

Python 端只需一个 app.py 文件即可提供图像接收与处理接口：

from flask import Flask, request, jsonify
import cv2
import numpy as np

app = Flask(__name__)

@app.route('/process_image', methods=['POST'])
def process_image():
    try:
        # 1. 验证文件上传字段
        if 'input_image' not in request.files:
            return jsonify({'error': 'Missing input_image field'}), 400

        file = request.files['input_image']
        if file.filename == '':
            return jsonify({'error': 'Empty filename'}), 400

        # 2. 读取并解码图像（支持 JPG/PNG）
        img_bytes = file.read()
        nparr = np.frombuffer(img_bytes, np.uint8)
        img = cv2.imdecode(nparr, cv2.IMREAD_COLOR)
        if img is None:
            return jsonify({'error': 'Invalid image format'}), 400

        # 3. 执行 OCR 或图像处理（示例：简单灰度+文字识别占位）
        # → 此处替换为你的实际逻辑，如 pytesseract.image_to_string(img)
        # processed_result = pytesseract.image_to_string(cv2.cvtColor(img, cv2.COLOR_BGR2RGB))

        # 4. 返回结构化结果（避免直接传二进制图像，推荐 Base64 或 URL）
        return jsonify({
            'status': 'success',
            'text_detected': 'SAMPLE OCR OUTPUT',  # 替换为真实识别结果
            'confidence': 0.92
        })

    except Exception as e:
        return jsonify({'error': f'Processing failed: {str(e)}'}), 500

if __name__ == '__main__':
    # 开发时启用 debug；生产环境务必关闭并使用 WSGI（如 Gunicorn）
    app.run(host='0.0.0.0', port=5000, debug=False)

? 关键说明：

使用 host='0.0.0.0' 使服务可被局域网内设备（如安卓手机）访问；

port=5000 可自定义，需确保 Kotlin 端请求地址匹配（如 http://192.168.x.x:5000/process_image）；

生产环境必须禁用 debug=True，并配合反向代理（Nginx）与 HTTPS。

? Kotlin 端调用示例（使用 OkHttp）

在 build.gradle 中添加依赖：

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

发送图像并解析响应：

private fun sendImageToPython(imageFile: File) {
    val client = OkHttpClient()
    val requestBody = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("input_image", imageFile.name,
            RequestBody.create(MediaType.parse("image/*"), imageFile))
        .build()

    val request = Request.Builder()
        .url("http://192.168.1.100:5000/process_image") // 替换为你的 Python 服务 IP
        .post(requestBody)
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onFailure(call: Call, e: IOException) {
            Log.e("OCR", "Network error", e)
        }

        override fun onResponse(call: Call, response: Response) {
            if (response.isSuccessful) {
                val result = response.body?.string()
                val json = JSONObject(result)
                val text = json.optString("text_detected", "No text found")
                Log.d("OCR", "Result: $text")
            } else {
                Log.e("OCR", "HTTP ${response.code} error")
            }
        }
    })
}

⚠️ 注意事项与优化建议

网络权限：Android 9+ 默认禁止 HTTP 明文请求，需在 AndroidManifest.xml 中添加：

Shadows Python Sensei
Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载
```
<application android:usescleartexttraffic="true" ...></application>
```
或更安全地配置 network_security_config.xml 允许特定 IP。
图像大小限制：Flask 默认限制上传文件大小（约 500KB），可在启动前设置：
```
app.config['MAX_CONTENT_LENGTH'] = 16 * 1024 * 1024  # 16MB
```
替代方案对比：
- Django：功能完备但启动重、学习成本高，适合已有 Web 项目扩展；
- Cloud（AWS/Azure）：适合高并发、跨地域场景，但涉及鉴权、计费、运维开销；
- 进程间通信（IPC）：如通过 subprocess 调用 Python 脚本——仅限桌面端，不适用于 Android（无 Python 运行时）。
进阶方向：后续可集成 JWT 鉴权、异步任务队列（Celery）、结果缓存（Redis），或容器化（Docker）提升可移植性。