Skip to content

Latest commit

 

History

History
56 lines (38 loc) · 2.61 KB

README.md

File metadata and controls

56 lines (38 loc) · 2.61 KB

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
dependencies {
    ...
    compile 'net.butterflytv.utils:rtmp-client:3.1.0'
    ...
}
  • That's all. You can use RtmpClient class

Ant Media