1. 功能与应用目标
模块功能定位：
副屏广告模块用于将预设的视频或图片素材通过规则分配至终端设备的副屏进行播放，用于门店宣传、品牌展示、促销引导等场景。该模块支持设置广告播放优先级与智能切换机制，确保副屏在业务空闲期间能充分发挥广告价值。
本模块适用于 KMA 和 IMA 类型设备，通过 KiwiCloud 控制台配置播放规则与素材资源。
副屏广告的具体播放行为（如是否投放、广告音量、素材预览、播放顺序设置等）由设备上的 “副屏广告”应用 App 控制，用户可通过设备端 App 进行操作。
⚠️ 配置副屏广告规则前，请确保目标设备已安装并启用“副屏广告”App，否则下发配置将无法生效。
主要操作：
新增副屏广告：配置设备分组、播放策略、上传广告素材；
启用/停用 广告规则。
次要操作：
查看副屏广告规则详情；
编辑已有规则配置；
删除不再使用的副屏广告规则。
典型应用场景：
零售门店在顾客结账时播放品牌广告，提高商品曝光率；
餐饮收银设备副屏用于播放新品促销视频，提升转化；
多门店统一配置副屏广告，规范视觉呈现，提升品牌一致性。
2. 主要操作
2.1 新增副屏广告
操作说明
“新增副屏广告”功能用于为设备分组配置一组广告素材并指定播放策略，从而实现副屏内容的展示。支持上传图片或视频素材，并设置素材播放优先级或智能切换规则。
该功能仅适用于 KMA 与 IMA 类型设备，若设备分组中包含 GMA 设备，则系统会自动忽略该类设备。
每个设备分组 仅可配置一条副屏广告规则，若需更改内容，可通过“编辑”或“删除”功能重新配置。
广告配置需设备在线才能立即下发：
KMA 设备：若设备离线，系统将在其上线后自动下发规则，并始终保留最新配置；
IMA 设备：配置指令具有有效期，超过有效期未下发的将自动失效；
若规则配置有误或素材需更新，可通过“编辑”功能调整后重新保存。
操作流程
进入创建页面
点击副屏广告页面右上角【新增副屏广告】按钮，进入广告配置弹窗。
填写广告基本信息
设备分组（必填）：选择一个需配置广告的设备分组（仅支持一个）；
广告名称（必填）：自定义该广告规则的名称，便于识别和管理。
配置播放规则
播放模式：
广告优先：广告素材强制占用副屏显示；
智能切换：副屏空闲时播放广告，有业务显示时自动隐藏广告；
实际播放行为由设备端“副屏广告”App 决定。
上传广告资源
点击【+】上传图片或视频素材，支持 JPG/JPEG/PNG（≤5MB）或 MP4 视频（≤100MB）；
建议分辨率：
15.6吋副屏：1920×1080；
10.1吋副屏：1280×800；
最多支持上传 10 个素材，支持拖拽调整播放顺序。
设置状态
切换【状态】开关为开启状态，表示该广告配置启用，系统将在保存后立即向设备下发配置指令；
若状态设置为“停用”，则表示该广告规则被保存但暂不生效，配置指令不会下发至设备，直到后续手动启用为止。
保存配置
点击【确定】，完成副屏广告创建并触发下发。
注意事项
仅支持为 KMA、IMA 设备配置副屏广告，GMA 设备不支持该功能；
同一设备分组仅能配置一条副屏广告规则，重复配置将提示覆盖；
若设备不在线，则配置将按设备类型规则处理（KMA自动补发，IMA超时失效）；
素材上传建议压缩优化，确保终端播放流畅；
广告播放效果依赖设备端“副屏广告”App 设置，如是否投放、音量控制等。
2.2 启用 / 停用
操作说明
“启用 / 停用广告规则”功能用于控制已创建广告规则在目标设备上的实际生效状态。可通过切换规则列表中的状态开关来启用或停用规则，切换后系统将根据当前状态执行对应的配置指令下发或清除。
启用规则：系统将广告配置指令下发至目标设备，设备将根据规则播放广告内容；
停用规则：设备将删除已下发的广告资源，副屏广告功能被关闭，广告内容不再展示。
操作流程
进入【配置管理 - 副屏广告】页面；
找到目标规则，在“状态”一栏切换开关；
出现确认弹窗，点击【确定】后即执行启用 / 停用操作；
系统自动完成规则的下发或清除操作。
注意事项
启用规则后，会根据规则内容立即下发配置指令至设备；
停用规则后，设备上的广告资源将被清除，副屏广告不再展示；
若设备当前离线，KMA 型设备将在上线后自动接收指令并执行；
IMA 型设备有指令有效期，超时后将不再执行该配置；
若设备分组中包含 GMA 型设备，将自动忽略，不进行下发；
状态切换操作不可撤回，建议在确认配置无误后再进行启用。
3. 次要操作
3.1 详情
操作说明
“副屏广告详情”功能用于查看当前广告规则的完整配置内容，包括设备分组、播放状态、播放规则及广告素材等信息。该页面为只读视图，不支持编辑或操作，仅用于信息核查和管理。
操作流程
进入【配置管理 - 副屏广告】页面；
点击目标广告规则右侧的【详情】按钮；
在弹窗中查看以下内容：
规则名称；
设备分组名称；
当前状态（启用 / 停用）；
播放规则（广告优先 / 智能切换）；
素材资源：展示当前上传的图片或视频广告资源内容。
注意事项
当前页面为只读，仅用于查看，不支持在此页面内进行修改；
素材资源会以缩略图形式展示，便于快速识别和确认内容；
若需调整广告内容，可通过“修改”功能进行编辑；
所展示素材为当前配置中所绑定的资源，最多展示 10 项。
3.2 修改
操作说明
“修改”功能允许对已创建的副屏广告规则进行编辑和更新。用户可根据业务需求调整广告名称、播放规则或素材内容，但设备分组不可修改，其余字段均可编辑。
修改保存后，系统将根据新的配置下发更新指令，设备端将替换原有的广告资源与设置。
操作流程
进入【配置管理 - 副屏广告】页面；
在目标广告规则右侧点击【操作】>【修改】，弹出编辑窗口；
在编辑窗口中完成以下调整：
修改规则名称；
更改播放规则（广告优先 / 智能切换）；
新增、删除或替换广告素材（支持图片 / 视频）；
启用 / 停用状态设置。
点击【确定】，保存并提交更改。
注意事项
设备分组不可修改，若需调整绑定设备，请删除原规则后重新创建；
所有素材资源仍需遵循格式与大小限制；
保存后系统将按以下逻辑处理配置指令：
KMA 设备：如设备不在线，将在上线后自动接收并应用最新配置；
IMA 设备：配置指令具有缓存有效期，超时后将自动失效；
GMA 设备：将被系统自动忽略，不参与配置下发；
若状态设置为“停用”，则规则仅保存为配置记录，不会下发至设备端。
3.3 删除
操作说明
“删除”功能用于彻底移除已创建的副屏广告规则。
当规则被删除后，设备端的“副屏广告”应用将同步清除对应的广告资源和配置信息，确保广告内容不再展示。
操作流程
进入【配置管理 - 副屏广告】页面；
找到目标广告规则，在操作栏点击【操作】>【删除】；
系统弹出确认弹窗，点击【确定】完成删除操作。
注意事项
删除操作不可撤销，请谨慎执行；
删除后，系统将立即向绑定的设备下发删除指令；
KMA 设备：设备在线时立即执行删除；离线设备将在上线后接收指令；
IMA 设备：删除指令存在缓存有效期，超时将不再执行；
GMA 设备：无广告下发行为，不受影响；
若设备未安装“副屏广告”应用，则不会执行任何广告操作。
4. 配置项说明
副屏广告模块的配置项主要包括广告规则的基本信息、播放控制参数以及广告素材资源等字段，以下是各配置项的详细说明：
配置项名称 | 是否必填 | 配置项说明 |
副屏广告名称 | 是 | 用于标识当前副屏广告规则，建议命名清晰，方便后期管理与识别。 |
设备分组 | 是 | 选择一个需要应用广告规则的设备分组。仅支持选择一个设备分组，并且配置完成后不可更改。每个分组最多只能配置一条广告规则。 |
播放模式 | 是 | 控制广告素材在副屏的展示方式： - 广告优先：广告内容强制显示于副屏，覆盖业务界面； - 智能切换：广告内容在副屏空闲时播放，有业务展示时自动隐藏广告。具体播放机制由设备端“副屏广告”App 控制。 |
素材资源 | 是 | 上传的图片或视频文件，将用于副屏展示广告内容： - 支持格式：JPG / JPEG / PNG（≤5MB），MP4（≤100MB）； - 上传数量：最多支持上传 10 个素材，支持拖拽排序； - 建议分辨率：15.6吋副屏建议 1920×1080，10.1吋建议 1280×800； - 素材一经提交下发，将直接替换设备端已存在的广告资源。 |
状态 | 是 | 控制当前广告规则是否立即生效： - 启用：规则保存后立即下发至设备，设备副屏广告开始展示； - 停用：规则保存但不下发配置，广告内容不生效。状态后续可手动切换。 |
下发规则说明
副屏广告配置下发机制依赖设备类型，系统行为如下：
KMA 设备：若设备在线，配置立即下发；若设备离线，系统将缓存最新配置，待设备上线后自动补发。
IMA 设备：配置指令存在有效期，设备必须在有效期内上线接收配置，否则下发任务将过期失效。
GMA 设备：不支持副屏广告功能，系统自动跳过下发。
配置生效行为
启用状态的广告规则将立即通过系统向设备下发，设备副屏广告 App 依据接收到的配置展示广告内容；
修改配置后将覆盖原有素材并重置播放顺序；
若执行“停用”或“删除”操作，设备端将自动移除相关广告素材与配置内容，副屏恢复为空闲状态。