android-mjpeg-view

Android custom View for displaying MJPEG stream.

• This custom view only requires a specific http(s) url.
• Supported image scaling methods are fit width, fit height, original size, stretch and best fit.
• Only boundary is used to separate each jpeg image (i.e. each frame) from a stream. Content-length is ignored.
• A boundary must be specified in an HTTP headr (Content-type), otherwise a default boundary pattern will be used.

Basic usage

1. This library is hosted on Maven Central, so make sure you added mavenCentral() as one of repositories

dependencyResolutionManagement {
    ...
    repositories {
        ...
        mavenCentral()
    }
}

2. Include a library in to your project by adding this to app level build.gradle file.

dependencies {
    ...
    implementation 'com.perthcpe23.dev:android-mjpeg-view:1.1.2'
}

3. Add a view to XML layout:

<com.longdo.mjpegviewer.MjpegView
    android:id="@+id/mjpegview"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

4. Specify mjpeg source and start streaming

MjpegView viewer = (MjpegView) findViewById(R.id.mjpegview);
viewer.setMode(MjpegView.MODE_FIT_WIDTH);
viewer.setAdjustHeight(true);
viewer.setSupportPinchZoomAndPan(true);
viewer.setUrl("https://app.punyapat.me/mjpeg-server/mjpeg");
viewer.startStream();

//when user leaves application
viewer.stopStream();

5. Or Android Compose (skip #3 and #4)

MyApplicationTheme {
    Surface(
        modifier = Modifier.fillMaxSize(),
    ) {
        AndroidView(
            modifier = Modifier.fillMaxSize(),
            factory = { context ->
                MjpegView(context).apply {
                    mode = MjpegView.MODE_FIT_WIDTH
                    isAdjustHeight = true
                    supportPinchZoomAndPan = true
                    setUrl("https://app.punyapat.me/mjpeg-server/mjpeg")
                    startStream()
                }
            },
        )
    }
}

6. Don't forget to add internet access permission to Android manifests file

<uses-permission android:name="android.permission.INTERNET" />

• You can also download .aar at https://github.com/perthcpe23/android-mjpeg-view/tree/master/aar

Contact

[email protected]