在 K12 教育类 App 中，“英语跟读评测”几乎是口语板块的标配功能。看似简单的“录音‑打分‑展示”流程。却隐藏着一系列技术痛点：音频焦点管理、第三方 SDK 异步回调、句子级到单词级细粒度可视化反馈，还有本地评分持久化。下面以真实生产环境实现为例，拆解从 UI 布局到 Room 数据库落库的全链路方案。

一、功能全景与架构设计

评测模块由四个主要文件协作完成：

• item_evaluation.xml – DataBinding 布局，定义评测卡片
• EvaluationAdapter.kt – RecyclerView Adapter。处理 item 状态、点击事件、文字着色
• EvaluateViewModel.kt – 业务调度中心，管理 SDK、音频播放、数据库读写
• EvaluateListFragment.kt – UI 容器，负责权限申请、生命周期绑定、数据初始化

痛点提示：在 MVVM + Repository架构下LiveData 的状态切换容易出现 UI 与业务不一致的情况，需要仔细处理观察者与 ViewModel 的耦合。

1.1 ViewModel 层职责

• readList。isEvaluating,mPos
• 负责评测 SDK 调度、音频播放控制和 Room 数据同步。
• 使用 coroutine 保证异步逻辑安全。

1.2 Fragment 与 Adapter 的协作模式

• Fragment → LiveData 观察 → UI 刷新 / 权限申请。
• Adapter → 接口回调 → Fragment 调用 ViewModel 方法。话说回来，
• 避免 Adapter 操作业务逻辑。可减少错误率，

二、列表层：DataBinding 实现可交互评测卡片

a) 主要交互点

1. 选中态高亮： 根标签支持 DataBinding；通过@{bean.select}
2. 星级评分： 根据@{score}
3. 操作按钮： 包含播放原音/点击测评/我的录音。

android:background="@{bean.select?@color/col_F6F6F6:@color/white}" android:visibility="@{bean.select?View.VISIBLE:View.GONE}"

b) Adapter 内部状态防御

•  isEvaluating : 禁止所有音频操作；确保评测中不产生冲突，

Coding Snippet

kotlin class EvaluationAdapter( 从data来看。MutableList,) : BaseQuickAdapter(R.layout.item_evaluation,data ) { private var defSel = -1 private var evaluatingListener: OnEvaluatingListener?= null private var onPlayOriginalListener: OnPlayOriginalListener?= null private var onPlayMySoundListener: OnPlayMySoundListener?= null

// 是否正在评测中
private var isEvaluating = false
// 首次选中是否需要自动播放原音
private var needPlay = true
// 是否已授权录音权限
private var hasRecordPermission = false
@RequiresApi
override fun convert(holder:
BaseDataBindingHolder。item:
ReadTextBean,) {
holder.dataBinding?.let { bind ->
bind.bean = item
/* 可见性 & 高亮 */
bind.rlRead.visibility =
if ) View.GONE else View.VISIBLE
bind.llRating.visibility =
if View.VISIBLE else View.GONE
/* 星级图标设置 */
when {
in listOf -> setStars
in listOf -> setStars
in listOf -> setStars
else -> setStars
}
/* 我的录音可见性 */
bind.llWdly.visibility =
if View.VISIBLE else View.GONE
/* 单词着色逻辑 */
val sp = buildWordSpannable
bind.tvReadText.text = sp?: item.text.orEmpty
/* 操作按钮点击 */
bind.llBfyy.setOnClickListener { playOriginal }
bind.llWdly.setOnClickListener { playMyRecording }
bind.llDjcp.setOnClickListener { startStopRecording }
/* 首次选中自动播放原音 */
if {
bind.llBfyy.performClick
needPlay = false
}
}
}

/* …省略其他辅助方法实现，*/ }

- 本段代码演示了如何在 Adapter 层隔离业务逻辑，并通过回调向 Fragment 通知使用者交互。-

Troubleshooting 常见坑点: