ipcam-view
Android MJPEG video streaming made simple!
A wrapper library around the well known SimpleMjpegView and android-camera-axis projects.
If you have problem to identify your IpCam url, please follow this link
Features
- Default support by
android-camera-axis
- Native support by
SimpleMjpegView
- Handle credentials
- Multiple camera in one activity
- Snapshot
- Flip image
- Video recording
- Custom appearance
Gradle dependency
repositories {
jcenter()
}
dependencies {
compile 'com.github.niqdev:mjpeg-view:1.3.2'
}
Demo app
Usage
Add to your layout: example
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
// ADD THIS
xmlns:stream="http://schemas.android.com/apk/res-auto"
...>
<com.github.niqdev.mjpeg.MjpegSurfaceView
android:id="@+id/VIEW_NAME"
android:layout_width="match_parent"
android:layout_height="match_parent"
stream:type="stream_default OR stream_native" /> </RelativeLayout>
Read stream in your activity/fragment: example
int TIMEOUT = 5; //seconds Mjpeg.newInstance()
.credential("USERNAME", "PASSWORD")
.open("IPCAM_URL.mjpg", TIMEOUT)
.subscribe(inputStream -> {
mjpegView.setSource(inputStream);
mjpegView.setDisplayMode(DisplayMode.BEST_FIT);
mjpegView.showFps(true);
}
);
Customize appearance
To get a transparent background for the surface itself (while stream is loading) as well as for the stream background
mjpegView.setTransparentBackground();
// OR stream:transparentBackground="true"
To hide the MjpegView later, you might need to reset the transparency due to internal behaviour of applying transparency
mjpegView.resetTransparentBackground();
To set other colors than transparent, be aware that they will only be applied on a running stream i.e. you can't change the color of the surface itself which you will see while the stream is loading
Note that it only works when transparentBackground
is not set to true
and that you are not able to directly set transparent background color here
mjpegView.setCustomBackgroundColor(Color.DKGRAY);
// OR stream:backgroundColor="@android:color/darker_gray"
To change the colors of the fps overlay
mjpegView.setFpsOverlayBackgroundColor(Color.DKGRAY);
mjpegView.setFpsOverlayTextColor(Color.WHITE);
To clear the last frame since the canvas keeps the current image even if you stop the stream, e.g. hide/show
mjpegView.clearStream();
Apps that use this library
You are welcome to add your app to the list!
Development
Download Android NDK:
- manually
- in Android Studio: File > Other Settings > Default Project Structure > download NDK
Compile manually (verify your paths)
$ chmod a+x compileJni.sh $ ./compileJni.sh