new RtmpCamera2推流黑屏如何排查？

Question

在使用 `new RtmpCamera2` 进行推流时，出现**黑屏问题**是较为常见的技术难题。排查时应从以下几个方面入手：首先确认摄像头权限是否正常获取，其次检查预览画面是否正常显示，若预览正常但推流黑屏，需查看编码器是否正常启动，以及视频数据是否成功写入推流通道。同时，注意检查 RTMP 推流地址是否有效，网络连接是否稳定。此外，部分机型存在兼容性问题，建议测试不同设备以定位是否为硬件适配问题。最后，可查看日志中是否有异常抛出或错误码，辅助定位问题根源。

Answer 1

使用 new RtmpCamera2 推流黑屏问题深度排查指南

1. 权限与设备访问检查

在 Android 平台中，摄像头权限是推流功能的前提。若未正确申请运行时权限（CAMERA、RECORD_AUDIO），将导致摄像头无法初始化，进而引发黑屏。

• 确保在 AndroidManifest.xml 中声明权限：

• <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-feature android:name="android.hardware.camera" />

• 动态请求权限（API 23+）：

• ActivityCompat.requestPermissions(this, 
      new String[]{Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO}, 
      REQUEST_CODE_PERMISSIONS);

• 权限拒绝后，RtmpCamera2 初始化会失败，预览和推流均无画面。

2. 预览画面状态验证

预览是否正常是判断问题层级的关键指标。若预览黑屏，则问题出在摄像头采集层；若预览正常但推流黑屏，则问题可能在编码或传输层。

现象	可能原因	排查方法
预览黑屏	权限未获取、摄像头被占用、SurfaceView 未正确绑定	检查日志中是否有 CameraOpenException
预览正常，推流黑屏	编码器未启动、数据未写入推流通道	查看编码线程状态及回调日志

3. 编码器与数据流路径分析

即使预览正常，若 H.264 编码器未成功初始化或视频帧未送入编码管道，推流端仍为黑屏。常见于参数配置错误或硬件编码资源冲突。

1. 确认 RtmpCamera2 的编码配置是否合理：

2. rtmpCamera.setVideoQuality(VideoQuality.HIGH_SPEED_540P);

3. 检查是否调用 prepareAudioForPublish() 和 prepareVideoForPublish()；
4. 通过日志观察是否输出类似 startEncoder: Video encoding started 的提示；
5. 若使用自定义 SurfaceTexture，需确保帧数据被正确捕获并传入编码器。

4. 推流地址与网络环境验证

无效的 RTMP 地址或网络中断会导致连接失败，表现为“黑屏”或“无信号”。

• 使用标准格式地址：rtmp://live.example.com/app/streamKey；
• 通过 ping 或 telnet 测试服务器连通性；
• 监听连接状态回调：

• rtmpCamera.setRtmpListener(new RtmpListener() {
      @Override
      public void onConnectionSuccessRtmp() {
          Log.d("Rtmp", "Connected");
      }
  
      @Override
      public void onConnectionFailedRtmp(String reason) {
          Log.e("Rtmp", "Failed: " + reason);
      }
  });

5. 硬件兼容性与机型适配

部分低端或定制 ROM 设备存在摄像头驱动缺陷，导致纹理映射异常或编码失败。

建议建立测试矩阵：

品牌	型号	Android 版本	是否复现
Xiaomi	Redmi Note 10	12	否
HUAWEI	Honor 9X	10	是
Samsung	Galaxy S21	13	否
Oppo	Find X3	11	是

6. 日志分析与错误码定位

启用详细日志输出，关注关键节点：

adb logcat | grep -i "rtmp\|camera\|encoder"

典型错误码包括：

• E/ACodec: Error 0xffffffed：编码器创建失败；
• IOException: Broken pipe：网络断开；
• CameraNotConnectedException：摄像头打开失败；
• onAuthError：RTMP 鉴权失败。

7. 流程图：黑屏问题诊断路径

graph TD
            A[开始] --> B{权限已授权?}
            B -- 否 --> C[请求权限]
            B -- 是 --> D{预览是否正常?}
            D -- 否 --> E[检查摄像头初始化]
            D -- 是 --> F{推流是否黑屏?}
            F -- 是 --> G[检查编码器启动状态]
            G --> H{编码日志正常?}
            H -- 否 --> I[调整编码参数或降级分辨率]
            H -- 是 --> J[检查RTMP地址与网络]
            J --> K{连接成功?}
            K -- 否 --> L[更换服务器或检测防火墙]
            K -- 是 --> M[查看服务端流是否存在]
            M --> N[结束诊断]