在 Android 音视频通话项目中。开发者经常会遇到以下痛点：

• 相机兼容性差，前后置切换、方向旋转经常出现画面倒置或花屏。
• YUV 数据格式不统一，导致编码器报错或画面异常。
• 弱网环境下码率无法自适应，通话卡顿甚至掉线。怎么说呢，
• 音视频编码与推流的资源释放不当。容易产生崩溃或内存泄漏，
• 多访客场景下音视频同步困难，调试成本高。其实，

下面对 CameraRecorder2 这一主要调度类进行重新排版。方便你定位并解决上述问题。

一、CameraRecorder2 是干嘛的？

CameraRecorder2 是音视频通话、视频对讲、教育硬件还有 IoT 视频通话的总调度管理器负责：

• 打开并管理 Camera1 相机采集。
• 处理预览数据的 YUV 旋转 / 格式转换。
• 将处理后的数据送入 H.264 视频编码器 与 AAC 音频编码器.
• 实时将编码后的音视频帧通过 Tencent IoT SDK 推流。
• 支持动态码率自适应、多访客、本地录制调试.

二、主要成员变量一览

// 相机参数
private var mCameraId = 前置摄像头ID
private var mVideoWidth / mVideoHeight = 预览分辨率
private var mCamera: Camera?= null // Camera1 硬件相机
// 编码器
private var mVideoEncoder: BaseVideoEncoder?= null // H.264 编码器
private var mAudioEncoder: BaseAudioEncoder?= null // AAC 编码器
// 通话状态
private var isMuted = false // 静音标识
private var mIsRecording = false // 是否正在编码推流
// 多访客管理
private var mVisitorInfo: Map // 支持多人同时观看
// 分辨率类型 & 调试开关
private var videoResType = ...
private var isSaveRecord = false // 是否保存 H264/AAC 到本地

三、整体流程概览

1. openCamera → 初始化 Camera1，设置预览尺寸、帧率、对焦及方向。
2. onPreviewFrame → 接收原始 YUV 数据。
3. YUV 旋转 / 格式转换 → 统一为编码器所需的 NV12/NV21，并纠正设备方向。按理说，
4. encoderH264 → 将处理后的视频帧送入 H.264 编码器。
5. startAudioEncoder → 启动麦克风采集并进行 AAC 编码。话说回来，
6.  → 编码完成回调。将帧交给发送层，
7. sendAvtVideoData / sendAvtAudioData → 通过 Tencent IoT SDK 实时推流。怎么说呢，

四、模块细节代码解析

4.1 打开相机：openCamera

Pain point： 不同设备对预览尺寸和帧率的支持差异大。需要针对性配置，否则会出现预览卡顿或黑屏。

mCamera = Camera.open
val params = mCamera!，.parameters.apply {
setPreviewSize
previewFormat = ImageFormat.NV21 // 常用格式，也可改为 YV12
setPreviewFpsRange // 15~30fps 区间
focusMode = Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE
}
mCamera!，.setDisplayOrientation)
mCamera!，.setPreviewCallback // 本类实现 Camera.PreviewCallback
mCamera!，.startPreview

4.2 开始录制推流：startRecording

Pain point： 如果在 P2P 链接未完全建立前就开始推流，会导致首帧丢失或网络异常。 不过，这里采用延迟启动方式保证链路就绪。

fun startRecording {
Handler).postDelayed({
startVideoEncoder
startAudioEncoder
mIsRecording = true
},700) // 延迟 700ms。确保信令握手完成
}

4.3 视频编码启动：startVideoEncoder

Pain point： 不同渠道需要不同分辨率/码率配置，否则在低端设备上会出现 OOM 或卡顿。

val encodeParam = VideoEncodeParam.apply {
width = if 640 else mVideoWidth
height = if 480 else mVideoHeight
frameRate = mVideoFrameRate // 动态可调节
bitRate = getAverageBitRate // 基准码率
iFrameInterval = 2 // 每两秒一个 I 帧
}
mVideoEncoder = VideoEncoderFactory.create
mVideoEncoder?.start

Pain point： 回声消除和噪声抑制若未开启，在嘈杂环境下通话质量极差。

mAudioEncoder = BaseAudioEncoder.apply {
enableAEC
enableNS
enableAGC
}
mAudioEncoder?.startAudio

4.5 相机预览回调：

This method is **入口** of all video data.

override fun onPreviewFrame {
if return
// 1️⃣ YUV 格式统一 → NV12
val nv12Data = if {
yv12ToNv12
} else {
data.clone // 已是 NV21/NV12，无需转换
}
// 2️⃣ 根据当前设备方向进行旋转
val rotatedData = when {
90 -> rotateNV12_90
180 -> rotateNV12_180
270 -> rotateNV12_270
else -> nv12Data
}
// 3️⃣ 推送至 H264 编码器
mVideoEncoder?.encoderH264
}

4.6 YUV 格式转换与旋转

YV12 → NV12 转换函数

private fun yv12ToNv12: ByteArray {
val frameSize = width * height
val uvSize = frameSize / 4
val nv12 = ByteArray
// Copy Y plane directly
System.arraycopy
// V plane → UV interleaved start at frameSize
for {
nv12 = yv12 // V → U position?nv12 = yv12 // U → V position?}
return nv12
}

常用 NV12/YV12 的旋转实现

• rotateNV12_90
• rotateNV12_180
• rotateNV32_270

4.7 编码完成回调 & 推送数据

音频回调

override fun onAudioEncoded {
VideoNativeInterface.sendAvtAudioData
}

视频回调

`

override fun onVideoEncoded(
datas的观点是，ByteArray,pts: Long,seq: Long。isKeyFrame: Boolean) {
VideoNativeInterface.sendAvtVideoData
}

The callbacks ensure that **H264 frames + AAC frames** are handed over to Tencent IoT SDK in real‑time.

4.8 动态码率自适应

If you ignore network fluctuation and keep a fixed bitrate in poor networks you will quickly experience packet loss and video freeze.

class AdapterBitRateTask : Runnable {
private val intervalMs = 2000L
override fun run {
val netSpeedKbps = NetworkMonitor.getCurrentUploadSpeed
val bufferLevel = VideoNativeInterface.getSendBufferLevel
when {
bufferLevel> HIGH_WATERMARK || netSpeedKbps  decreaseBitrate
bufferLevel  GOOD_SPEED -> increaseBitrate
}
Handler).postDelayed
}
private fun decreaseBitrate {
val newRate = max
val newFps = max
mVideoEncoder?.setVideoBitRate
mVideoEncoder?.setVideoFrameRate
}
private fun increaseBitrate {
val newRate = min
val newFps = min
mVideoEncoder?.setVideoBitRate
mVideoEncoder?怎么说呢，.setVideoFrameRate
}
}

4.9 安全释放资源：关闭相机 & 停止编码

If you release resources out of order you will encounter “camera already released” or “encoder null pointer” crashes.

fun closeCamera {
isReleasing = true
try {
mCamera?.setPreviewCallback
mCamera?.stopPreview
mCamera?.release
} catch { Log.e }
try {
mVideoEncoder?.release
mAudioEncoder?.stopAudio
mAudioEncoder?.release
} catch { Log.e }
resetState
}
private fun resetState {
isReleasing = false
mIsRecording = false
isMuted = false
}

五、主要亮点一览

#️⃣ 痛点对应功能点	Description

* Camera1 全机型兼容*Kodlama sadece Android’in eski API seviyelerinde çalışan cihazları hedefler;dolayısıyla düşük donanımlı eğitim硬件de bile çalışır.

* YV12/NV21 自动转换*Sistemin farklı cihazlarda ürettiği farklı YUV formatlarını tek bir hedef formata dönüştürerek kodlayıcı uyumsuzluklarını ortadan kaldırır.

* 多方向 YUV旋转*Kamera ön/arka konum ve cihaz dönüşlerine göre otomatik dönüşüm sağlanır;怎么说呢，UI’da görüntü ters ya da yan dönmez.

* 音视频分离编码。可独立控制*AEC/NS/AGC gibi ses işleme ayrı katmanda yürütülürken video kodlayıcı bağımsız ayarlarla optimize edilir.

* 多访客同步支持*Müşteri tarafı birden çok izleyicinin aynı akışı almasını sağlayan VisitorInfo yapısı ile senkronizasyon sorunu çözülür.

* 动态码率自适应*Zayıf ağ koşullarında otomatik bitrate düşürülerek paket kaybı ve takılma engellenir;ağ iyileştiğinde tekrar yükseltilir.

* 安全释放机制*Kaynakları doğru sırada serbest bırakarak “camera already released” ve “encoder null” crash’lerini önler.

* 渠道差异化配置* Örneğin zgll cihazı için sabit çözünürlük ve fps ayarıyla uyumluluk sağlanır.

* 本地录制调试* İlgili flag’i açarak H264/AAC dosyaları kaydedilir;sorun anında loglamaya ve yeniden oynatmaya imkan verir.

* 腾讯 IoT SDK 对接* Kod sadece SDK arayüzüne veri gönderir;ek bir RTP/RTMP katmanı yazmaya gerek kalmaz.

---