eSCL
全称：extended Simple Communications Library
中文：扩展简易通信库（主流扫描设备通用协议）
补充：
SCL = Simple Communications Library（基础简易通信库），eSCL 是其扩展版，多用于网络扫描仪、多功能一体机。
eSCL：Electronic Scan Communication Language（电子扫描通信语言）
eSCL 基础总览
eSCL = Extended Simple Communications Library，扩展简易扫描控制协议
由 HP 原始设计、Mopria 联盟标准化，是网络扫描仪 / MFP 一体机通用扫描协议（苹果 AirScan、安卓 Mopria Scan 底层均基于它）。
底层承载架构
传输层：标准 TCP，HTTP/HTTPS 封装；常用端口：80、443、8080，不同厂商略有差异（京瓷 9090 等）。
应用层报文：纯 XML 格式（非二进制），REST 风格 HTTP 接口交互，无自定义二进制包头，极易抓包调试。
设备发现：依靠 mDNS 广播 _uscan._tcp.local，电脑 / 手机可自动局域网发现扫描设备，无需手动填 IP。
角色模型
客户端：电脑、手机、扫描软件（NAPS2、系统自带扫描工具）
服务端：网络扫描仪、打印复印一体机 MFP
二、核心接口（固定 URL 端点）
所有交互都访问设备 IP 下 /eSCL/ 根路径，常用标准接口：
表格
HTTP 方法
接口路径
作用
GET
/eSCL/ScannerCapabilities
获取扫描仪硬件能力（分辨率、色彩、纸张尺寸、双面、支持图片格式）
GET
/eSCL/ScannerStatus
查询扫描仪空闲 / 卡纸 / 开盖、有无原稿、任务队列状态
POST
/eSCL/ScanJobs
提交扫描任务，下发扫描参数（DPI、彩色 / 灰度、PDF/JPG）
GET
/eSCL/ScanJobs/{任务ID}/NextDocument
拉取扫描生成的图像二进制数据流
DELETE
/eSCL/ScanJobs/{任务ID}
取消扫描任务
三、完整标准扫描工作流程（分步拆解）
步骤 1：局域网设备自动发现（mDNS）
客户端发出 mDNS 查询 _uscan._tcp.local；
扫描仪持续广播自身 IP、eSCL 端口、设备型号；
客户端枚举到扫描仪，建立 TCP 连接。
步骤 2：查询扫描仪能力（必做预检）
客户端发起 HTTP GET：
plaintext
GET http://扫描仪IP/eSCL/ScannerCapabilities HTTP/1.1
设备返回 XML，写明：
支持分辨率：100/300/600dpi
色彩模式：RGB 彩色、灰度、黑白二值
支持介质：A4、A5、平板扫描、ADF 输稿器双面扫描
输出格式：JPEG、PNG、TIFF、多页 PDF
客户端根据返回值限制用户可选扫描参数，避免下发不支持的配置。
步骤 3：查询设备实时状态
GET /eSCL/ScannerStatus，XML 返回：
ScannerState：Idle 空闲 / Scanning 扫描中 / Jam 卡纸 / CoverOpen 开盖
ADF 有无纸张、已排队任务数量
只有 Idle 状态才能新建扫描任务。
步骤 4：创建扫描任务（核心下发参数）
客户端POST /eSCL/ScanJobs，请求 Body 携带 XML 扫描配置：
扫描区域、分辨率、色彩、ADF / 平板、多页合并 PDF、压缩质量等。
扫描仪接收后：
校验参数合法性；
生成唯一 JobID 任务编号；
HTTP 返回 201 Created，并返回任务访问地址。
步骤 5：扫描仪硬件执行扫描
平板 / ADF 走纸、光电传感器逐行采集图像像素；
板载 DSP 降噪、裁剪、纠偏；
按指定格式（JPG/PDF）编码图片，存入设备内存缓冲区。
步骤 6：客户端循环拉取扫描图像数据
客户端循环调用：
plaintext
GET /eSCL/ScanJobs/{JobID}/NextDocument
有图像数据：HTTP 响应体直接返回图片二进制流，客户端保存本地；
多页 ADF 原稿：多次循环拉取，逐页下载；
返回 404：全部页面传输完毕，扫描任务结束。
步骤 7：任务收尾
客户端主动 DELETE 删除任务 ID 释放设备队列；扫描仪回到 Idle 空闲状态，等待下一次扫描请求。
四、报文结构特点（和 IPP 关键区别）
eSCL：XML 明文
HTTP Body 是标准 XML 文本，抓包可直接看懂扫描参数，调试简单；不使用自定义二进制封装。
IPP：二进制封装报文
HTTP 内部是二进制 IPP 数据包，不能直接肉眼解析。
五、关键运行特性
1. 任务异步机制
下发扫描任务≠立刻拿到图片，是创建任务→后台扫描→轮询下载图像的异步模型；支持多任务排队、单任务取消。
2. 传输两种模式
明文 HTTP：80/8080 端口，内网局域网首选；
HTTPS 加密 eSCL（Secure eSCL）：443 端口，外网远程扫描防窃听。
3. 跨平台无驱优势
Windows/macOS/Linux/ 手机原生内置 eSCL 客户端，不用安装厂商专用驱动：
macOS：图像捕捉（AirScan）
Windows 10+/11：系统 “扫描仪和相机” 原生识别
Linux：SANE、NAPS2 完美兼容
4. 能力边界
只负责图像采集 + 参数控制，不做复杂文档管理、权限 PIN 码、作业配额；只专注扫描单一场景，设计轻量化。
六、极简一句话总结 eSCL 原理
eSCL 依托 HTTP+XML，采用客户端主动轮询的异步模型：先查询扫描仪能力与状态，下发扫描参数创建任务，扫描仪硬件扫描编码后，客户端分次拉取图片二进制流，完整实现局域网无驱网络扫描。
eSCL（Electronic Scan Communication Language，电子扫描通信语言）相关说明如下：
一、定义
eSCL是由惠普（HP）主导开发、面向网络扫描/多功能一体机（MFP）的轻量级应用层通信协议，核心作用是标准化终端（电脑、移动设备、服务器等）与联网扫描设备之间的扫描指令交互、图像数据传输流程，无需终端预装传统本地扫描驱动即可完成扫描操作，是当前网络扫描场景的事实主流标准之一。
二、核心概念
1. 发展背景与定位
传统扫描依赖TWAIN、WIA等本地接口协议，需要终端安装对应扫描仪型号的专属驱动，存在跨平台兼容性差、部署成本高、移动端支持不足的问题。eSCL诞生于2007年前后，最早应用于惠普商用激光一体机，后续惠普开放了公开技术规范，被佳能、兄弟、理光等多家影像设备厂商兼容，目前已成为网络扫描场景的通用协议标准。 它与互联网打印协议（IPP）同属基于HTTP的网络设备协议体系：IPP负责打印场景，eSCL负责扫描场景，多数网络一体机同时支持两者，实现打印扫描的统一网络管理。
2. 核心特性
无驱动依赖：基于通用网络协议实现交互，终端只要支持HTTP/HTTPS即可调用，无需安装专属驱动；
跨平台兼容：天然支持Windows、macOS、Linux、Android、iOS等全平台，完美适配移动设备扫描需求；
功能标准化：统一了扫描参数配置、设备状态查询、任务管理、图像传输的指令规范，不同厂商的eSCL设备可以用同一套客户端逻辑调用；
支持远程扫描：只要终端与扫描仪网络互通，即可跨地域发起扫描任务，适配分布式办公、云办公场景。
3. 典型适用场景
企业公共扫描区部署、移动办公扫描、云扫描/归档场景、多设备共用的扫描仪资源池、无需本地存储的涉密扫描场景等。
4. 与传统扫描协议的差异
和TWAIN/WIA等本地驱动类协议相比，eSCL是网络原生协议，不需要本地硬件接口直连，也不需要驱动适配；和WSD（Web Services for Devices）等通用设备网络协议相比，eSCL是扫描场景专用协议，指令更精简、针对扫描业务流程做了专门优化，资源占用更低。
三、底层原理
1. 协议栈定位
eSCL属于应用层协议，完全基于成熟的HTTP/1.1协议栈实现，支持HTTP和HTTPS两种传输模式，默认监听80（HTTP）或443（HTTPS）端口，也可根据设备配置自定义端口，无需额外部署专用网络服务，依赖现有网络基础设施即可运行。
2. 核心交互模型
采用典型的「客户端-服务端」模型：
客户端：发起扫描请求的终端（电脑、手机、平板等），内置eSCL客户端模块，负责发送指令、接收图像数据；
服务端：扫描设备内置的eSCL服务端模块，负责解析指令、控制扫描硬件、返回结果和图像数据。
3. 设备发现机制
eSCL支持两种设备发现方式，降低用户使用门槛：
自动发现：基于mDNS/DNS-SD（多播DNS/服务发现）协议（也就是苹果Bonjour、安卓网络发现对应的技术），终端在局域网内可以自动检测到支持eSCL的扫描设备，无需手动输入IP地址；
手动发现：用户直接输入扫描设备的IP地址，即可访问对应的eSCL服务。
4. 核心交互逻辑与关键端点
eSCL的所有交互都基于RESTful风格的HTTP接口实现，核心端点如下：
端点路径
请求方式
功能说明
/eSCL/ScannerCapabilities
GET
获取扫描设备的能力参数，包括支持的分辨率、色彩模式、文档尺寸、输出格式、进纸器类型等
/eSCL/ScannerStatus
GET
查询设备实时状态，包括耗材余量、进纸器状态、错误信息、是否空闲等
/eSCL/ScanJobs
POST
提交扫描任务，请求体中携带扫描参数（分辨率、色彩模式、扫描区域、输出格式等），设备返回唯一任务ID
/eSCL/ScanJobs/{jobId}
GET
查询指定ID的扫描任务的执行状态（排队中/扫描中/已完成/失败）
/eSCL/ScanJobs/{jobId}
DELETE
取消指定的扫描任务
任务完成后返回的资源URL
GET
客户端通过该URL下载扫描生成的图像文件（JPEG/PDF/TIFF等格式）
5. 标准工作流程
以一次普通平板扫描为例，流程如下： ① 终端通过mDNS自动发现局域网内的eSCL扫描仪，获取设备IP； ② 终端向设备的/eSCL/ScannerCapabilities发起GET请求，获取设备支持的参数列表，供用户选择； ③ 用户选择扫描参数后，终端向/eSCL/ScanJobs发起POST请求，提交扫描任务，设备返回唯一任务ID； ④ 终端定时向/eSCL/ScanJobs/{jobId}发起GET请求，轮询任务状态； ⑤ 任务状态变为「已完成」后，终端通过设备返回的图像资源URL发起GET请求，下载扫描得到的文件，流程结束。 如果是ADF自动进纸器多页扫描，设备会自动将多页内容合并为单个PDF文件，或按页返回多个图像资源。
6. 安全机制
eSCL内置多层安全防护能力：
传输加密：支持HTTPS协议，扫描指令和图像数据在传输过程中加密，防止被窃听或篡改；
设备认证：支持HTTP基础认证、Bearer Token等认证方式，只有授权终端才能发起扫描任务，避免未授权访问；
权限隔离：部分企业级eSCL设备支持用户权限配置，不同用户的扫描任务隔离，扫描日志可审计，满足合规要求。
7. 数据格式规范
eSCL的指令请求/响应体早期采用XML格式，用WADL（Web应用描述语言）描述设备能力，近年也支持更轻量的JSON格式，适配移动端低带宽场景；扫描输出的图像数据采用JPEG、PNG、PDF、TIFF等通用标准格式，无需额外转换即可直接使用。
四、现状与生态
目前eSCL规范由惠普持续维护，最新版本为eSCL 2.0，新增了扫描预览、双面扫描参数细化、云服务直连等特性。开源社区也有成熟的实现方案：比如SANE扫描框架的escl后端、Linux下的Simple Scan软件、Adobe Scan等第三方扫描APP都支持eSCL，是当前移动扫描、云扫描场景的首选协议标准。
eSCL的发展脉络是从苹果为解决Mac平台扫描驱动痛点首创雏形，到逐步开放、标准化，最终成为全球通用的开放扫描协议，关键时间线如下：
一、萌芽探索期（2003-2009）：苹果生态内的专属协议
这一时期eSCL仅为苹果生态内的专属扫描协议，核心解决Mac平台扫描必须安装厂商驱动的痛点：
2003年：苹果发布Mac OS X 10.3 Panther操作系统，配套推出「Image Capture」图像捕获框架，同步上线初始扫描协议（内部称Apple Raster Scan Protocol），这是eSCL的雏形。该协议无需安装厂商驱动即可直接控制适配设备，初期仅惠普、佳能等少数合作厂商的设备支持。
2007年：苹果发布第一代iPhone，将这套扫描协议拓展到iOS平台的AirPrint功能中，支持移动设备直接扫描到本地，无需安装第三方APP，eSCL雏形开始在消费级扫描设备上小范围普及。
二、开放与标准化期（2010-2017）：从生态专属到全球通用标准
这一时期eSCL完成开放和标准化，摆脱苹果生态绑定，成为行业通用协议：
2010年：苹果正式公开eSCL完整规范文档，免费向所有厂商开放实现权限，不再绑定苹果生态，同时向行业标准组织提交标准化申请；同年惠普、爱普生、富士通等主流扫描厂商宣布全线新品原生支持eSCL，逐步替代原有厂商私有扫描协议，Windows、Linux平台也开始出现第三方eSCL实现。
2012年：微软发布Windows 8操作系统，原生集成eSCL支持，作为WIA（Windows图像获取）/TWAIN协议的补充，用于局域网无驱动扫描场景；同年欧洲计算机制造商协会（ECMA）正式立项eSCL的标准化工作，编号ECMA-370。
2015年：ECMA正式发布ECMA-370《Electronic Scan Communication Language (eSCL)》标准，首次统一了协议的核心规范：包括HTTP/XML传输规则、核心端点定义、请求/响应格式、状态码等，eSCL正式成为行业通用的开放协议。
2017年：国际标准化组织（ISO）/国际电工委员会（IEC）正式将ECMA-370采纳为国际标准，编号ISO/IEC 17959，eSCL成为全球官方认可的通用扫描通信标准；同期macOS、主流Linux发行版均完成原生支持，Windows 10进一步深化eSCL的集成，TWAIN/WIA的局域网扫描场景逐步被eSCL替代。
三、普及与扩展期（2017年至今）：适配多元场景的持续迭代
这一时期eSCL快速普及，同时持续扩展能力适配新的使用场景：
2019年：eSCL工作组发布v1.1扩展规范，新增对企业级扫描需求的适配：支持1200dpi以上高分辨率扫描、ADF自动进纸器批量双面扫描优化、扫描任务队列管理、自定义扫描区域扩展等能力，满足办公、生产场景的高性能扫描需求。
2021年：针对远程办公、跨网段扫描的兴起，eSCL扩展支持HTTPS加密传输、OAuth2.0认证、公网扫描任务下发能力，同时新增云存储直连扩展字段，支持扫描结果直接上传至OneDrive、Google Drive、飞书、钉钉等主流云平台，无需中转本地。
2023年至今：eSCL开始与AI能力整合，新增扫描参数AI推荐（自动识别文档类型调整亮度、对比度、纠偏）、OCR结果直出等扩展字段；目前工作组正在推进eSCL 2.0标准制定，计划拓展到3D扫描、工业检测扫描、医疗影像扫描等专业领域，成为覆盖全场景的通用扫描通信标准。
截至2024年，全球出货的主流MFP、扫描仪新品已100%原生支持eSCL协议，彻底取代了厂商私有扫描协议的市场份额。
eSCL的版本迭代并非传统软件的连续号版本体系，而是经历了「苹果内部雏形→开放规范→正式标准→行业扩展→草案迭代」五个阶段，其中仅v1.0是ISO/IEC正式国际标准，其余为行业可选扩展或制定中的草案，所有版本均保持向下兼容。各版本的更新细节、核心差异如下：
一、各版本详细迭代说明
1. 苹果内部雏形版（无公开版本号，2003-2009年）
这是eSCL的最初形态，仅为苹果生态内的专属私有协议，无公开规范：
初代雏形（2003年，搭载于Mac OS X 10.3 Panther） 苹果为解决Mac平台扫描必须安装厂商驱动的痛点，内部研发了名为Apple Raster Scan Protocol的扫描协议，即eSCL雏形。核心能力仅支持基础黑白/彩色扫描、300dpi分辨率、A4预设区域扫描，仅惠普、佳能等少数合作厂商的设备适配，绑定苹果Image Capture框架，仅Mac平台可用。
移动端拓展版（2007年，搭载于第一代iPhone AirPrint功能） 将协议拓展到iOS平台，苹果内部将其命名为AirScan，底层逻辑与Mac版一致，仅新增移动端适配的简化交互逻辑：支持移动设备一键触发扫描、扫描结果直接保存到iOS相册、自动适配手机屏幕的扫描区域裁剪。依然绑定苹果生态，未对外开放。
2. 公开初始规范版（2010年，业内常称v0.9公开版）
苹果首次公开eSCL完整实现规范，免费向所有厂商开放，摆脱生态绑定：
核心更新：
去掉苹果Image Capture框架的专属依赖，支持Windows、Linux等第三方系统自行实现驱动；
标准化4个核心端点，所有厂商实现必须兼容：/（设备信息查询）、/scan（扫描任务提交）、/scan/status/{taskId}（任务状态查询）、/scan/cancel/{taskId}（任务取消）；
统一传输规则：基于HTTP/1.1，请求/响应体为XML格式，内容类型为application/xml，默认端口80；
明确设备发现规则：必须通过Bonjour/mDNS广播_eSCL._tcp服务，客户端可自动发现局域网内的扫描设备。
与前版差异：从苹果生态专属协议变为开放协议，有了标准化的接口规则，厂商可自由开发跨平台驱动。
限制：无标准化认证机制、最高仅支持600dpi扫描、仅支持单面扫描（ADF双面为可选未规范）、无任务队列管理、无图像后处理参数。
3. 正式标准版v1.0（2015年ECMA-370发布，2017年采纳为ISO/IEC 17959国际标准）
这是eSCL首个有正式版本号的官方强制标准，解决了公开规范阶段厂商实现不一致、兼容性差的问题：
核心更新：
统一全量规范：明确所有核心端点的请求/响应格式、状态码规则（200成功、400参数错误、404任务不存在、500设备错误）、错误信息规范、扩展参数命名规则（必须以x-开头，避免和标准参数冲突）；
强制最低能力要求：所有符合v1.0标准的设备必须支持黑白/灰度/彩色三种色彩模式、300/600dpi两档分辨率、A4/A5预设扫描区域、单面ADF（可选）、基础亮度/对比度调节、扫描任务超时默认300秒；
明确互操作性要求：规范了与TWAIN、WIA、AirScan等既有扫描协议的映射规则，支持操作系统原生集成（Windows 8、macOS、主流Linux发行版均原生支持）。
与前版差异：从厂商自主实现的开放规范变为强制统一的国际标准，明确了所有实现的最低能力门槛。
适用场景：消费级扫描仪、家用MFP、操作系统原生扫描功能的基础协议。
4. 行业扩展规范v1.1（2019年eSCL行业工作组发布，非ISO/IEC正式标准，为可选扩展）
v1.0仅满足基础扫描需求，无法适配企业级高性能场景，工作组推出v1.1作为可选扩展规范：
核心更新：
性能大幅提升：最高支持分辨率从600dpi提升至4800dpi，支持1200dpi以上高速扫描无卡顿、ADF双面扫描的进纸方向/跳过空白页/分离页检测等参数优化、支持每分钟60页以上的高速扫描任务；
新增任务管理能力：支持多扫描任务队列管理（提交、查询、暂停、恢复、删除多个任务）、任务优先级设置、扫描结果分卷存储（避免大文件超时）；
扩展扫描能力：支持自定义任意扫描区域（可指定X/Y坐标、宽高，无需预设区域）、新增基础图像后处理参数（自动纠偏、去噪点、背景去除、色彩增强）；
安全能力升级：新增可选的本地认证机制（设备可设置eSCL接口访问的用户名/密码，避免未授权访问）、支持扫描结果直接返回base64编码，无需中转存储。
与前版差异：从基础扫描协议升级为支持企业级高性能需求的扩展协议，新增大量可选能力，不破坏v1.0的向下兼容性。
适用场景：企业级MFP、高速扫描仪、办公自动化场景。
5. 云与远程办公扩展规范（2021年eSCL行业工作组发布，为v1.1的可选扩展包）
针对远程办公、跨网段扫描的兴起，对v1.1做场景化扩展：
核心更新：
传输与安全升级：强制要求公网访问场景必须使用HTTPS加密传输、新增OAuth2.0认证支持，支持跨网段、公网的扫描任务下发，无需将设备暴露在公网；
云原生能力：新增云存储直连扩展字段，支持扫描结果直接上传至OneDrive、Google Drive、飞书、钉钉等主流云平台，无需客户端中转；
效率优化：新增扫描模板参数（可保存常用扫描参数组合，一键调用）、批量任务拆分能力（大体积扫描任务自动拆分为多个子任务，避免超时失败）。
6. eSCL 2.0草案（2023年至今工作组推进制定，尚未正式发布）
适配AI、工业、医疗等新场景的需求，对协议进行全面升级，目前仍在迭代中，最终规范可能调整：
核心更新（草案阶段）：
核心能力升级：强制全场景HTTPS传输、新增端到端加密支持、设备身份认证规范（防止伪造扫描设备接入网络）；
AI能力整合：新增AI文档识别扩展参数（支持自动识别身份证、发票、合同等文档类型，自动调整扫描参数）、OCR结果直出能力（扫描结果直接返回结构化文字+坐标，无需二次OCR）、智能图像修复参数（自动去除折痕、污渍）；
场景拓展：新增3D扫描、工业检测扫描、医疗影像扫描的参数规范，打破eSCL仅支持文档扫描的限制，覆盖全品类扫描设备；
集群能力：支持多扫描设备协同扫描，大体积任务可拆分到多个设备并行处理，提升扫描效率。
与前版差异：从文档扫描专用协议升级为全品类扫描设备的通用通信协议，新增大量AI、专业场景能力，保持向下兼容v1.x所有规范。
二、各版本核心差异对比表
版本标识
发布时间
标准属性
最高分辨率
ADF支持
任务管理
安全机制
适用场景
苹果雏形版
2003年
苹果内部私有协议
300dpi
不支持
无
无
早期Mac平台专属扫描
移动端拓展版
2007年
苹果内部私有协议
300dpi
不支持
无
无
早期iOS平台AirPrint扫描
公开初始规范版
2010年
苹果开放规范
600dpi
单面可选
单次任务
无
跨平台基础扫描、消费级设备
v1.0正式标准版
2015/2017
ISO/IEC 17959国际标准
600dpi
单面可选
单次任务
无（可选本地认证）
全平台基础扫描、操作系统原生集成
v1.1扩展规范版
2019年
行业可选扩展规范
4800dpi
双面优化+跳过空白页
多任务队列
可选本地认证、base64直出
企业级MFP、高速办公扫描
云扩展规范
2021年
v1.1可选扩展包
4800dpi
双面优化
多任务队列+任务拆分
OAuth2.0、HTTPS加密
远程办公、云扫描场景
2.0草案版
2023年至今
制定中的下一代标准
无上限（支持专业场景）
高速批量ADF+3D扫描
集群任务管理
端到端加密、设备身份认证
工业、医疗、3D扫描等专业场景
三、兼容性与现状说明
所有后续版本均完全兼容v1.0的核心规范：支持v1.1/2.0草案的设备可以正常响应v1.0客户端的请求，老旧客户端也可以正常使用新设备的基础扫描能力。
除v1.0为强制标准外，其余扩展规范、草案均为可选能力，厂商可根据设备定位选择实现部分或全部能力，不存在强制要求。
目前市场现状：消费级扫描仪、家用MFP普遍仅支持v1.0标准；企业级中高端MFP普遍支持v1.1及云扩展规范；工业、医疗级专业扫描设备已开始逐步支持2.0草案的特性。
前置说明
目前行业内约定俗成的**eSCL（Electronic Scanner Communication Language，电子扫描通信语言）**特指办公扫描设备/多功能一体机（MFP）的通用控制协议，由苹果最早推动标准化，现已被ISO/IEC 17959收录为国际规范，核心是基于HTTP/HTTPS传输、XML格式承载控制指令，支持局域网自动发现、无驱动扫描，已替代绝大多数厂商私有扫描协议，Windows/macOS/Linux系统均原生支持该协议。
一、基础语法
eSCL采用「客户端-服务器」模型：客户端为电脑、手机等扫描发起方，服务器为扫描设备内置的eSCL服务，默认开放端口为80(HTTP)/443(HTTPS)，局域网内可通过mDNS/DNS-SD（即Bonjour零配置网络）自动发现支持eSCL的设备。
1. 通用请求规则
所有请求均为标准HTTP请求，核心规则如下：
常用请求方法：GET（查询能力/状态/扫描结果）、POST（创建扫描任务）、DELETE（取消扫描任务）
请求路径统一以设备暴露的eSCL根路径开头，通常为http://<设备IP>/eSCL/Scanner/
请求头需声明Accept字段指定期望的返回类型（如application/xml/image/jpeg/image/tiff），认证场景下需携带Authorization头（支持Basic/Digest认证）
请求体为XML格式，仅POST创建扫描任务时需要携带
2. 核心端点（API路径）说明
请求方法
端点路径
功能说明
GET
/eSCL/Scanner/Capability
获取设备支持的扫描能力（色彩模式、分辨率、支持输入源、纸张尺寸等）
GET
/eSCL/Scanner/Status
获取设备当前运行状态（是否空闲、纸盒状态、错误信息等）
POST
/eSCL/Scanner/Jobs
创建扫描任务，触发扫描流程
GET
/eSCL/Scanner/Jobs/{JobID}
查询指定扫描任务的执行状态
DELETE
/eSCL/Scanner/Jobs/{JobID}
取消正在执行的扫描任务
GET
/eSCL/Scanner/Jobs/{JobID}/NextDocument
获取当前扫描任务的下一个扫描页图像
GET
/eSCL/Scanner/Jobs/{JobID}/FinalDocument
获取当前扫描任务的最后一页图像
3. 核心载荷语法
（1）创建扫描任务请求体（XML）
根元素为
xml
（2）通用响应体语法
任务创建/状态查询成功返回
错误返回
扫描结果为二进制图像数据，无XML载荷
4. 核心状态码说明
HTTP状态码
eSCL含义
200
请求成功
201
扫描任务创建成功
204
无更多扫描页（调用NextDocument时无下一页返回该状态）
400
请求参数错误（如分辨率超出设备支持范围）
401/403
未认证/无权限访问eSCL接口
404
请求的端点/任务不存在
500
设备内部错误（如卡纸、扫描组件故障）
二、典型场景示例
假设扫描设备IP为192.168.1.100，支持账号admin、密码123456。
1. 发现设备（mDNS/Bonjour）
无需主动请求，开启Bonjour的设备会自动出现在系统扫描列表中，也可通过命令行主动发现：
bash
# macOS/Linux下通过dns-sd命令扫描局域网eSCL设备
dns-sd -B _http._tcp
# 返回结果会包含设备名称、IP、eSCL服务路径等信息
2. 获取设备扫描能力
http
GET /eSCL/Scanner/Capability HTTP/1.1
Host: 192.168.1.100
Accept: application/xml
Authorization: Basic YWRtaW46MTIzNDU2
成功响应示例：
http
HTTP/1.1 200 OK
Content-Type: application/xml
3. 创建扫描任务（平板A4彩色300dpi输出JPEG）
http
POST /eSCL/Scanner/Jobs HTTP/1.1
Host: 192.168.1.100
Content-Type: application/xml
Accept: application/xml
Authorization: Basic YWRtaW46MTIzNDU2
成功响应示例：
http
HTTP/1.1 201 Created
Location: http://192.168.1.100/eSCL/Scanner/Jobs/987654321
Content-Type: application/xml
4. 获取扫描结果
首先轮询任务状态，待状态变为Completed后，调用NextDocument获取图像：
http
GET /eSCL/Scanner/Jobs/987654321/NextDocument HTTP/1.1
Host: 192.168.1.100
Accept: image/jpeg
Authorization: Basic YWRtaW46MTIzNDU2
若有扫描页：返回200 OK，响应体为JPEG二进制图像数据
若无更多扫描页：返回204 No Content
5. 取消扫描任务
http
DELETE /eSCL/Scanner/Jobs/987654321 HTTP/1.1
Host: 192.168.1.100
Authorization: Basic YWRtaW46MTIzNDU2
成功响应：HTTP/1.1 200 OK
三、注意事项
兼容性差异：不同厂商（惠普、爱普生、佳能、富士通等）的eSCL实现存在细微扩展差异，部分私有参数需要参考对应厂商的开发文档。
认证要求：多数企业级扫描设备会开启eSCL权限控制，需提前在设备侧配置访问账号。
网络限制：eSCL通常仅在局域网内开放，跨网段访问需要设备侧配置路由规则，部分设备支持VPN接入。
安全建议：生产环境优先使用HTTPS协议，避免扫描内容明文传输，老旧设备仅支持HTTP时需评估安全风险。
首先要明确：eSCL并非独立的编程语言，而是基于HTTP/1.1协议扩展的RESTful接口约定，其“基本语法”本质是eSCL协议对HTTP请求/响应的格式、端点路径、数据字段、参数枚举的统一规范，所有交互完全符合HTTP基础标准，仅在payload结构和服务端点上做了扫描场景的专属约定。
一、基础前置约定（所有交互的通用规则）
1. 传输层规则
底层完全基于HTTP/HTTPS协议，默认监听80（HTTP）/443（HTTPS）端口，支持设备自定义端口
支持长连接复用，减少多次扫描任务的握手开销
2. 编码与媒体类型
字符集统一为UTF-8
请求/响应体支持两种官方认可的媒体格式，通过请求头Content-Type指定：
媒体类型
适用场景
特点
application/xml
早期规范默认格式
兼容性好，用WADL（Web应用描述语言）标准化描述设备能力
application/json
近年新设备主流格式
体积小、解析快，适配移动端低带宽场景
3. 路径约定
所有标准eSCL接口统一放在设备Web服务的/eSCL/路径下，部分厂商会保留该路径的向下兼容，自定义扩展接口通常放在/eSCL/Extensions/子路径下。
二、核心接口语法（标准端点的请求/响应规范）
eSCL的核心交互由5个标准端点实现，所有端点均遵循RESTful风格：
1. 获取设备扫描能力
请求语法：
GET /eSCL/ScannerCapabilities HTTP/1.1
Host: <扫描仪IP>
Authorization: Basic
Accept: application/xml, application/json
响应语法： 返回设备支持的所有扫描参数的范围、枚举值，是客户端生成扫描配置界面的依据。
示例（JSON格式响应）：
json
{
"scanner_capabilities": {
"max_resolution": 1200,
"min_resolution": 75,
"color_modes": ["Color", "Gray", "Mono"],
"document_formats": ["PDF", "JPEG", "TIFF", "PNG"],
"supported_page_sizes": ["A4", "Letter", "Legal", "Custom"],
"adf_support": true,
"duplex_support": true,
"preview_support": true
}
}
XML格式则用
2. 查询设备实时状态
请求语法：
GET /eSCL/ScannerStatus HTTP/1.1
Host: <扫描仪IP>
响应语法： 返回设备当前的运行状态、资源占用情况。
示例（JSON格式响应）：
json
{
"status": "idle", # 状态枚举：idle(空闲)/scanning(扫描中)/error(故障)/offline(离线)
"adf_status": "loaded", # 自动进纸器状态：loaded(有纸)/empty(无纸)/jammed(卡纸)
"toner_level": 85, # 耗材余量（%）
"error_message": null
}
3. 提交扫描任务
请求语法：
POST /eSCL/ScanJobs HTTP/1.1
Host: <扫描仪IP>
Content-Type: application/json # 或 application/xml
请求体语法（核心扫描参数的规范写法）：
参数名
类型
必填
说明
合法枚举/取值范围
DocumentFormat
字符串
是
输出文件格式
PDF/JPEG/TIFF/PNG/PDF/A
Resolution
整数
是
扫描分辨率（dpi）
需≤设备最大支持分辨率，常见取值75/150/300/600/1200
ColorMode
字符串
是
色彩模式
Color(彩色)/Gray(灰度)/Mono(黑白)
ContentType
字符串
否
扫描内容类型
Document(文档，默认，自动纠偏去底色)/Photo(照片，保留原色)
Duplex
布尔值
否
是否双面扫描
true/false，默认false
ScanRegion
对象
否
扫描区域
包含X/Y/Width/Height四个字段，单位由设备能力返回的Unit指定（mm或pixel），默认全幅扫描
PageCount
整数
否
扫描页数
ADF进纸器场景下指定，默认扫描完所有进纸
请求体示例（JSON）：
json
{
"DocumentFormat": "PDF",
"Resolution": 300,
"ColorMode": "Color",
"ContentType": "Document",
"Duplex": true,
"ScanRegion": {
"X": 0,
"Y": 0,
"Width": 210,
"Height": 297
}
}
XML格式则用首字母大写的驼峰标签嵌套，比如
响应语法： HTTP状态码201 Created，表示任务提交成功：
响应头Location字段直接指向任务状态查询地址：/eSCL/ScanJobs/<唯一任务ID>
响应体返回任务基础信息：
json
{
"job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "pending",
"created_at": "2026-06-12T14:45:41+08:00"
}
4. 任务管理与结果获取
（1）查询/取消任务
查询任务语法：
GET /eSCL/ScanJobs/
Host: <扫描仪IP>
响应示例：
json
{
"job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed", # 状态枚举：pending(排队中)/scanning(扫描中)/completed(完成)/aborted(已取消)/error(失败)
"progress": 100,
"document_url": "http://192.168.1.100/eSCL/ScanJobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/Document",
"preview_url": "http://192.168.1.100/eSCL/ScanJobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/Preview" # eSCL 2.0新增
}
取消任务语法：
DELETE /eSCL/ScanJobs/
Host: <扫描仪IP>
响应为204 No Content表示取消成功。
（2）下载扫描结果
请求语法：
GET
Host: <扫描仪IP>
响应直接返回扫描生成的原始文件，Content-Type对应文件格式（比如application/pdf、image/jpeg），多页扫描默认返回合并后的单个PDF，也可配置为按页返回多个文件。
三、设备自动发现语法（mDNS/DNS-SD约定）
局域网内无需手动输入IP即可发现eSCL设备的规则：
设备广播的mDNS服务类型统一为_eSCL._tcp（惠普早期设备为_hp-scan._tcp，后续开放规范统一为标准类型）
mDNS TXT记录中的关键约定字段：
字段名
说明
path
eSCL服务根路径，默认/eSCL/
rs
设备支持的最大横向分辨率（dpi）
cs
设备支持的最大色彩深度（bit）
uuid
设备全局唯一标识
ty
设备型号字符串
四、错误处理语法
eSCL底层沿用HTTP标准状态码，专属错误信息放在响应体中：
HTTP状态码
含义
常见场景
400
请求参数非法
分辨率超出设备支持范围、扫描区域超出最大尺寸
401
未认证
未提供账号密码或Token
403
权限不足
当前用户无扫描权限、设备被锁定
404
资源不存在
端点路径错误、任务ID无效
409
冲突
设备正忙、ADF卡纸无法接受新任务
500/503
设备故障
扫描硬件错误、服务暂时不可用
错误响应体示例（JSON）：
json
{
"error_code": "invalid_resolution",
"error_message": "Resolution 2400 is not supported, max supported is 1200dpi",
"details": {
"param": "Resolution",
"allowed_values": [75, 150, 300, 600, 1200]
}
}
五、版本扩展说明
eSCL 2.0相比1.x的语法扩展：
新增/eSCL/ScanJobs/{jobId}/Preview端点，支持获取扫描预览图
新增ImageEnhancement参数组，支持自动纠偏、去底色、锐化等图像预处理参数
支持云扫描直连扩展参数，可直接将扫描结果上传到指定云存储服务
注：佳能、兄弟、理光等兼容eSCL的厂商会在标准语法基础上增加少量自定义扩展参数（比如佳能的BlankPageSkip跳过空白页参数），核心标准语法在所有兼容设备上通用。
Windows Image Acquisition (WIA) 服务是 Windows 操作系统中的一个关键服务，主要用于扫描仪、数码相机等设备的图像采集和管理。它为这些设备提供必要的软件接口，使得用户可以通过标准应用程序（如 Windows 照片查看器、扫描仪应用等）来获取图像数据。
1. WIA 服务概述
服务名称： StiSvc
显示名称： Windows Image Acquisition (WIA)
描述： 为扫描仪和照相机提供图像采集服务。
2. WIA 服务的功能
WIA 服务主要负责：
与硬件设备（如扫描仪、数码相机、摄像头）通信，采集图像数据。
向其他应用程序提供设备接口，使得用户能够通过图形界面或命令行工具访问设备。
支持图像采集功能的各类标准协议（如 TWAIN）。
例如，当你连接扫描仪并使用 Windows 扫描 应用或其他图像处理软件时，WIA 服务会被触发，确保软件可以识别并与设备正常交互。
3. WIA 服务的属性解释
(1) 常规
启动类型： 你可以设置该服务的启动类型，常见的有：
自动： 系统启动时自动启动该服务。
手动： 需要手动启动该服务。
禁用： 禁止该服务运行。
服务状态： 显示当前服务的状态（例如，正在运行或已停止）。你可以通过该属性来手动启动或停止服务。
(2) 登录
登录帐户： 这个选项定义了该服务运行时所用的帐户。通常，WIA 服务会使用 本地系统帐户（Local System Account）或者 网络服务帐户（Network Service Account）来运行。
本地系统帐户 是一个高权限帐户，通常用于操作系统本身需要的服务。
如果你遇到权限问题，可以考虑手动更改服务的登录帐户，但这种操作需要谨慎，因为可能会影响其他服务或设备的正常运行。
(3) 恢复
该选项定义了如果该服务发生错误时的恢复策略。例如：
第一次失败： 可选择“重新启动服务”或“无操作”等。
第二次失败： 同上。
后续失败： 同上，具体操作可以是重启服务、执行程序或其它操作。
如果你发现 WIA 服务频繁失败，可以通过调整恢复设置来让它在失败后自动重启。
(4) 依存关系
依赖的服务： WIA 服务可能依赖其他服务来正常运行。例如：
Remote Procedure Call (RPC)：是一个系统级服务，允许程序之间进行通信。
Plug and Play：它负责识别连接到计算机的硬件设备并使之能被使用。
这些服务必须处于运行状态，才能确保 WIA 服务能够正常启动和工作。
4. WIA 服务工作原理
WIA 通过提供接口来管理图像设备的图像采集功能。例如，当你启动扫描仪软件并按下扫描按钮时，WIA 服务会与扫描仪硬件进行通信，传输图像数据并处理。
设备连接： 设备通过 USB 或其他连接方式与计算机连接，Windows 会使用 WIA 服务识别设备。
数据采集： 在启动扫描程序时，WIA 会与设备进行通信，捕获图像数据。
数据传输： 图像数据被传送到计算机内存或硬盘，并由相关软件进一步处理。
5. 为什么 WIA 服务可能停止或无法启动
WIA 服务在启动后停止或无法启动的原因可能有多种，常见的原因包括：
设备驱动问题： 如果相关设备的驱动程序损坏或未安装，WIA 服务可能无法正常与硬件通信。
服务依赖关系问题： 如果 WIA 服务的依赖服务（如 RPC 或 Plug and Play）未启动或出现问题，WIA 服务也无法正常运行。
权限问题： 如果系统账户的权限不正确或受到限制，可能会导致 WIA 服务无法启动或运行不稳定。
系统文件损坏： 操作系统文件损坏或丢失，可能导致 WIA 服务无法启动。
硬件冲突： 多个设备驱动程序之间的冲突或硬件设备本身的故障，可能会干扰 WIA 服务的正常运行。
6. 如何解决 WIA 服务问题
检查设备驱动： 确保与扫描仪、数码相机等设备相关的驱动程序已正确安装并是最新版本。
查看服务依赖项： 检查 WIA 服务的依赖项（如 RPC 服务、Plug and Play 服务）是否正常运行。
查看系统日志： 使用事件查看器查看 WIA 服务相关的错误日志，从中获取更多的错误信息。
重新启动服务： 在服务管理器中手动启动 WIA 服务，确保其启动类型设置为“自动”。
检查硬件连接： 确保设备连接正常，USB 或其他接口没有故障。
通过这些方法，你可以诊断并修复 WIA 服务停止的问题，确保扫描仪和相机等设备能正常工作。
遇到的问题是 Windows Image Acquisition (WIA) 服务在 Windows Server 2025 启动后停止工作，这可能与多个因素相关，特别是与驱动程序或服务依赖项的配置有关。以下是一些可能的原因和解决方案：
1. 驱动程序问题
WIA 服务通常与扫描仪或数字相机等设备的驱动程序相关。如果设备的驱动程序不兼容或者没有正确安装，可能会导致 WIA 服务在启动时无法正常运行，甚至在重启后停止。
解决方法：
确保所有相关设备（如扫描仪）的驱动程序已经正确安装，并且是最新版本。
检查设备管理器中是否有任何设备显示为“未安装”或有问题（黄色感叹号）。如果有，尝试更新驱动程序或者重新安装驱动。
访问设备制造商的官方网站，下载并安装最新的 WIA 驱动程序。
2. 服务依赖关系
WIA 服务有一些依赖项，如 Windows Image Acquisition (WIA) Driver 或 Remote Procedure Call (RPC) 服务等。如果这些依赖项没有正确运行，WIA 服务也可能会停止。
解决方法：
打开 服务管理器（运行 services.msc），确保 WIA 服务及其所有依赖项都已启动并设置为自动启动。
检查 WIA 服务的依赖项是否正常启动（例如：Remote Procedure Call (RPC)、Plug and Play 等服务）。
右键点击 WIA 服务，选择 属性。
点击 依赖关系 标签，查看所列的服务，并确保它们没有问题。
3. 权限问题
在某些情况下，权限问题也可能导致服务在启动后停止。例如，WIA 服务可能需要特定的管理员权限或者用户权限才能正确运行。
解决方法：
确保你使用的是具有足够权限的账户来启动和配置 WIA 服务。尝试以管理员身份运行并启动服务。
确认没有任何安全策略或组策略限制了 WIA 服务的运行。
4. 系统日志和事件查看器
可以通过 事件查看器 (Event Viewer) 查看与 WIA 服务相关的错误日志，找出是否有与驱动程序、权限、依赖项等相关的错误信息。
解决方法：
按 Win + X 键，选择 事件查看器。
浏览到 Windows 日志 > 应用程序，查看 WIA 服务相关的错误消息或警告。
根据日志中的详细错误信息，采取相应的修复措施。
5. 服务配置问题
有时，服务配置可能被意外修改，导致服务启动后失败。
解决方法：
在服务管理器中，确保 WIA 服务的启动类型设置为 自动。
打开服务管理器，找到 Windows Image Acquisition (WIA) 服务，右键点击它，选择 属性。
在 常规 标签下，确保启动类型设置为 自动，然后点击 启动 按钮。
6. 系统更新
确保 Windows Server 2025 已经安装了所有最新的系统更新。某些更新可能修复与设备驱动或服务相关的已知问题。
解决方法：
运行 Windows 更新，检查并安装所有可用的更新。
重启服务器后，查看 WIA 服务是否正常启动。
7. 驱动冲突
如果你安装了多个相关设备的驱动程序，或者使用了不兼容的第三方软件，可能会导致冲突，进而导致 WIA 服务停止。
解决方法：
检查是否安装了多个版本的驱动程序，尤其是同一设备的驱动程序，或与 WIA 相关的第三方扫描仪管理软件。
尝试禁用或卸载一些不必要的驱动程序或软件，看是否能够解决问题。
如果 WIA 服务每次重启后停止，问题可能出在设备驱动程序、服务依赖关系、权限、配置或系统更新等方面。建议按上述步骤逐一排查，并在 事件查看器 中查看更详细的错误日志，以帮助进一步诊断问题。如果排查后仍未能解决，考虑更新操作系统或联系设备制造商支持。