辅助功能声明
Be Native 致力于为每一位 Apple 开发者打造包容的学习环境。我们使用原生 SwiftUI 辅助功能 API 构建 iPhone、iPad 和 Mac 上的体验,在每个发布周期都进行审查,并在 App Store 产品页面上发布 Apple 的辅助功能营养标签,让您在下载前即可查看支持情况。如果您发现任何障碍,请通过 info@benative.dev 与我们联系,以便我们尽快处理。
我们在 App Store 上的声明
Apple 的辅助功能营养标签会逐项说明一款 App 实际支持哪些功能。我们的标签已针对 iPhone 和 iPad 发布;Mac 版标签已提交,将在 Mac 版 App 通过审核后显示。我们的声明如下:
- 在 iPhone、iPad 和 Mac 上支持:旁白、语音控制、深色界面、不单靠颜色进行区分、充足对比度、减弱动态效果和字幕。
- 在 iPhone 和 iPad 上支持:更大字体。macOS 没有与之对应的动态字体功能,因此 Mac 版 App 不声明此功能。
- 在任何平台上均不支持:口述影像。
iPhone 上的辅助功能支持
Be Native 的 iOS 版 App 直接集成了 iPhone 上提供的以下辅助技术:
旁白
旁白会朗读屏幕上的元素,并提供转子导航。我们通过 SwiftUI 的 .accessibilityLabel、.accessibilityHint 和 .accessibilityActions 提供描述性标签、提示和自定义操作。课程进度和播放控件等动态内容会实时播报更新,并遵循旁白的焦点规则。
语音控制
所有交互组件均使用 Apple 的原生控件,因此能自动接收语音控制指令。按钮、开关和导航链接可响应内置指令短语,并在必要时支持自定义标签覆盖。
更大字体
界面通过 SwiftUI 的文本样式采用动态字体。正文、标题和交互标签会根据用户偏好的内容大小类别平滑缩放,确保各类教学内容的可读性。
深色界面
Be Native 支持浅色和深色模式,配色方案基于 SwiftUI 的语义化颜色。对比度在两种外观下均经过测试,图标和插图等素材也会随当前主题自动适配。
不单靠颜色进行区分
完成、选中或警告等状态除颜色外,还会使用图标、下划线或文字标签等冗余提示。SwiftUI 的辅助功能特征会传达状态变化,让色盲用户也能获得清晰的反馈。
充足对比度
文本和关键界面元素在所有支持的背景下均保持 WCAG 2.1 AA 对比度标准。我们在设计交付阶段使用 Apple 的 Accessibility Inspector 及自动化对比度工具验证配色方案。
减弱动态效果
当系统的“减弱动态效果”偏好设置开启时,我们会将过渡效果替换为交叉淡化、移除视差效果,并禁用非必要的动画,同时保留必要的交互反馈。
字幕
课程视频配有通过 AVFoundation 渲染的隐藏式字幕。字幕与时间轴同步,并遵循用户偏好的字幕样式。
iPad 上的辅助功能支持
iPadOS 上的体验与 iPhone 的功能集保持一致,并增加了多栏布局和键盘快捷键。上述所有辅助功能在 iPad 上均完全支持:
- 旁白:针对分屏布局进行了增强,并明确规定了转子的排序方式。
- 语音控制:支持工具栏和上下文菜单的命名规范。
- 更大字体:在展开布局中,文字排版会随动态字体一同缩放。
- 深色界面:在多窗口环境中保持对比度和素材色调。
- 不单靠颜色进行区分:在更大的屏幕上会显示补充图形符号,以强化含义。
- 充足对比度:已在显示器缩放和外接显示器场景下完成验证。
- 减弱动态效果:表格和集合视图的刷新会遵循用户的动态效果设置。
- 字幕:在多任务处理和画中画播放期间,字幕依然清晰可读。
Mac 上的辅助功能支持
Mac 版 App 是专为 macOS 从零开始打造,而非由 iPad 版改造而来,它在真正的多窗口工作空间中支持该平台自身的辅助技术:
- 旁白:窗口、边栏和工具栏均提供描述性标签和可预测的朗读顺序。每个窗口都可独立导航,因此课程、其源代码和您的笔记可以分别单独阅读。
- 语音控制:基于原生 AppKit 和 SwiftUI 控件构建,因此语音指令和数字浮层无需特殊处理即可正常工作。
- 全键盘控制:所有交互元素均可通过键盘访问,具有可见的焦点指示,并支持标准的 macOS 快捷键。
- 深色界面:浅色和深色外观均基于语义化颜色构建,并在两种外观及多窗口场景下完成验证。
- 不单靠颜色进行区分:完成、选中和警告状态均通过图形符号和文字加以强化,而不仅仅依靠颜色。
- 充足对比度:文本和关键界面元素均达到 WCAG 2.1 AA 标准,并已使用 Accessibility Inspector 及外接显示器完成检查。
- 减弱动态效果:系统偏好设置开启时,窗口和列表的过渡效果会变为交叉淡化。
- 字幕:课程视频配有与时间轴同步的隐藏式字幕,转录文本也会显示在播放器旁边。
关于 Mac 上的“更大字体”。macOS 并不像 iOS 和 iPadOS 那样提供动态字体功能,因此 Mac 版 App 不声明该功能。Mac 上的文字大小遵循系统和显示器设置,设置发生变化时,布局会重新排布而不是被裁切。
我们的辅助功能审查
Be Native 在每个发布周期都会进行覆盖 iPhone、iPad 和 Mac 的内部辅助功能审查。审查内容包括导航流程、屏幕阅读器兼容性、对比度、动态效果敏感性以及媒体替代方案。发现的问题会在更新发布前跟踪至解决,回归测试套件确保此前已修复的问题不会再次出现。
持续改进
辅助功能是我们持续的承诺。如果您在任何平台上使用 Be Native 时遇到问题、有功能建议,或需要帮助,请发送邮件至 info@benative.dev。我们会及时查看您的消息,并与您协力打造无障碍的使用体验。
