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.
The zip may be placed anywhere, but a convenient location is alongside the jar file.
Subject to unstability Experimented with Android Studio Ladybug Feature Drop | 2024.2.2.
How to associate the javadoc file with the classes file depends on a setting in this project configuration file:
<project>/.idea/misc.xml.
• Case 1: There is a <component name="ExternalStorageConfigurationManager" enabled="true" /> node.
It seems to be the case with the use of a recent 'New Project' template in the IDE.
- There is no <project>/.idea/libraries/ folder in comparison with case 2 below.
- On the Project Window with the view mode as Project, under the External Libraries node,
there is no related entry (as it is for an aar file).
There is no known way to link the javadoc file with a jar file. Not experimented workarounds may be: switch the configuration to case 2, or wrap the jar in an aar.
• Case 2: There is no such component declaration (or maybe enabled="false").
It is likely the case with an existing ancient project.
- Close the project (otherwise, the hereunder cache file may not be synchronized with the file system).
- Explore <project>/.idea/libraries/ to find the file named like Gradle__C.xml[1],
with the <CLASSES> node pointing to the jar.
- Manually edit this file to have this definition or an equivalent (substituting X.Y.Z with the actual version):
<JAVADOC>
<root url="jar://$PROJECT_DIR$/app/libs/libmedia-X.Y.Z-javadoc.zip!/" />
</JAVADOC>
Example of a final result:
[1]: If there is more than one library, it may be named Gradle__C__<n>_.xml, with n as a number.
♦ 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.
| Version | File |
|---|---|
| 3.2.6 | libmedia-3.2.6.jar |
| 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.
| Version | File |
|---|---|
| 2.0 | libmedia-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 classDiagnosticas 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.
| Version | File |
|---|---|
| 1.4.1 | libmedia-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).
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
| Version | File |
|---|---|
| 2.3 - Android Gradle Plugin 8.8.2, Gradle 8.10.2, Toolchain 21, SDK 35 | Libmedia-3.2.6-Demo-2.3.zip |
| 2.2 - Kotlin version - Android Gradle Plugin 3.6.3, Gradle 6.4 | Android Studio: Libmedia-3.2.3-Demo-2.2-kotlin.zip |
Archives - Deprecated
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).
| Version | File |
|---|---|
| 2.2 - Java version | Android Studio: Libmedia-3.2.3-Demo-2.2-java.zip |
| 2.0 | 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
| Version | File |
|---|---|
| 1 | Libmedia-apidoc-1.zip |