冰云键操作手册

文档类型	用户使用教程与产品功能说明
适用版本	基于当前 icyliveX Android 应用功能
更新日期	2026-07-10
官网	https://icylivex.cn

阅读建议普通用户先看“首次使用流程”和“权限中心”；日常功能重点看“冰云键、控件池、小窗、随心记”；遇到异常时直接查“常见问题与排障”。

1. 产品定位与功能总览

icyliveX 是面向 Android 手机的悬浮交互工具。它通过底部冰云键提供通知预览、系统控制、小窗启动、语音随心记、最近任务和第三方 SDK 面板管理等入口；通过权限中心补齐系统授权；通过控件池决定悬浮面板中实际显示哪些页面。

主界面与核心入口示意

模块	主要作用	用户什么时候进入
冰云键	底部悬浮栏、瞬时通知、小窗、随心记、外观和横屏行为。	开启或调整日常悬浮交互时。
权限中心	集中申请悬浮窗、通知监听、麦克风、使用情况访问、电池优化、自启动等授权。	首次安装、换机、后台被杀或某个能力没有反应时。
冰云控件池	管理音乐、音量、设备、最近任务、空白面板、随心记、SDK 管理和第三方面板。	想决定面板显示内容、顺序、开关状态或自定义面板时。
个人中心	账号、会员、日志上传、公告、版本检查和官网跳转。	检查会员状态、更新版本、处理公告和日志时。

一句话理解冰云键负责“随时呼出”，控件池负责“呼出后显示什么”，权限中心负责“系统是否允许它工作”。

2. 首次使用流程

2.1 启动、海报与登录

应用打开时会先显示白色加载页，左侧为 icyliveX 图标，右侧为应用名称。首次进入且没有有效登录态时，会先展示海报页；完成海报浏览后进入登录、注册或重置密码页面。日常打开时如果已有有效会话，会直接进入主界面。

步骤	操作
1	安装 APK 后打开 icyliveX，等待加载页结束。
2	首次使用先浏览海报页，最后一页点击“登录”。
3	在账号验证页选择登录、注册或重置密码，并同意服务条款。
4	登录后等待会员校验，通过后进入主界面。
5	进入主界面后，优先进入权限中心补齐关键权限。

账号验证页示意

2.2 账号、会员与版本

功能	入口	说明
登录/注册	账号验证页	邮箱和密码登录；注册需要显示名称；忘记密码可通过验证码重置。
会员校验	登录后自动进行	会员有效进入主界面；未通过时停留在会员流程。
个人中心	主界面左上角头像	查看账号、会员、日志上传状态、版本公告和版本检查。
版本检查	个人中心或权限中心	显示当前版本与最新版本；发现新版本时询问是否前往 icylivex.cn。
公告处理	版本公告弹窗	已选择忽略本版本公告后，日常打开不再反复弹出该版本公告。

3. 权限中心与后台保护

权限中心只负责申请或跳转系统授权，不会替代 Android 的标准权限模型。悬浮显示仍使用标准悬浮窗权限；厂商自启动只是允许应用在被系统关闭后更容易重新拉起。

权限中心教学示意

权限/开关	影响功能	建议
开机自动启动	允许 icyliveX 在开机或系统允许的重启场景中恢复服务。	需要冰云键长期可用时开启。
厂商自启动权限	打开小米、荣耀、vivo、OPPO、华为、魅族等系统管家的自启动管理页。	跳转后还需要在系统界面手动允许 icyliveX 自启动。
在最近任务中隐藏	尝试把 icyliveX 自身任务卡从最近任务中排除。	想减少最近任务占位时开启；不同 ROM 效果可能不同。
通知权限	前台保护通知、随心记录音通知和部分系统提示。	Android 13 及以上建议开启。
悬浮窗权限	底部冰云键、瞬时通知、控件池和小窗选择环。	必开；未开启时悬浮入口无法显示。
通知监听权限	读取通知并生成瞬时通知、通知面板内容。	需要通知预览时必开。
最近任务读取权限	读取最近使用应用列表。	使用最近任务面板前开启。
麦克风权限	冰云随心记语音识别。	使用随心记前开启。
电池优化白名单	降低后台服务被系统回收概率。	强烈建议开启。
应用列表读取	应用筛选、小窗应用选择、快捷应用列表。	需要小窗或应用过滤时开启。

后台保护边界正常运行时，冰云键、通知监听和控件池按原有逻辑工作；保活策略主要用于应用被系统杀掉、手动重新启动或系统允许恢复时重新拉起冰云键。前台通知保护会保留，通知内容显示为“欲寄彩笺兼尺素，山长水阔知何处”。

4. 冰云键与底部悬浮栏

冰云键是 icyliveX 的主入口。它通常显示为屏幕底部的冰云条，用户可以点按、上滑、长按或从面板空白区下滑来完成不同操作。

底部冰云条与常用手势

设置项	作用	使用说明
启用冰云键	显示或隐藏底部悬浮栏。	关闭后悬浮入口、通知预览和控件池都不会显示。
启用瞬时弹窗	新通知到来时显示短时预览卡片。	可配合应用过滤，只让指定应用显示弹窗。
冰云随心记	长按冰云键进入语音记录。	需要麦克风权限；记录可在随心记面板或设置页管理。
冰云小窗	长按冰云键后选择常用 App 小窗打开。	最多选择 5 个应用；系统不支持时会回退普通打开。
带壳模式	为带手机壳或误触场景调整冰云键触摸位置。	开启后可用横条把冰云键位置和触摸位置上移 0-25 像素。
横屏屏蔽冰云瞬时通知	横屏时不弹出瞬时通知。	通知仍会收纳到通知面板，只是不在横屏中打断画面。
仅指定应用显示消息通知	只展示勾选应用的通知弹窗。	适合只保留微信、QQ、日历等重要提醒。
冰云键外观设置	配置卡片样式、透明度、容器样式、动画、导航条颜色。	老设备建议优先选择简洁动画。

4.1 常用手势

手势	触发位置	结果
点按	底部冰云条	打开或收起冰云面板；随心记录音中可结束保存。
上滑	底部冰云条	展开冰云控件池。
左右滑	面板内容区	切换音乐、音量、设备、最近任务等页面。
长按	底部冰云条	进入冰云小窗选择；无小窗或继续按住可进入随心记。
空白区下滑	控件池外框内、面板边界外的上下左右空白区域	关闭控件池；面板内部下滑不会关闭。

5. 通知弹窗与通知面板

启用瞬时弹窗后，系统通知会以底部预览卡片显示；打开冰云面板后，通知会进入通知面板统一查看。横屏屏蔽瞬时通知只影响“弹出来”的动作，不影响通知被收纳。

冰云通知与控件面板示意

场景	推荐配置	结果
日常办公	启用瞬时弹窗 + 仅指定应用过滤。	只显示通信、日历、工作类重要通知。
游戏/视频横屏	开启横屏屏蔽冰云瞬时通知。	横屏不弹预览卡，但通知仍在面板中可查看。
只想用系统控制	关闭瞬时弹窗，保留冰云键与控件池。	不显示消息预览，只保留音乐、音量等控制能力。
通知太多	缩小应用过滤列表。	降低打扰，同时保留重要应用提醒。

排查顺序收不到通知时，先检查通知监听权限，再检查“启用瞬时弹窗”和应用过滤列表；最后确认目标 App 在系统通知设置里允许发通知。

6. 冰云控件池

冰云控件池决定冰云面板里有哪些页面，以及这些页面的顺序。当前默认内置音乐、音量、设备面板、最近任务、冰云SDK管理和空白面板；随心记和第三方面板会根据开关或扫描状态动态加入。

冰云控件池操作示意

操作	方法	结果
启用/停用	切换卡片右侧开关。	停用后该页不会出现在实际冰云面板中。
排序	长按控件卡片本体，浮起后上下拖动。	下次打开控件池按新顺序展示。
编辑	点击卡片的编辑入口。	进入音乐样式、设备面板、空白面板等配置。
删除	仅自定义空白面板提供删除。	删除该自定义页和对应配置。
新增空白面板	点击新增空白面板。	创建可配置快捷应用、小组件或设备信息的页面。

下滑关闭规则只有控件池外框以内、内层面板边界以外的空白区域下滑才会关闭控件池。内层面板区域本身的下滑、滑杆、列表滚动、按钮点击都不应触发关闭。上下左右四边空白区都属于关闭触发区。

7. 内置控件页说明

控件页	能做什么	使用前提/注意
音乐	播放/暂停、上一首、下一首、媒体音量、封面/歌词/波形展示；点击正在播放软件按小窗逻辑打开。	先让音乐 App 播放一次，系统才有媒体会话。
音量	调整媒体、通知、铃声等系统音量。	滑杆变化会直接影响系统音量。
设备面板	展示设备名称、型号、系统版本、Android、处理器、内存、设备图等。	可自动读取，也可在编辑页手动补充图片和文案。
最近任务	显示最近使用 App，支持普通打开和小窗打开。	需要最近任务读取权限；当前按最近 12 小时、最多 8 个任务展示。
空白面板	配置快捷应用、桌面小组件或自定义设备页。	快捷应用最多 12 个；小组件取决于系统 AppWidget 支持。
冰云随心记	查看记录、复制文字、删除记录。	需要先启用随心记并产生记录。
第三方面板	显示第三方 App 注册的按钮、开关、滑杆、分段按钮等控件。	真实控制结果由第三方 App 自己处理。
冰云SDK管理	按列表实时开关每个 SDK 功能是否加入 icyliveX SDK 互联窗。	没有扫描到 SDK 面板时卡片为灰色且不进入实际控件池，但开关仍可预先操作。

SDK 管理面板边界冰云SDK管理只管理 icyliveX 内部的 SDK 互联窗开关，不直接修改第三方软件本体，也不会强行控制第三方 App 的服务状态。

8. 冰云小窗

冰云小窗用于快速把常用 App 以厂商小窗、自由窗口或系统可用方式打开。用户只需要选择应用并通过长按冰云键唤起；系统会自动按当前手机 ROM 选择启动方案。

冰云小窗长按选择示意

8.1 配置

步骤	操作
1	进入“冰云键”，打开“冰云小窗”。
2	点击“选择冰云小窗应用”。
3	从应用列表中勾选 1-5 个常用 App。
4	返回主界面，长按底部冰云条测试选择环是否出现。

8.2 选择方式

方式	操作	说明
倾斜选择	手指持续按在冰云键上，左右倾斜手机。	打开时的手机角度作为水平基准；超过阈值后默认从中间图标高亮，每次切换有约 0.5 秒延迟，便于精准选择。
触摸选择	长按后手指从冰云键移动到目标 App 图标上。	使用触摸选择时会暂停陀螺仪倾斜选择，避免两套逻辑互相抢焦点。
随心记转入	小窗环出现后不倾斜、不移到图标，继续按住约 2 秒。	如果已开启随心记，会转入语音记录。
松手启动	目标图标高亮后松手。	优先尝试小窗打开；失败时回退普通打开。

8.3 横屏适配

横屏状态下，倾斜方向以手机长边方向作为水平轴，左右倾斜对应左右切换选择；小窗启动边界会按横屏尺寸重新计算，避免直接套用竖屏比例。

8.4 启动优先级

手机系统	优先策略	失败后的处理
小米/红米/POCO、努比亚/ZTE/红魔、三星、魅族	沿用已验证的可用小窗路径。	必要时降级 Android 默认自由窗口或普通打开。
OPPO/一加/realme	优先厂商小窗参数和 winMode/windowMode/oplus.windowMode=2 等适配。	失败后降级 Android 默认，再普通打开。
vivo/iQOO、荣耀、华为及未知系统	先尝试厂商或 Android 默认自由窗口能力。	系统不允许时普通全屏打开。

9. 冰云随心记

冰云随心记用于快速语音记录灵感、待办和短文本。它使用本地 Sherpa ONNX 中文流式识别资源，不依赖把语音上传到服务器完成识别。

冰云随心记录音流程示意

场景	操作	结果
未启用小窗或未配置应用	长按底部冰云条。	直接进入随心记录音。
已启用小窗	长按出现小窗环后保持不倾斜、不移到图标，继续按住约 2 秒。	转入随心记录音。
录音中	松手或点按冰云条。	结束识别，有有效文字时自动保存。
查看记录	冰云键设置页点击“查看随心记”，或在控件池进入随心记页。	可编辑、复制或删除。

记录按时间倒序保存，最多保留 200 条。
说话时靠近麦克风，语速放慢，句子之间留短暂停顿。
如果提示模型缺失或识别启动失败，需要检查 APK 资源和设备运行环境。
长时间后台使用前，建议开启麦克风权限、电池优化白名单和前台通知保护。

10. 第三方 SDK 面板与冰云SDK管理

第三方 App 可以通过 icyliveX SDK 注册控制面板，或通过 Manifest 声明发现服务。icyliveX 扫描到后，会在控件池中展示第三方面板卡片，并允许用户决定是否加入实际冰云面板。

状态	界面表现	用户动作
未扫描到 SDK 面板	冰云SDK管理在控件池中呈灰色，不进入实际控件池。	可以先打开开关；后续扫描到面板后自动按开关状态显示。
已扫描到 SDK 功能	冰云SDK管理显示已扫描数量，面板内逐条列出 SDK 功能。	用右侧开关实时控制该 SDK 功能是否加入 icyliveX SDK 互联窗。
第三方面板已启用	控件池中出现对应第三方面板，标题为面板具体名称，简介为面板来源。	打开冰云面板，左右滑到该面板使用。
控制无反应	按钮/开关状态可能无法更新。	检查第三方 App 是否登录、联网、在线或被系统后台限制。

用户侧原则 icyliveX 只提供面板承载、开关和交互转发；第三方面板里的真实设备控制、网络请求和业务状态由第三方 App 负责。

11. 外观、动画与版本公告

冰云键外观设置示意

配置项	可选项/能力	建议
通知卡片样式	扁平卡片、液态玻璃、溢彩琉璃。	重视清晰度选扁平；重视视觉效果选玻璃或琉璃。
通知容器样式	列表式、堆叠式。	通知多选列表式；追求卡片层次选堆叠式。
面板动画	经典、粒子、回弹、扭转、折叠。	老设备或低功耗场景建议经典。
导航条颜色	玻璃、灵动、琉璃、自定义。	自定义颜色支持 #RRGGBB 或 #AARRGGBB。
音乐波形	频谱柱、虹光波、像素阵等。	按音乐面板视觉偏好选择。
版本公告	启动时展示最新公告，可忽略当前版本公告。	忽略后同版本不再打扰；新版本会重新提示。
版本更新	显示当前版本与最新版本。	发现新版本时确认是否前往官网 icylivex.cn。

12. 推荐日常使用流程

12.1 第一次安装后的 10 分钟

步骤	操作
1	完成海报浏览、登录或注册，并确认会员校验通过。
2	进入权限中心，打开悬浮窗、通知监听、通知权限、最近任务读取、麦克风和电池优化白名单。
3	在系统管家里允许厂商自启动；需要时开启“在最近任务中隐藏”。
4	进入冰云键，启用冰云键和瞬时弹窗；需要横屏安静时开启横屏屏蔽瞬时通知。
5	配置冰云小窗，选择 1-5 个常用 App。
6	进入冰云控件池，调整音乐、音量、设备面板、最近任务、SDK 管理、空白面板顺序。
7	如果需要语音记录，开启随心记并测试一次长按录音。

12.2 日常使用

想做的事	最快操作
查看系统控制	点按或上滑底部冰云条。
切歌或调音量	打开控件池，左右滑到音乐或音量页。
打开常用 App 小窗	长按冰云键，倾斜或触摸选择目标图标后松手。
记录一句话	长按冰云键；若先出现小窗环，继续按住约 2 秒转入随心记。
收起控件池	在控件池外框与内层面板边界之间的空白区向下滑。
横屏不被通知打断	开启“横屏屏蔽冰云瞬时通知”。

13. 常见问题与排障

问题	优先检查	处理建议
底部冰云键不显示	启用冰云键、悬浮窗权限、通知监听权限、账号会员状态。	回到主界面等待数秒；必要时重启 App；确认系统没有关闭悬浮窗。
被杀后台后重新打开仍不显示	电池优化白名单、厂商自启动权限、前台保护通知。	在系统管家允许自启动和后台运行；重新打开后等待覆盖层恢复。
开关失效	权限中心状态、悬浮窗和通知监听。	先补齐权限，再关闭/开启冰云键总开关。
横屏仍弹通知	是否开启“横屏屏蔽冰云瞬时通知”。	开启后只屏蔽瞬时弹出，通知仍在面板收纳。
小窗打开成全屏	目标 ROM 是否允许第三方小窗、目标 App 是否禁止自由窗口。	开启开发者选项里的自由窗口/强制可调整大小；仍失败时属于系统限制。
倾斜选择不灵敏	手指是否持续按在冰云键热区、是否已经转入触摸选择。	手指按住冰云键时再倾斜；如果手指移向图标，会进入触摸选择并暂停陀螺仪。
面板内下滑误关闭	触发位置是否在内层面板外空白区。	在按钮、列表、滑杆、面板内容内下滑不应关闭；只在四边空白区下滑关闭。
最近任务为空	最近任务读取权限、是否刚使用过其他 App。	打开几个 App 后再查看；部分 ROM 需要在系统管家额外允许使用情况访问。
音乐控制没反应	系统媒体会话是否存在。	先打开音乐 App 播放一次；不同音乐 App 对歌词、喜欢等扩展支持不同。
随心记不保存	麦克风权限、识别资源、是否说出有效内容。	说话清晰并等待最终识别；空内容不会保存。
第三方面板不出现	第三方 App 是否支持 icyliveX SDK、是否已扫描到。	打开第三方 App 完成登录/设备连接，回到 SDK 管理刷新。
版本提示混淆	个人中心版本信息。	界面会同时显示当前版本和最新版本；新版本通过官网更新。

14. 术语速查

术语	含义
冰云键	屏幕底部的 icyliveX 悬浮入口。
瞬时通知	新通知到来时短暂出现的预览卡片。
通知面板	打开冰云面板后用于收纳和查看通知的区域。
冰云控件池	音乐、音量、设备、最近任务等悬浮控件页的集合。
内层面板	控件池中实际承载按钮、列表、滑杆和内容的圆角矩形区域。
空白区下滑	控件池外框内、内层面板外的四边空白区域向下滑，用于关闭控件池。
冰云小窗	通过冰云键选择常用 App 并尝试以小窗/自由窗口打开。
冰云SDK管理	管理第三方 SDK 功能是否加入 icyliveX SDK 互联窗的列表式面板。
厂商自启动权限	系统管家中允许应用被关闭后在合适场景恢复运行的权限入口。

文档维护说明本说明书面向普通用户描述当前产品能力。若后续 ROM 适配、SDK 接入或控件池交互继续变化，应同步更新“冰云小窗”“权限中心”“SDK 管理”和“常见问题”章节。