遇到问题¶
遇到问题时,先观察主界面的画面和文字提示,再选择对应的排查方法。
先完成这几个检查¶
- 确认软件已经完整解压,不是在压缩包内运行。
- 确认模型文件已经下载完成。
- 确认摄像头画面连续、清楚,患者面部和双眼完整可见。
- 确认“设置 → 眨眼呼叫 → 开启眨眼呼叫”处于开启状态。
- 确认电脑或蓝牙音箱没有静音。
如果问题仍然存在,请继续查看下面对应的情况。
软件无法打开¶
请依次检查:
- 确认已经将下载的软件压缩包完整解压。
- 进入解压后的文件夹,双击
BlinkCall.exe。 - 不要移动或单独复制
BlinkCall.exe,它需要和文件夹中的其他文件放在一起。 - 重新下载软件压缩包并解压到一个新的文件夹,再次尝试。
仍然无法打开时,请记录 Windows 版本、软件版本和屏幕上的提示,然后通过GitHub Issues反馈。
模型文件下载失败¶
如果页面显示“网络连接超时”“网络连接失败”“请求模型信息失败”或“下载模型文件失败”:
- 确认电脑能够正常访问网络。
- 关闭下载提示后,重新进入“设置 → 眨眼呼叫”。
- 再次点击“下载/更新”。
- 等待整个进度完成,不要在下载过程中关闭软件。
下载成功后,进度窗口会关闭,设置会自动保存。主界面不再显示“未检测到模型文件”的提示。
如果多次尝试仍然失败,请记录页面显示的完整错误文字,并通过GitHub Issues反馈。
摄像头没有画面¶
如果主界面显示“摄像头不可用”:
- 确认摄像头已经正确连接。
- 检查 Windows 是否允许桌面应用访问摄像头。
- 关闭可能正在占用摄像头的会议、直播或拍照软件。
- 打开“设置 → 摄像头”,选择“本地摄像头”。
- 从编号
0开始尝试;没有画面时依次尝试1、2、3。 - 每次修改编号后点击“保存”,回到主界面检查。
如果主界面显示“摄像头连接中断,正在尝试恢复”,请检查连接线并重新插入摄像头,然后等待软件自动恢复。
使用笔记本内置摄像头和外接摄像头时,可以设置备用摄像头。详细说明请查看摄像头设置。
检测不到患者面部或双眼¶
主界面可能显示:
- “未检测到人脸”
- “人脸关键点定位失败”
- “关键点无效,请检查患者姿态或眼部遮挡”
请调整摄像头或患者位置:
- 让患者面向摄像头。
- 确保完整面部和双眼都在画面中,不要靠近画面边缘。
- 移开遮挡双眼的头发、被子、手或眼镜边框。
- 改善面部光线,避免面部过暗或强烈背光。
- 保持患者和摄像头位置稳定,等待画面恢复识别。
眨眼进度不动或反复重新开始¶
请检查:
- “设置 → 眨眼呼叫 → 开启眨眼呼叫”是否为“开启”。
- “显示首页上方进度条”是否为“显示”。
- 患者面部和双眼是否能够被持续识别。
- 每个睁眼或闭眼动作是否保持到当前阶段完成。
- 完成一个阶段后,是否在 3 秒内开始了下一个阶段。
- 当前实际动作是否与“设置 → 眨眼呼叫 → 眨眼序列”一致。
建议先恢复默认设置并测试默认序列。默认序列为:
睁眼 1.5 秒 → 闭眼 1 秒 → 睁眼 1 秒 → 闭眼 1.5 秒
如果患者难以完成当前动作,请查看眨眼动作设置。
完成序列但没有触发呼叫¶
- 确认整个序列都已完成,进度没有在中途清零。
- 确认“开启眨眼呼叫”处于开启状态。
- 确认模型文件没有缺失或损坏;可以在“下载/更新模型文件”处重新检查。
- 点击“保存”后返回主界面,再完成一次测试。
如果主界面显示“推理异常”或“眨眼功能异常”,请先关闭并重新打开软件。问题持续出现时,请记录提示文字并提交问题。
经常在无意中触发呼叫¶
- 不要只使用很短的闭眼动作,以免与自然眨眼混淆。
- 适当延长闭眼持续时间。
- 增加一到两个动作步骤,让完整序列更容易与自然眨眼区分。
- 每次只修改一项,然后连续测试几次。
- 调整时兼顾患者体力,不要把序列设置得过长。
具体设置方法请查看眨眼动作设置。
听不到提醒声音¶
- 打开“设置 → 眨眼呼叫”。
- 确认“播放呼叫音频”为“开启”。
- 选择一个呼叫音频文件并点击“试听”。
- 调高软件中的“音频音量”。
- 检查 Windows 系统音量以及扬声器或蓝牙音箱音量。
- 使用蓝牙音箱时,确认电脑仍然连接到正确的播放设备。
- 保存设置并重新完成一次测试呼叫。
如果“试听”有声音,但触发呼叫后没有声音,请确认呼叫序列是否真的完成,以及呼叫提醒界面是否出现。
设置被改乱¶
进入“设置 → 其他 → 恢复默认设置”,确认恢复后重新完成一次测试呼叫。
恢复默认设置会重置眨眼动作、摄像头、声音和界面等配置,不会删除已经下载的模型文件。
提交问题时请提供¶
通过GitHub Issues反馈时,建议提供:
- 眨眼呼叫版本号。
- Windows 版本。
- 问题发生前执行了哪些操作。
- 预期看到什么,以及实际看到了什么。
- 主界面显示的完整提示文字。
- 能够帮助说明问题的截图。
如果工作人员需要日志或摄像头录制,会进一步说明如何获取。摄像头录制可能包含患者面部和周围环境,请先征得同意,不要在公开问题中直接上传敏感画面。