# LibRtmp-Client-for-Android

**Repository Path**: hbzhzw/LibRtmp-Client-for-Android

## Basic Information

- **Project Name**: LibRtmp-Client-for-Android
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-06-25
- **Last Updated**: 2025-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Librtmp Client for Android
It is probably the smallest(~60KB) rtmp client for android. It calls librtmp functions over JNI interface.
With all cpu architectures(arm, arm7, arm8, x86, x86-64, mips) its size is getting about 300KB

It compiles librtmp library without ssl. 

In version 0.2, it supports FLV muxing and sending stream via RTMP. FLV muxing is based on this repo https://github.com/rainfly123/flvmuxer


##### To read streams, you can call below functions of **RtmpClient** from Java #####

For live streams add **" live=1"** at the end of the url when calling the **_open_** function

* *public native int open(String url, boolean isPublishMode);*
* *public native int read(byte[] data, int offset, int size);*
* *public native int write(byte[] data);*
* *public native int seek(int seekTime);*
* *public native int pause(int pause);*
* *public native int close();*
* *public native int isConnected();*: Call this function to query the connection status. Returns 1 if connected, returns 0 if not connected

Don't forget calling the **_close_** function after you are done. If you don't, there will be memory leakage


##### To publish streams, you can call below functions of **RtmpMuxer** from Java #####
* *public native int open(String url, int width, int height);* : First, call this function with the url you plan to publish. Width and height are the width and height of the video. These two parameters are not mandatory. They are optional. They put width and height values into the metadata tag.
* *public native int writeVideo(byte[] data, int offset, int length, int timestamp);*: Write h264 nal units with this function
* *public native int writeAudio(byte[] data, int offset, int length, int timestamp);*: Write aac frames with this function
* *public native int close();*: Call this function to close the publishing.
* *public native int isConnected();*: Call this function to query the connection status. Returns 1 if connected, returns 0 if not connected

To save flv file locally as well, you can use below functions
* *public native void file_open(String filename);* : call this function with full file path
* *public native void write_flv_header(boolean is_have_audio, boolean is_have_video);*: After opening file call this function
* *public native void file_close();*: Call this function to close the file. 

if any local file is opened, library will write the audio and video frames to local file as well. 

## Install ##

- Add dependency to your build gradle
```sh
dependencies {
    ...
    compile 'net.butterflytv.utils:rtmp-client:3.1.0'
    ...
}
```

- That's all. You can use RtmpClient class


<br/>

[Ant Media](http://antmedia.io)