Library

Place the jar file under the libs directory of your project. The name of the file doesn't matter.

Optionally, attach the javadoc zip file. Here are the instructions for Android Studio:
- The zip may be placed anywhere, but a convenient location is alongside the jar file
- Close the project and manually edit (there is no interface for that in the IDE - version 2.2) <project>/.idea/libraries/libmedia_X_Y_Z.xml to add this definition or an equivalent:

  1. <JAVADOC>
  2. <root url="jar://$PROJECT_DIR$/app/libs/libmedia-X.Y.Z-javadoc.zip!/" />
  3. </JAVADOC>

You may need some additional third-party libraries because of dependencies, and starting of v3.0, it is highly likely. Please comply carefully to the Integration Guidelines.

3.x Series

See the recent changes in the CHANGELOG-v3 file.

VersionFile
3.2.5 libmedia-3.2.5.jar (androidx variant)
3.2.2 libmedia-3.2.2.jar (android.support variant)
libmedia-3.1.1-javadoc.zip (valid for 3.2)

Release Notes - Migration Guide

These release notes cover the new features, as well as some backwards incompatible changes you’ll want to be aware of when upgrading from version 2.x.

A. What’s new

Class http.WifiSingleHttpServer Added

Same as LocalSingleHttpServer but for a remote player, typically designed for Chromecast devices.

Interface http.HttpServer Added

Nothing new in the contents. It is what was in LocalSingleHttpServer previously, but now in common with WifiSingleHttpServer.

The third-party HttpClient library is mandatory for any component implementing this interface.


B. Backwards incompatible changes

Package http

You need to adapt your existing application written for version 2 because all components have moved inside the package hierarchy, while keeping their behaviour.

Class http.LocalSingleHttpServer

The method diagnose() migrated to the Diagnostic class.

2.x Series

See the recent changes in the CHANGELOG-v2 file.

VersionFile
2.0libmedia-2.0.jar

Release Notes - Migration Guide

These release notes cover the new features, as well as some backwards incompatible changes you’ll want to be aware of when upgrading from version 1.x.

A. What’s new

Class libmedia.Licensing Changed

It is possible to set a developer mode to allow some checks and traces. This mode is to be used only during the development phase and for issue filing.

Class http.LocalSingleHttpServer Changed

  • It is now possible to get the media resources from a remote server, through http[s]:// or ftp:// schemes.
  • New method diagnose() and associated class Diagnostic as an helper for assistance.

Class util.Log Added

For devices without access to LogCat, route your traces to a file or an external server.


B. Backwards incompatible changes

You may need to adapt your existing application written for version 1 if you use the following components.

Interface http.LocalSingleHttpServer.CipherFactory

The exception thrown by the methods has changed from IOException to GeneralSecurityException.

1.x Series

See the recent changes in the CHANGELOG-v1 file.

VersionFile
1.4.1libmedia-1.4.1.jar

Sample Applications

Hereunder are some working demonstration samples. The project is complete, that is, it has a copy of the library already included, and an appropriate API Key is set.

Android Studio: Expand the provided archive file in the collection of your projects, open the project and confirm the creation of the missing configuration settings (you may have to adjust the Compile Sdk Version and/or Build Tools Version with your current SDK installation).

Eclipse: The provided archive file is an Eclipse Project export, that you can import in your workspace (you may have to fix the Project Build Target to an SDK available in your IDE).

Video Playing - Storage Settings

A dashboard application to:

  • Play a clear video or an encrypted video, in either a VideoView or a WebView
  • Manipulate the storage components
VersionFile
2.2 - Kotlin version Android Studio: Libmedia-3.2.3-Demo-2.2-kotlin.zip
2.2 - Java version Android Studio: Libmedia-3.2.3-Demo-2.2-java.zip
2.0 Deprecated Eclipse: ADT-Libmedia-3.1-DemoVideo-2.0.zip

Archives

This section is hosting old material that is not online anymore. Install your local copy if you need.

API doc

VersionFile
1Libmedia-apidoc-1.zip