StreamPack: live streaming SDK for Android based on Secure Reliable Transport (SRT)

StreamPack brings the best audio/video live technologies together in order to achieve low-latency & high quality live streaming for Android.

• Network:
  • Ultra low-latency based on SRT
  • Network adaptive bitrate mechanism
• Video:
  • Source: Cameras or Screen recorder
  • Orientation: portrait or landscape
  • Codec: HEVC/H.265 or AVC/H.264
  • Configurable bitrate, resolution, framerate (tested up to 60), encoder level, encoder profile
  • Video only mode
• Audio:
  • Codec: AAC-LC
  • Configurable bitrate, sample rate, stereo/mono, data format
  • Processing: Noise suppressor or echo cancellation
  • Audio only mode

Get StreamPack latest artifacts on jitpack.io

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.ThibaultBee:StreamPack:1.3.0'
}

For source code example on how to use camera and audio streamers, check the sample app directory. On first launch, you will have to set SRT server IP in the settings menu.

For source code example on how to use screen recorder streamer, check the sample screen recorder directory . On first launch, you will have to set SRT server IP in the settings menu.

FFmpeg has been used as an SRT server+demuxer+decoder for the tests. Check how to build FFmpeg with libsrt in SRT CookBook. Tells FFplay to listen on IP 0.0.0.0 and port 9998:

ffplay -fflags nobuffer srt://0.0.0.0:9998?mode=listener

On StreamPack sample app settings, set the server IP to your server IP and server port to 9998 . At this point, StreamPack sample app should successfully sends audio and video frames. On FFplay side, you should be able to watch this stream.

1. Add permissions to your AndroidManifest.xml and request them in your Activity/Fragment.

2. Create a SurfaceView in your layout

   <SurfaceView
   android:id="@+id/surfaceView"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />

3. Prepare audio and video configurations

val audioConfig = AudioConfig.Builder()
                      .setStartBitrate(128000)
                      .setSampleRate(48000)
                      .setNumberOfChannel(2)
                      .build()

val videoConfig = VideoConfig.Builder()
                    .setStartBitrate(1000000) // 1 Mb/s
                    .setResolution(Size(1280,720))
                    .setFps(30)
                    .build()

4. Instantiate the streamer (main live streaming class)

val streamer = CameraSrtLiveStreamer.Builder()
                .setContext(getApplication())
                .setServiceInfo(tsServiceInfo)
                .setConfiguration(audioConfig, videoConfig)
                .build()

5. Start the camera preview

streamer.startPreview(surface) // surface: SurfaceView or TextureView where to display preview

6. Start the live streaming

streamer.startStream(ip, port)

7. Stop and release

streamer.stopStream()
streamer.disconnect()
streamer.stopPreview()
streamer.release()

For more detailed explanation, check out the API documentation.

You need to add the following permissions in your AndroidManifest.xml:

    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.INTERNET" />
<!-- Application requires android.permission.WRITE_EXTERNAL_STORAGE only for IFileStreamer implementation` -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Your application also has to request the following dangerous permission: android.permission.RECORD_AUDIO, android.permission.CAMERA and android.permission.WRITE_EXTERNAL_STORAGE (only for only for IFileStreamer implementation).

For the PlayStore, your application might declare this in its AndroidManifest.xml

<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />

Even if StreamPack sdk supports a minSdkVersion 21. I strongly recommend to set the minSdkVersion of your application to a higher version (the highest is the best!) for higher performance.

Copyright 2021 Thibault B.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.