RtmpPublisher

To use RtmpPublisher in your Android project, add the following dependency to your build.gradle file. Replace x.x.x with the desired version number.

dependencies {
    compile 'com.github.takusemba:rtmppublisher:x.x.x'
}

RtmpPublisher is an Android RTMP client. To test it, you need an RTMP server and a player. You can use the following resources prepared by the author:

• Server: docker-nginx-rtmp
• RTMP Player: RtmpPlayer
• HLS Player: HlsPlayer

Once a Publisher is created, you can control the streaming lifecycle and camera settings using the following methods:

• startPublishing(): Begins the RTMP stream.
• stopPublishing(): Stops the current stream.
• switchCamera(): Toggles between the front and back cameras.

// start publishing!
publisher.startPublishing()

// switch camera between front and back
publisher.switchCamera()

// stop publishing!
publisher.stopPublishing()

Use the Publisher.Builder to configure and instantiate a Publisher. You must provide a context (e.g., this in an Activity), a GLView for rendering, and the RTMP url. You can also customize the resolution, audio/video bitrates, camera mode, and attach a listener.

val publisher: Publisher = Publisher.Builder(this)
  .setGlView(glView)
  .setUrl(rtmpUrl)
  .setSize(Publisher.Builder.DEFAULT_WIDTH, Publisher.Builder.DEFAULT_HEIGHT)
  .setAudioBitrate(Publisher.Builder.DEFAULT_AUDIO_BITRATE)
  .setVideoBitrate(Publisher.Builder.DEFAULT_VIDEO_BITRATE)
  .setCameraMode(Publisher.Builder.DEFAULT_MODE)
  .setListener(this)
  .build()

Implement the PublisherListener interface and register it using setOnPublisherListener to respond to streaming events such as connection status and disconnections.

publisher.setOnPublisherListener(object: PublisherListener {
  override fun onStarted() {
    // do something
  }
  override fun onStopped() {
    // do something
  }
  override fun onFailedToConnect() {
    // do something
  }
  override fun onDisconnected() {
    // do something
  }
})

To initialize an RTMP streaming session, use the Publisher.Builder class. You must provide an AppCompatActivity, a GLSurfaceView for the video preview, and the target RTMP url. You can optionally configure the video/audio bitrates, stream resolution, camera mode, and a PublisherListener for lifecycle events.

Publisher publisher = new Publisher.Builder(activity)
    .setGlView(glSurfaceView)
    .setUrl("rtmp://your-server-url/live/stream")
    .setSize(1280, 720)
    .setVideoBitrate(100000)
    .setAudioBitrate(6400)
    .setCameraMode(CameraMode.BACK)
    .setListener(new PublisherListener() {
        // Implement listener methods
    })
    .build();

The Publisher interface provides the primary methods for managing the lifecycle of an RTMP stream and controlling the camera hardware.

// Start the stream
publisher.startPublishing();

// Switch between front and back cameras
publisher.switchCamera();

// Check if currently streaming
if (publisher.isPublishing()) {
    // ...
}

// Stop the stream
publisher.stopPublishing();

When using Publisher.Builder, you can set the following parameters: