Lila项目NVUI时钟播报问题分析与优化方案

问题背景

在Lila项目的非视觉用户界面(NVUI)中，存在一个关于时钟播报的交互问题。当用户在盲模式下通过键盘快捷键't'查询对局时间时，系统会以"05:00"的格式播报时间，这导致屏幕阅读器将其误读为"5点钟"，而非预期的"5分钟0秒"。

问题复现场景

该问题在以下三种常见场景中均会出现：

1. 实时对局过程中（如5+0闪电战）
2. 进行棋局分析时
3. 进行信件对局时

技术分析

问题的根源在于时间显示格式的设计没有充分考虑屏幕阅读器的语义解析特性。当前实现直接将时间格式化为"HH:MM"的样式，这种格式：

1. 在视觉上符合传统时钟显示习惯
2. 但缺乏对辅助技术的语义支持
3. 导致TTS引擎无法正确解析时间单位

解决方案

经过社区讨论，确定采用以下优化方案：

1. 时间播报格式重构

   • 将"05:00"改为自然语言表述"5分钟0秒"
   • 增加时间单位说明，避免歧义

2. 播报顺序优化

   • 根据用户视角自动调整播报顺序
   • 白方视角：先播报白方时间，再黑方
   • 黑方视角：先播报黑方时间，再白方

3. 单位播报优化

   • 对超过1小时的长时对局，保留秒数播报
   • 添加明确的时间单位说明（分钟/秒）

实现细节

在技术实现层面需要注意：

1. 区分不同场景的时间播报：

   • 对局中：显示双方剩余时间
   • 分析模式：显示当前步时

2. 考虑国际化支持：

   • 时间单位的翻译处理
   • 不同语言的数字读法适配

3. 辅助技术兼容性：

   • 确保ARIA标签正确设置
   • 测试主流屏幕阅读器的解析效果

用户体验提升

该优化将带来以下用户体验改进：

1. 时间信息传达更准确
2. 减少TTS引擎的误读情况
3. 保持不同场景下的一致性
4. 支持用户视角切换功能

总结

通过对Lila项目NVUI时钟播报机制的优化，不仅解决了当前的时间误读问题，还为视障棋手提供了更友好的交互体验。这种基于语义化设计的改进思路，也值得在其他辅助功能开发中借鉴应用。