1. 功能与应用目标
功能概述
开机动画模块用于为设备配置开机展示内容，通过上传指定格式的 ZIP 包资源，设置设备启动时的动画效果，支持按机型或分组维度下发配置。
应用目标
统一设备开机界面，树立统一品牌形象；
支持差异化定制，满足多设备/多客户需求；
提供模板与规范，简化动画内容制作与发布流程；
配置集中管理，设备端自动获取并生效，提升运维效率。
主要操作
添加规则：选择“机型”或“分组”，填写规则名称，上传符合规范的动画 ZIP 包；
发布：规则创建成功后，系统将自动下发配置至适配设备。设备开机后将播放新动画。
次要操作
修改：支持替换 ZIP 包并保存，更新后自动下发新动画资源至设备；
删除：删除规则后，相关设备可恢复默认动画，或重新绑定其他规则。
应用范围
该模块适用于所有 iMin 设备，包括 Mobile POS、Desktop POS/KDS、Printer、Scale 等类型。每个设备仅可绑定一条开机动画规则。
当规则绑定到“分组”时，组内设备按所属机型匹配 ZIP 包动画资源；
若组内设备的机型未包含对应资源，则不会接收配置指令；
KC 提供模板与 ZIP 包制作规则指引，确保上传文件合规。
资源要求与限制
图片格式：PNG
图片尺寸：请查看硬件的屏幕分辨率
图片张数：建议控制在 10~250 张范围内
注：Swan 2 系列建议不超过 40 张（平台将提示）
单图大小：≤500KB
ZIP 包大小：≤10MB
命名要求：
ZIP 包与文件夹名称建议使用英文或数字，不支持多层嵌套结构；
图片命名为五位数连续编号（如：00000、00001、...、00249）
设备下发逻辑说明
若设备为 KMA、IMA 类型，且在线，配置指令立即下发；
若为 KMA 类型，设备离线状态下将在上线后自动补发；
若为 IMA 类型，指令存在有效期，超时未上线则配置失效。
2. 主要操作
2.1 添加规则
操作说明
“添加规则”用于为 iMin 设备配置自定义的开机动画。通过上传符合规范的 zip 格式动画资源包，用户可将企业品牌或门店形象展示于设备启动过程中，统一视觉风格、提升品牌感知。
系统支持按 设备机型 或 设备分组 创建开机动画规则。若选择分组，系统将依据分组内设备的机型信息匹配对应配置。若设备缺少机型信息或不在支持列表中，则不会接收该配置。
开机动画资源需由用户按照 KC 提供的模板规范制作并打包上传，内容格式及尺寸需与设备机型一致，否则将无法正常播放。
操作流程
进入创建页面
点击“开机动画”模块页面右上角【添加规则】按钮，进入创建弹窗。
填写基本信息
规则名称（必填）：自定义命名，建议包含品牌或门店名；
适用范围（必选）：支持选择「机型」或「分组」：
选择 机型：仅该型号设备适用；
选择 分组：系统将自动识别分组内包含的所有机型，并为每个机型生成一个上传动画资源的区域。
上传动画 ZIP 包（必填）：
每个机型均需上传一份符合规范的动画资源包；
所有上传区域必须完成资源上传，否则系统将不允许提交；
ZIP 包内容必须符合 KC 平台提供的命名与尺寸规范（系统提供模板下载与制作指引）；
若资源超过限制（如 Swan 2 系列支持最多 40 张图片），系统将提示错误。
提交规则
点击【提交】，系统将校验资源文件与机型适配情况；
校验通过后，规则状态设为“未发布”，等待手动发布；
不支持动画或信息缺失的设备将被自动排除，不接收配置。
注意事项
本功能适用于所有 iMin 设备，仅当设备具备机型信息且支持动画播放时才可生效；
若选择“分组”，系统将根据组内实际设备所涉及的机型动态展示多个上传区域：
每个机型必须上传对应的动画 ZIP 包，否则无法提交规则；
上传区域将根据分组内设备机型动态生成，支持覆盖 Swan、POS、Printer、KDS 等类型；
动画资源需严格遵守 KC 平台规范，典型要求如下：
图片格式为 PNG，文件命名为
00000.png至00249.png的五位数序列；单图 ≤ 500KB，ZIP 包 ≤ 10MB；
不支持 ZIP 包内嵌套子目录；
配置一经提交，系统将根据设备在线状态与类型决定是否立即下发（详见发布章节）；
若需调整资源或适配机型，请使用“修改”功能进行更新。
2.2 发布
操作说明
“发布”操作用于将已创建的开机动画规则正式下发至适配设备。规则在发布前处于“未发布”状态，仅在成功发布后，设备才会接收到开机动画配置指令。系统将根据设备在线状态、设备类型、是否具备机型信息等条件，自动决定下发策略。
该操作适用于需要立即推送动画资源至设备，或在规则测试确认无误后进行全量部署的场景。
操作流程
进入发布操作
在“开机动画”模块的规则列表中，点击目标规则所在行右侧的【发布】按钮；
系统弹出发布确认窗口，展示当前规则的基本信息。
确认发布
仔细确认规则名称、适用范围（机型或分组）及动画资源是否准确；
点击【确认发布】后，系统将执行下发操作；
发布状态更新为“已发布”，成功的设备将接收到配置并在下次重启时播放新动画。
查看状态
发布后可在规则列表中查看状态标签（“已发布”/“未发布”）；
如需查看动画详情或调整资源，可通过“修改”功能进行操作。
注意事项
发布操作不可撤销，请确保动画内容与适配对象正确无误；
若规则适用范围为“分组”，系统将依据分组内设备的机型信息进行适配：
仅向机型匹配成功的设备下发动画配置；
不具备机型信息或不支持动画的设备将被自动跳过；
设备类型影响下发机制：
KMA/IMA设备在线：配置立即下发；
KMA设备离线：上线后自动补发；
IMA设备离线：存在有效期，超时未上线将失效；
发布后如需更新动画资源，请使用“修改”功能重新上传 ZIP 包并提交，系统将重新下发；
每台设备仅允许绑定一条动画规则，若存在重复规则，后发布者生效。
3. 次要操作
3.1 修改
操作说明
编辑功能用于更新已创建的开机动画规则内容。当动画资源需要替换、规则名称需要调整时，可通过编辑方式完成修改。系统支持编辑规则名称与上传的 ZIP 动画资源，但适用范围（机型或分组）不可更改。
编辑保存后，系统将立即触发动画资源下发流程，自动替换设备端已有的动画配置。
操作流程
进入编辑界面
在“开机动画”模块中，找到目标规则；
点击规则行尾的【操作】按钮，选择【修改】进入编辑页面。
编辑内容
设备型号/分组字段为只读，无法修改；
可修改以下内容：
规则名称：支持重命名，建议与品牌/机型保持关联；
上传 ZIP 包：可替换为新的动画资源包，格式需符合 KC 平台规范。
ZIP 包必须重新上传，否则无法保存；
上传完成后将显示文件名，点击右侧图标可删除重传。
保存修改
确认信息无误后点击【保存】，系统将执行以下操作：
更新规则内容；
向匹配设备下发最新动画资源，覆盖原有配置；
规则状态保持不变，无需重新发布。
注意事项
机型或分组为规则创建时绑定，不可更改；
ZIP 包为必填项，若未重新上传动画资源，系统将提示错误；
替换动画资源后，系统将自动进行资源下发：
KMA/IMA 在线设备立即生效；
KMA 离线设备将在上线后自动补发；
IMA 离线设备存在下发有效期，超时未上线将失效；
替换动画资源后，原设备动画内容将被新内容覆盖，不可恢复；
若仅需更新 ZIP 内容，保留原规则名称与适用范围不变即可。
3.2 删除规则
操作说明
删除功能用于彻底移除某条开机动画规则。当动画配置不再适用，或需要重新创建规则时，可通过“删除”操作撤销其在设备上的应用。规则删除后，系统将自动清除相关设备上的动画配置，使设备恢复默认开机画面。
删除操作为不可撤销操作，请在确认不再使用当前规则后再执行。
操作流程
发起删除操作
在“开机动画”模块规则列表中，点击目标规则右侧的【操作】按钮；
选择【删除】进入删除确认界面。
确认删除
系统弹出确认提示框，显示当前将删除的规则名称；
点击【确认】按钮后，系统将立即执行删除操作。
系统处理
删除成功后，规则将从列表中移除；
系统将根据设备类型与状态判断是否立即下发清除指令；
已配置该规则的设备将自动恢复默认开机动画画面。
注意事项
删除操作不可撤回，请确保该规则不再被使用；
删除后，已应用该规则的设备将不再显示原动画内容，恢复为默认动画；
下发逻辑说明如下：
KMA/IMA 在线设备：立即下发清除动画资源指令；
KMA 离线设备：设备上线后将自动接收清除指令；
IMA 离线设备：清除指令存在有效期，若设备在有效期内未上线，指令将失效；
若后续仍需使用同一动画内容，请通过“添加规则”重新配置；
删除操作将记录至系统日志，可用于后续审计。
4. 配置项说明
开机动画模块的配置项主要用于定义规则的名称、适用范围以及上传的动画资源。具体字段说明如下：
配置项名称 | 是否必填 | 说明 |
规则名称 | 是 | 用户自定义当前规则的名称，建议包含品牌或使用场景关键词，便于后续识别与维护。 |
适用范围 | 是 | 选择“机型”或“分组”作为规则作用对象： - 选择“机型”：该动画规则仅适用于所选机型的设备； - 选择“分组”：系统将根据分组内设备的机型信息，匹配并下发相应动画资源。配置提交后不支持修改适用范围。 |
动画 ZIP 包上传 | 是 | 按照 KC 提供的模板规范上传动画资源包。 - 若为“机型”规则，仅需上传 1 份资源包； - 若为“分组”规则，需根据组内设备所包含机型分别上传资源包，每项均为必填。资源文件必须符合命名规则和尺寸规范，否则无法提交。 |
下发规则说明
开机动画资源的下发与设备在线状态和类型密切相关，系统采用以下逻辑自动处理：
KMA 设备
在线状态：配置立即下发并生效；
离线状态：配置将在设备上线后自动补发。
IMA 设备
在线状态：配置立即下发；
离线状态：配置指令存在有效期，若在有效期内设备未上线，指令将失效。
GMA 设备
不支持开机动画配置。
配置生效行为
动画规则发布成功后，符合条件的设备将在下次重启时自动展示配置的开机动画；
若设备端原有动画规则存在，系统将用新规则直接覆盖原动画资源；
执行“删除”操作后，设备将恢复为出厂默认开机动画；
若规则处于“未发布”状态，则不会进行下发，设备也不会应用动画资源。