iOS-OCR-Server

环境要求

• 一台运行 iOS 的 iPhone 或 iPad（用于运行 OCR Server 应用）
• 与手机处于同一局域网的另一台设备（电脑），用于浏览器测试或 API 调用
• 可选：Python 3 环境并安装 requests，用于脚本调用接口
• 可选：curl 命令行工具，用于直接测试上传接口

安装与启动步骤

1. 1安装 OCR Server

   从 App Store 下载安装 OCR Server 应用，项目通过该应用提供 OCR 服务，无需自行编译源码。

2. 2启动并记录访问地址

   打开应用后服务会自动启动，界面会显示本机 IP 地址，供同一网络内的其他设备访问。

3. 3设置应用常驻运行

   在 iOS 设置中开启引导式访问并保持屏幕常亮，避免应用被切到后台导致服务中断。

4. 4浏览器做 OCR 测试

   在电脑浏览器中打开应用显示的 IP 地址，使用内置测试页面选图识别，确认服务可用。

5. 5用 curl 调用上传接口

   把示例里的 IP 换成应用显示的地址，file 指向本地图片路径，POST 到 8000 端口的 upload 接口。

   curl -H "Accept: application/json" -X POST http://10.0.1.11:8000/upload -F "file=@01.png"

   复制

6. 6安装 Python 请求库

   如需用 Python 脚本调用接口，先安装 requests；若要绘制文字框还需 pillow、opencv-python、numpy。

   pip3 install requests
   pip3 install requests pillow opencv-python numpy

   复制

7. 7运行 Python 上传示例

   修改 url 为应用显示的 IP，file_path 指向待识别图片，打印状态码和返回的 JSON 文本。

   import requests
   
   url = "http://10.0.1.11:8000/upload"  # 替换为应用显示的 IP
   file_path = "01.png"
   
   with open(file_path, "rb") as f:
       files = {"file": f}
       headers = {"Accept": "application/json"}
       response = requests.post(url, files=files, headers=headers)
   
   print("status code:", response.status_code)
   print("response:", response.text)

   复制

关键配置

如何确认成功

在电脑浏览器打开应用显示的 IP 地址能看到测试页面；或用 curl 上传图片返回 200 且 JSON 中 success 为 true。

常见问题

注意事项

• 本项目以 App Store 应用形式分发，无需在电脑上编译 Swift 源码。
• 调用时务必把示例中的 IP 替换为应用界面实际显示的地址，端口保持 8000。
• 服务只在局域网内可用，需保证调用方与手机处于同一网络。
• 返回的 rect 四个角坐标非轴对齐，可用于还原倾斜文本区域。