接口边界。不提供 SDK 下载，不公开未授权头文件。
集成商检索「OpenHarmony 人脸识别 SDK」时，期望往往是：调几个函数就能开门。终端厂若把名单策略、活体开关、继电器时序全部藏进闭源 so，二次开发会在现场失效时无法打断点。预研应划分：SDK 封装成像与推理，应用保留事务。
一、适合进 SDK 的
相机打开、双目对齐、取帧；
人脸检测与质量分；
活体分数与特征提取；
特征比对的一次调用（输入特征或模板 ID，输出分数与阈值关系）。
这些靠近 HAL 与模型，换算法版本时可以只换 SDK，不改通行 UI。开源鸿蒙人脸机的「算法包」常常以 SDK + 模型文件的形式存在。
二、必须留在应用里的
名单增删、权限组、有效期；
是否允许口罩模式、是否允许关闭活体（关闭必须审计）；
继电器脉宽、韦根位、常开常闭；
HTTP API / MQTT 事件字段、设备 ID；
与麒麟 / 统信管理端的字典对齐。
这些是通行事务。若 SDK 内部直接拉 GPIO，应用层无法按项目改时序，闸机联调只能改硬件或等厂家改 so。前文闸机联调文强调电气参数可测；SDK 边界是同一纪律的软件面。
三、手机 SDK 不能当模板
HarmonyOS 应用调用系统生物识别，拿到成功/失败即可。OpenHarmony 人脸识别 SDK 面向门禁，调用方是通行应用，不是普通 App。把手机人脸 SDK 的教学示例搬到鸿蒙系统人脸机上，会缺开门与名单两段。
四、厂家文档怎么读
鸿蒙人脸识别厂家若只提供「一键识别」Demo，没有错误码、质量分、活体分、模板管理接口，集成商应视为演示包而非工程 SDK。云识客等整机实践若同时提供 API / MQTT，说明事务出口在应用或网关，而不是只在本地 so——预研仍要看字段表，而不是看 Demo 动画。
海康、大华等平台的设备接入文档，对「事件字段稳定性」是有用对照。换开源鸿蒙前端，字段稳定性要求不应降低。
五、小结
OpenHarmony 人脸识别 SDK 管成像与推理，通行应用管名单与开门。鸿蒙人脸识别终端的二次开发，成功与否取决于这条边界是否写进接口说明书。欢迎讨论你们被 SDK 藏进 GPIO 之后，现场是怎么改脉宽的。
