Skip to content

Latest commit

 

History

History
159 lines (115 loc) · 3.61 KB

README_en.md

File metadata and controls

159 lines (115 loc) · 3.61 KB

RTMPX

RTMPX is an android rtmp streaming library. It uses camerax for acquisition and supports 60fps. The encoding uses mediacodec hard coding, and the streaming uses librtmp.

30fps.mp4
60fps.mp4

Features

  • 60-frame preview and streaming (theoretically support higher, as long as the phone supports it, the current pixel2 is set to 240fps, but it has no effect)
  • Streaming while recording (save to local)

Known issues

  • Some models have insufficient performance when pushing 60fps in the vertical screen, which causes libyuv rotation to take a long time (for example, pixel2, I frame rotation takes 12ms), resulting in failure to reach 60fps
  • Waiting for you to find out

To be optimized

  • add notes
  • support filters
  • optimization of vertical screen libyuv rotation

How to use(Refer to sample app)

1. Depend

1) Download aar (this way of integrating aar files, the camerax library is a must)
  def camerax_version = "1.0.0"
// CameraX core library using camera2 implementation
    implementation "androidx.camera:camera-camera2:$camerax_version"
// CameraX Lifecycle Library
    implementation "androidx.camera:camera-lifecycle:$camerax_version"
// CameraX View class
    implementation "androidx.camera:camera-view:1.0.0-alpha24"

or

2) mavenCentral()
implementation 'io.github.luohaohaha:rtmpx:latest'

2. Put CameraXImplView in the xml layout

...
 <com.rtmpx.library.camera.widget.CameraXImplView
        android:id="@+id/preview"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
...

3. set publish config

  Config config = new Config.ConfigBuilder()
                .withBitRate(1000 * 5000) //bitrate
                .withPublishUrl("rtmp://192.168.50.170:18888/test/live") //publish url
                .withFrameRate(60)//fps
                .withVideoWidth(1080)//width 
                .withVideoHeight(1920) //height
                .withRecordVideo(false)//record video
                .withRecordVideoPath("sdcard/dump.mp4")//path
                .build();

4. bind camera preview

 CameraXImplView mPreview = findViewById(R.id.preview);
 mPreview.setPreviewRange(mConfig.getFrameRate(),mConfig.getFrameRate());
 mPreview.setTargetResolution(mConfig.getVideoWidth(), mConfig.getVideoHeight());
 
 PublisherX mPublisher = new PublisherX(mConfig);
 mPublisher.bindCamera(mPreview);
 mPublisher.setPublishListener(this);

5. start preview & start publish

mPreview.startPreview();
mPublisher.startPublish();

or

mPreview.stopPreview();
mPublisher.stopPublish();

IPublishListener Callback

    /**
     * rtmp is connecting
     */
    void onConnecting();

    /**
     * rtmp connection is successful
     */
    void onConnected();

    /**
     * rtmp connection failed
     * @param code error code
     */
    void onConnectedFailed(int code);

    /**
     * Start publishing
     */
    void onStartPublish();

    /**
     * Stop publishing
     */
    void onStopPublish();

    /**
     * Start recording
     */
    void onStartRecord();

    /**
     * Stop recording
     */
    void onStopRecord();

    /**
     * fps statistics
     * @param fps avg fps
     */
    void onFpsStatistic(int fps);

    /**
     * rtmp disconnect
     */
    void onRtmpDisconnect();

Thanks

LibRtmp-Client-for-Android