【亲测免费】 Android Librtmp客户端技术文档

---

安装指南

为了在您的Android项目中集成此Librtmp客户端，您需要按照以下步骤操作：

1. 打开您的Android Studio项目。
2. 转至build.gradle(Module: app)文件。
3. 在dependencies块中，添加以下依赖项：

   dependencies {
       // 其他依赖...
       implementation 'net.butterflytv.utils:rtmp-client:3.1.0'
   }
   

4. 同步Gradle项目以应用更改。

完成以上步骤后，您的项目就已成功集成了Librtmp客户端，可以开始使用RtmpClient和RtmpMuxer类了。

---

项目使用说明

使用RTMP客户端读取流

1. 初始化客户端并连接到服务器:

   RtmpClient rtmpClient = new RtmpClient();
   rtmpClient.open("your_rtmp_url_live=1", false);
   

2. 使用提供的方法读取或控制流数据，例如:

   byte[] buffer = new byte[1024];
   int bytesRead = rtmpClient.read(buffer, 0, buffer.length);
   

3. 当不再需要时，确保关闭连接以避免内存泄漏:

   rtmpClient.close();
   

发布RTMP流

1. 开启发布模式并指定URL与视频参数（宽高可选）:

   RtmpMuxer rtmpMuxer = new RtmpMuxer();
   rtmpMuxer.open("your_publish_rtmp_url", 1920, 1080);
   

2. 写入视频和音频帧数据:

   // 示例: 假设data是NAL单元或AAC帧数据
   rtmpMuxer.writeVideo(data, 0, data.length, timestamp);
   rtmpMuxer.writeAudio(data, 0, data.length, timestamp);
   

3. 完成发布时关闭:

   rtmpMuxer.close();
   

---

项目API使用文档

对于读取流的操作：

• int open(String url, boolean isPublishMode)：建立连接，isPublishMode为false表示读取模式。
• int read(byte[] data, int offset, int size)：从RTMP流读取数据。
• int write(byte[] data)：辅助函数，不用于读流，用于向服务器发送简单数据。
• int seek(int seekTime)：跳转到流中的特定时间点。
• int pause(int pause)：暂停（1为暂停，0为恢复）播放。
• int close()：关闭连接。
• int isConnected()：检查连接状态。

对于发布流的操作：

• int open(String url, int width, int height)：初始化发布模式，提供视频尺寸信息。
• int writeVideo(byte[] data, int offset, int length, int timestamp)：写入视频数据。
• int writeAudio(byte[] data, int offset, int length, int timestamp)：写入音频数据。
• 相同的close()和isConnected()函数也适用于RtmpMuxer。

本地FLV文件操作（可选）：

• void file_open(String filename)：打开本地文件路径用于记录。
• void write_flv_header(boolean is_have_audio, boolean is_have_video)：写入FLV头信息。
• void file_close()：关闭文件操作。

---

通过遵循上述指导，您可以有效地利用此轻量级的Android Librtmp客户端进行直播流读取与发布的操作。记得合理管理资源，尤其是在打开和关闭连接时。