场景分析
- 使用人群与障碍
- 老年用户，开启“老年模式：超大字体 + 高对比主题（或高对比文本）”
- 常见问题：列表项文案被截断、按钮被遮挡、弹窗尺寸不适配（过小/内容不可见）
- 触发环境与路径
- 异常重现路径：设置 > 显示 > 字体大小（在此路径及其关键操作后最易触发）
- 关键操作：调整字体滑杆、切换高对比主题、返回列表页/弹窗出现时
- 约束与目标
- 需“轻量反馈条”引导，支持“一键上传截图+设备信息”，附加语音输入入口
- 文案清晰易懂，按钮足够大，颜色对比度达标，可与TalkBack/放大镜等辅助功能协作
- 隐私合规：仅收集与显示问题强相关的技术信息；截图先预览，允许遮挡敏感信息
设计方案
1) 组件与版式
-
反馈条（轻量、持久提示）
- 位置：屏幕底部、紧贴内容区上方，避开底部导航；跟随系统/应用边距与手势区安全间距
- 高度：56–64dp（保证≥48dp触控目标），圆角小、对比清晰
- 内容结构：
- 左侧：图标（alert/info），文案两行以内
- 右侧：主按钮“立即反馈”，次要按钮“语音”，关闭“×”
- 状态：进入“设置-显示-字体大小”页面或调节后即出现；同一会话最多出现2次，用户关闭后不再打扰
-
底部浮层（反馈收集）
- 样式：半高Modal BottomSheet，支持滑动展开；标题清晰，按钮堆叠式（纵向）
- 步骤极简：最多3步完成提交
- 功能：
- 问题类型单选（默认勾选“文案被截断/按钮遮挡/弹窗异常/其他”）
- 自动展示截图预览（可重新截取/涂抹遮挡）
- 简短问答选择题（异常排查问答）
- 语音输入（可替代文字描述）
- 提交按钮
2) 触发规则
- 进入或返回以下页面/状态时触发：
- 设置 > 显示 > 字体大小（页面展示后 1.2s，避免抖动）
- 用户调整字体大小/高对比设置后，首次返回任意列表页、弹窗弹出时
- 前提条件（任一满足）：
- fontScale ≥ 1.3（大字及以上）
- 高对比文本/主题开启
- 去重与频控：
- 每次应用冷启动最多提示1次；用户主动关闭或已提交反馈后，本次会话不再弹出
3) 引导文案（对老年友好、明确具体）
- 反馈条主文案（两行内，任选其一）：
- “如果文字看不全、按钮被遮挡，可一键反馈，帮您尽快修复。”
- “遇到文字截断、按钮挡住、弹窗太小？点这里反馈，我们来修。”
- 主按钮：
- 次按钮（带麦克风图标）：
- 关闭：
- 底部浮层标题：
- 问题类型（单选，默认选第1项）：
- “文字被截断”
- “按钮被遮挡”
- “弹窗显示异常”
- “其他”
- 描述输入占位：
- 截图区：
- “已为您截取当前页面。如有隐私，请点‘遮挡敏感信息’。”
- 提交按钮：
- 成功Toast/条幅：
4) 异常排查问答（最多4题，均为单选/是非，便于老年用户）
- Q1 发生位置（自动识别当前页面，允许改选）：
- “就在当前页面”（默认）/“应用的设置页”/“其他页面”
- Q2 是否影响操作：
- Q3 是否每次都会出现：
- Q4 字体/显示设置（勾选自动读取结果，用户确认即可）：
- “字体：特大/超大”
- “高对比：已开启/未开启”
- “显示大小：标准/大/更大”
5) 语音输入入口设计
- 在反馈条和底部浮层内均提供“语音”按钮
- 行为：调用系统语音识别（免学习成本）-> 转文字填入描述框 -> 用户可补充/直接提交
- 失败与无权限：
- 弹出简短提示：“无法使用麦克风，请在系统设置开启‘麦克风’权限。”
6) 字段采集（最小必要原则）
- 基础
- appVersionName/appVersionCode
- activity/fragment 路径
- 当前页面路由或标签（便于定位）
- 时间戳、会话ID（匿名）
- 设备显示与辅助信息（仅技术参数，无个人数据）
- Android版本、厂商、机型
- 屏幕分辨率、density、窗口insets（状态栏/导航栏高度）
- fontScale、displaySize（显示大小）、isHighTextContrastEnabled、boldText/magnification/talkback启用状态
- 深色/浅色模式、主题高对比开关（应用内）
- 布局方向（LTR/RTL）、语言/地区
- UI上下文
- 列表项布局ID、按钮ID、弹窗类型
- 当前弹窗宽高、是否可滚动
- TextView/Compose Text的maxLines/ellipsize（可选）
- 截图
- 仅当前应用界面（不抓取通知/其他应用），本地预览后用户确认上传
- 提供“遮挡敏感区域”工具（矩形涂抹/模糊）
7) 数据上传与失败兜底
- 网络失败：本地暂存（加密）+ 重试；显式提示“已保存，将在网络恢复后发送”
- 用户可取消：立即删除本地暂存
技术实现
以下示例以Jetpack Compose为主，附View系方案点到为止。
1) 反馈条（Compose）
@Composable
fun FeedbackBanner(
visible: Boolean,
onFeedbackClick: () -> Unit,
onVoiceClick: () -> Unit,
onClose: () -> Unit
) {
AnimatedVisibility(visible = visible) {
Surface(
tonalElevation = 3.dp,
color = MaterialTheme.colorScheme.surface,
shadowElevation = 6.dp
) {
Row(
modifier = Modifier
.fillMaxWidth()
.navigationBarsPadding()
.padding(horizontal = 16.dp, vertical = 12.dp),
verticalAlignment = Alignment.CenterVertically
) {
Icon(Icons.Default.Info, contentDescription = null, tint = MaterialTheme.colorScheme.primary)
Spacer(Modifier.width(12.dp))
Text(
text = "如果文字看不全、按钮被遮挡，可一键反馈，帮您尽快修复。",
style = MaterialTheme.typography.bodyLarge, // 遵循大字号
modifier = Modifier.weight(1f)
)
Spacer(Modifier.width(8.dp))
TextButton(onClick = onVoiceClick) {
Icon(Icons.Default.Mic, contentDescription = null)
Spacer(Modifier.width(4.dp))
Text("语音")
}
FilledTonalButton(onClick = onFeedbackClick) {
Text("立即反馈")
}
IconButton(onClick = onClose) {
Icon(Icons.Default.Close, contentDescription = "稍后再说")
}
}
}
}
}
触发条件示意：
val cfg = LocalConfiguration.current
val fontScale = cfg.fontScale
val highContrast = isHighTextContrastEnabled(context) || appHighContrastEnabled()
val shouldShowBanner = remember { mutableStateOf(false) }
LaunchedEffect(fontScale, highContrast) {
shouldShowBanner.value = (fontScale >= 1.3f || highContrast) && notShownInThisSession()
}
高对比检测（示例）：
fun isHighTextContrastEnabled(context: Context): Boolean =
Settings.Secure.getInt(
context.contentResolver,
Settings.Secure.ACCESSIBILITY_HIGH_TEXT_CONTRAST_ENABLED, 0
) == 1
2) 一键截图（仅应用内容，免系统录屏权限）
// build.gradle: implementation "androidx.core:core-ktx:<latest>"
fun captureCurrentScreen(activity: Activity): Bitmap {
val view = activity.window.decorView.rootView
return view.drawToBitmap() // 仅应用窗口内容
}
截图预览与遮挡：使用BottomSheet内简单涂抹工具（Canvas绘制半透明矩形并导出），或采用开源涂抹控件；导出时将遮挡层合成到bitmap后再压缩上传。
3) 反馈底部浮层（Compose）
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun FeedbackSheet(
screenshot: Bitmap,
defaultOptions: FeedbackOptions,
onSubmit: (FeedbackPayload) -> Unit,
onRetake: () -> Unit,
onVoiceClick: () -> Unit
) {
ModalBottomSheet(onDismissRequest = { /* handle */ }) {
Text("请帮我们看看这个显示问题", style = MaterialTheme.typography.titleLarge,
modifier = Modifier.padding(horizontal = 16.dp, vertical = 8.dp))
// 问题类型
val options = listOf("文字被截断", "按钮被遮挡", "弹窗显示异常", "其他")
var selectedIndex by remember { mutableStateOf(0) }
options.forEachIndexed { i, label ->
Row(Modifier.fillMaxWidth().clickable { selectedIndex = i }.padding(16.dp)) {
RadioButton(selected = selectedIndex == i, onClick = { selectedIndex = i })
Spacer(Modifier.width(8.dp)); Text(label, style = MaterialTheme.typography.bodyLarge)
}
}
// 截图预览
Image(
bitmap = screenshot.asImageBitmap(),
contentDescription = "截图预览",
modifier = Modifier
.fillMaxWidth().heightIn(max = 260.dp)
.padding(horizontal = 16.dp)
.clip(RoundedCornerShape(8.dp))
)
Row(Modifier.padding(horizontal = 16.dp, vertical = 8.dp)) {
OutlinedButton(onClick = onRetake) { Text("重新截取") }
Spacer(Modifier.width(8.dp))
OutlinedButton(onClick = { /* 进入遮挡敏感信息工具 */ }) { Text("遮挡敏感信息") }
}
// 异常排查问答（简化）
val q1 = listOf("就在当前页面", "应用的设置页", "其他页面")
var q1Sel by remember { mutableStateOf(0) }
LabeledSingleChoice("问题发生位置", q1, q1Sel) { q1Sel = it }
val q2 = listOf("影响点击/看不清", "不影响，只是不好看")
var q2Sel by remember { mutableStateOf(0) }
LabeledSingleChoice("是否影响操作", q2, q2Sel) { q2Sel = it }
val q3 = listOf("每次都出现", "偶尔出现")
var q3Sel by remember { mutableStateOf(0) }
LabeledSingleChoice("出现频率", q3, q3Sel) { q3Sel = it }
// 描述 + 语音
var desc by remember { mutableStateOf("") }
OutlinedTextField(
value = desc, onValueChange = { desc = it },
placeholder = { Text("请简单说说哪里看不清/被挡住（可语音）") },
modifier = Modifier
.fillMaxWidth().padding(16.dp),
minLines = 2, maxLines = 4
)
TextButton(
onClick = onVoiceClick,
modifier = Modifier.padding(horizontal = 16.dp)
) {
Icon(Icons.Default.Mic, contentDescription = null); Spacer(Modifier.width(4.dp)); Text("语音")
}
// 提交
Button(
onClick = {
onSubmit(
FeedbackPayload(
type = options[selectedIndex],
desc = desc,
q1 = q1[q1Sel], q2 = q2[q2Sel], q3 = q3[q3Sel],
// 其他自动采集字段在onSubmit中封装
)
)
},
modifier = Modifier
.fillMaxWidth()
.padding(16.dp)
.heightIn(min = 48.dp)
) {
Text("发送问题")
}
Spacer(Modifier.height(12.dp))
}
}
辅助控件：
@Composable
fun LabeledSingleChoice(label: String, items: List<String>, selected: Int, onSelect: (Int) -> Unit) {
Text(label, style = MaterialTheme.typography.titleMedium, modifier = Modifier.padding(horizontal = 16.dp, vertical = 8.dp))
items.forEachIndexed { i, txt ->
Row(Modifier.fillMaxWidth().clickable { onSelect(i) }.padding(horizontal = 16.dp, vertical = 8.dp)) {
RadioButton(selected = selected == i, onClick = { onSelect(i) })
Spacer(Modifier.width(8.dp)); Text(txt, style = MaterialTheme.typography.bodyLarge)
}
}
}
4) 语音输入（系统识别，无需常驻权限UI）
fun startVoiceInput(activity: Activity, requestCode: Int = 1001) {
val intent = Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH).apply {
putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, RecognizerIntent.LANGUAGE_MODEL_FREE_FORM)
putExtra(RecognizerIntent.EXTRA_PROMPT, "请说出问题位置或现象，例如“设置页文字被截断”")
}
try {
activity.startActivityForResult(intent, requestCode)
} catch (e: ActivityNotFoundException) {
Toast.makeText(activity, "当前设备不支持语音输入", Toast.LENGTH_SHORT).show()
}
}
// onActivityResult中接收结果，填入描述框
如需更自然地长语音，可使用SpeechRecognizer并申请RECORD_AUDIO权限；优先使用系统识别对话框以降低心智负担。
AndroidManifest（仅在自建识别需要时）：
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
5) 数据打包与上传
数据结构（示例）：
{
"type": "文字被截断",
"desc": "设置-显示-字体大小页面，列表第2项看不全",
"qa": {
"where": "就在当前页面",
"impact": "影响点击/看不清",
"frequency": "每次都出现"
},
"app": {"versionName": "3.2.1", "versionCode": 30201},
"device": {
"brand": "Xiaomi", "model": "M2012K11AC", "android": "14",
"density": 3.0, "widthPx": 1080, "heightPx": 2400,
"fontScale": 1.6, "displaySize": "large",
"highTextContrast": true, "boldText": false,
"talkback": false, "nightMode": "light", "rtl": false, "locale": "zh-CN"
},
"ui": {"route": "Settings/Display/FontSize", "dialog": {"visible": false}},
"screenshotId": "upload://abc123"
}
上传流程：
- 截图文件先上传，返回ID，再发送表单JSON引用ID；失败则队列重试（WorkManager）
6) View体系快速集成要点
- 反馈条可用Material Snackbar替代，但建议自定义“持久信息条”（避免Snackbar超时消失、字号较小问题）
- 截图：rootView.drawToBitmap()
- BottomSheet：BottomSheetDialogFragment + RecyclerView（选项）+ ImageView（截图）+ 自定义涂抹View
- 无障碍：为按钮、图片设置contentDescription；对反馈条设置android:accessibilityLiveRegion="polite"
注意事项
- 可用性与无障碍
- 文案短、具体，避免术语；按钮≥48dp；点击目标间隔≥8dp
- 颜色对比≥WCAG AA（文本对背景对比≥4.5:1），高对比主题下再加粗
- TalkBack顺序：文案 -> 语音 -> 立即反馈 -> 关闭；反馈条设置liveRegion=polite避免打断读屏
- 隐私与合规
- 截图仅限应用内容；先预览、默认不上传；必须经用户确认
- 提供“遮挡敏感信息”；不采集联系人、位置信息、输入内容等PII
- 允许用户撤回/删除本地暂存
- 性能与稳定
- 截图/涂抹在后台线程压缩（PNG/JPEG/WebP），限制最大分辨率/文件大小
- 频控与防打扰；出现时机避开关键交互（如输入中）
- 兼容性
- 字体缩放测试门槛：fontScale 1.0/1.3/1.6/2.0；深色/高对比/RTL
- 老机型上BottomSheet动画卡顿时，允许无动画降级
- 文案与本地化
- 保持与品牌调性一致；简体中文为主，保留繁中与英文资源
- 监控与度量
- 埋点：反馈条曝光、点击率（立即反馈/语音/关闭）、提交完成率、失败率；用于后续优化
优先修复建议（针对问题根因，按修复价值排序）
-
文案截断
- 禁用单行/强制省略：多处Text设置maxLines≥2, ellipsize尽量避免
- 启用文本自适应：TextView使用android:autoSizeTextType="uniform"；Compose中确保softWrap=true
- 使用ConstraintLayout/Box，保留弹性空间；避免固定宽度/权重不当
-
按钮遮挡
- 去除固定高度容器，改为wrapContent+padding，保证父容器可纵向滚动
- 底部按钮区在小屏与大字体下允许自动“纵向堆叠”
- 处理系统insets：WindowInsets.navigationBars.asPaddingValues()，避免被手势条/底部栏遮挡
-
弹窗尺寸异常
- Dialog宽度：min(560dp, 屏宽的0.9)，内容区可滚动（NestedScrollView/ModalBottomSheet）
- 按钮从右到下自动换行；标题与内容允许多行
- 避免在Dialog内嵌固定高度RecyclerView；改为wrapContent+maxHeight约束
-
主题与对比
- 高对比主题下提升文本/主按钮对比度与fontWeight
- 使用Material 3动态色的对比保护（contentColorFor + local contentAlpha）
-
预防性检测与测试
- 在调试构建中启用“文本截断检测”日志：判断TextView.layout?.getEllipsisCount(line) > 0上报埋点（采样）
- 回归测试覆盖fontScale 1.3/1.6/2.0；截图测试（Paparazzi/Compose Preview/宏基准）
- 列表项避免左右双按钮并排；使用单主按钮+溢出菜单替代
此方案遵循Android/Material Design规范，面向老年用户提供清晰、低门槛的反馈体验；在不额外增加用户负担的前提下，最大化收集定位所需信息，便于快速复现与修复。
