## Android 音视频采集先看现象

很多团队以为自己缺的是更多代码，实际更缺的是把 Android 音视频采集 这条链路拆成可观察节点，否则每次都像在盲调。音视频链路最坑的点在于预览正常并不能说明录制结果正常，真正的偏差常常在编码参数和时间戳上。如果现场只盯相机日志，不同步看编码 metrics 和回放结果，问题会一直在链路之间来回甩锅。

## Android 音视频采集先这样修

采集、编码、封装、回放四段都补统一 trace id，再按机型能力分桶看异常样本。优先把方向、采样率、分辨率这些最容易漂移的配置做成日志快照，回归时直接比对。和最近已经发过的 Android 音视频采集 相关文章相比，这里刻意把重点往观测补点、回滚抓手和验收口偏，不再重复旧稿里的通用铺垫。

## Android 音视频采集示例代码

为了和最近围绕 Android 音视频采集 的文章拉开距离，这里的示例改成‘观测点 + 回滚位 + 最小修复’三段式，不再沿用旧稿的讲法。下面这组片段按 Android 音视频采集 的真实处理顺序展开：先贴核心实现，再给排查命令，最后补一段修复辅助代码。

1. 先贴核心代码

val recorder = MediaRecorder().apply {
    setAudioSource(MediaRecorder.AudioSource.MIC)
    setVideoSource(MediaRecorder.VideoSource.SURFACE)
    setOutputFormat(MediaRecorder.OutputFormat.MPEG_4)
    setVideoEncoder(MediaRecorder.VideoEncoder.H264)
    setAudioEncoder(MediaRecorder.AudioEncoder.AAC)
}

2. 排查命令

ffprobe -hide_banner sample.mp4
adb shell dumpsys media.camera

3. 状态校验辅助代码

data class DuomeitijishuCheckResult(
    val key: String,
    val ok: Boolean,
    val detail: String
)

fun verifyDuomeitijishuState(key: String, expected: String, actual: String): DuomeitijishuCheckResult {
    val ok = expected == actual
    return DuomeitijishuCheckResult(key, ok, if (ok) "matched" else "$expected != $actual")
}

## Android 音视频采集常见坑

如果最近同分类已经连续覆盖过 音频采样率与服务端约定不匹配，这次就别再把篇幅浪费在重复背景上，直接补那些旧稿没展开的失败信号和止血顺序。选题避重不是只换标题。真正要避开的是和最近文章一模一样的观察路径、代码顺序和总结句式，所以这里把关注点故意拆开。先盯三类高危点：相机预览方向和编码方向不一致；音频采样率与服务端约定不匹配；回放端只测主流机型忽略低端设备。多数时候不是接口挂了，而是边界松了。

## 报错怎么处理

1. 状态回退

如果现场出现旧数据覆盖新数据、页面恢复后状态倒退，先用 CameraX 日志 对齐时间线，再核对本地状态迁移是不是原子提交。把请求发出、回包落库、UI 消费三段时间顺序排清楚，根因通常会自己浮出来。

ffprobe -hide_banner sample.mp4
adb shell dumpsys media.camera

2. 调度层重入

如果后台恢复、重试或多入口并发后任务跑了两次，优先补幂等键、唯一调度名和入口锁，再回头核对 分机型记录编码能力白名单 有没有被真正收紧。别只看业务日志，还要确认调度层是不是只进了一次。

fun duomeitijishuWorkName(id: String): String {
    return "duomeitijishu-$id"
}

fun shouldSkipDuomeitijishu(running: Boolean, hasPending: Boolean): Boolean {
    return running || hasPending
}

## 命令和代码直接跑

真正有价值的最小样例，必须保留最短入口、最少依赖和明确输出，这样复现、修复、回归三步才能连起来。只要先稳定复现一次，再把修复版稳定跑通一次，文章就不是经验笔记，而是可执行模板。如果你前几天刚发过 Android 音视频采集 相关文章，这个最小样例就更应该承担差异化职责：验证新的失败信号，而不是把老步骤重抄一遍。

1. 最小状态模型

data class DuomeitijishuState(
    val id: String,
    val status: String,
    val updatedAt: Long,
    val source: String
)

2. 最小执行入口

fun runDuomeitijishuDemo() {
    val state = DuomeitijishuState("42", "pending", System.currentTimeMillis(), "duomeitijishu")
    println(state)
}

3. 回归命令

ffprobe -hide_banner sample.mp4
adb shell dumpsys media.camera
adb logcat -d | findstr /I "Exception timeout retry"