一、推荐开源项目
1. rtmp-rtsp-stream-client-java
- 特点:
- 纯 Java 实现 RTMP/RTSP 协议,无需 JNI 开发
- 支持摄像头采集、屏幕录制、音频推流
- 集成 MediaCodec 硬编码(H.264/AAC)
- GitHub:https://github.com/pedroSG94/rtmp-rtsp-stream-client-java
- 实现复杂度:⭐(简单)
2. RtmpPublishKit
- 特点:
- 轻量级 SDK,Java 重写 RTMP 协议栈
- 使用 Android MediaCodec 硬编码
- 支持 YUV 数据处理(集成 LibYUV)
- 参考文档:Android端RTMP推流实现- RtmpPublishKit - 简书
- 实现复杂度:⭐⭐(中等)
3. EasyRTMP
- 特点:
- 企业级稳定推流 SDK
- 支持断线重连、智能丢帧、环形缓冲
- 跨平台(Android/iOS/Windows/Linux)
- 官网:EasyDSS互联网视频云服务
- 实现复杂度:⭐(简单)
二、超简实现示例(以 rtmp-rtsp-stream-client-java 为例)
1. 添加依赖
gradle
// build.gradle
implementation 'com.github.pedroSG94.rtmp-rtsp-stream-client-java:rtplibrary:2.2.5'
2. 布局文件
xml
<!-- activity_main.xml -->
<com.pedro.rtplibrary.rtmp.RtmpCamera2
android:id="@+id/rtmpCamera"
android:layout_width="match_parent"
android:layout_height="match_parent" />
3. 核心代码
java
public class MainActivity extends AppCompatActivity {
private RtmpCamera2 rtmpCamera;
private String rtmpUrl = "rtmp://your-server-ip/live/stream_key";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
rtmpCamera = findViewById(R.id.rtmpCamera);
// 检查摄像头和麦克风权限
if (PermissionChecker.checkPermissions(this)) {
startStream();
}
}
private void startStream() {
// 配置摄像头参数(分辨率、帧率等)
rtmpCamera.prepareVideo(1280, 720, 30);
rtmpCamera.prepareAudio();
// 设置推流地址
rtmpCamera.startStream(rtmpUrl);
}
@Override
protected void onDestroy() {
super.onDestroy();
if (rtmpCamera.isStreaming()) {
rtmpCamera.stopStream();
}
}
}
三、关键流程说明
- 权限申请:需动态申请
CAMERA
、RECORD_AUDIO
、INTERNET
权限。 - 编码配置:
- 视频:H.264 硬编码(默认)
- 音频:AAC 硬编码(默认)
- 服务器端:
- 使用 Nginx RTMP 或 SRS 搭建推流服务器
- 推流地址示例:
rtmp://server_ip:1935/live/stream_key
四、常见问题
1. 纯音频推流时间戳同步问题
- 现象:网页播放几秒后卡顿
- 解决:在代码中手动维护音频时间轴(参考 EasyRTMP 的修复方案)。
2. 花屏或延迟高
- 调优方向:
- 降低视频分辨率(如 720p → 480p)
- 减少关键帧间隔(
rtmpCamera.setVideoBitrate(2000 * 1024)
) - 启用硬件加速(默认开启)
五、扩展建议
- 进阶功能:
- 美颜滤镜:集成 GPUImage
- 混音:使用 OpenSL ES 处理音频流
- 协议扩展:支持 WebRTC 低延迟推流
- 调试工具:
- 推流测试:VLC 或 OBS 验证流地址
- 网络分析:Wireshark 抓包 RTMP 协议
以上方案可帮助开发者在 1 小时内完成基础推流功能集成。