Skip to content

README.md

Latest commit

 

History

History
97 lines (66 loc) · 2.48 KB

README.md

File metadata and controls

97 lines (66 loc) · 2.48 KB

GdxVideoDesktop Android Native

This project builds Android native replacements for desktop gdx-video library files:

  • libgdx-video-desktoparm64.so
  • libgdx-video-desktoparm.so

The JNI surface is compatible with:

  • com.badlogic.gdx.video.VideoDecoder
  • com.badlogic.gdx.video.FfMpeg

The core decoder implementation is ported from upstream gdx-video-desktop C++ code and linked against FFmpeg static libraries built for Android.

Project Layout

  • src/main/cpp/
    • Upstream decoder core (VideoDecoder.*, threading utilities)
    • JNI bridge (jni_bridge.cpp)
  • third_party/ffmpeg/
    • FFmpeg source and per-ABI build outputs
  • scripts/build_ffmpeg_android.ps1
    • Builds FFmpeg static libs for Android ABIs
  • scripts/build_native_android.ps1
    • Builds gdx-video compatibility .so using Android NDK CMake
  • scripts/inject_into_modjar.ps1
    • Injects built .so files into a mod jar root

Prerequisites

  • Windows PowerShell
  • Android NDK (detected from ANDROID_NDK_HOME / SDK path)
  • cmake in PATH
  • bash in PATH (Git Bash is supported)
  • git in PATH
  • jar in PATH (from JDK)

1) Build FFmpeg for Android

cd D:\Desktop\GdxVideoDesktopAndroidNative
.\scripts\build_ffmpeg_android.ps1

Note: asm is disabled by default for NDK compatibility when linking static FFmpeg into shared .so.

Optional:

  • Clean rebuild:
.\scripts\build_ffmpeg_android.ps1 -Clean
  • Re-enable asm (not recommended on this setup):
.\scripts\build_ffmpeg_android.ps1 -DisableAsm:$false

2) Build native gdx-video libs

.\scripts\build_native_android.ps1

Outputs:

  • out\arm64-v8a\libgdx-video-desktoparm64.so
  • out\armeabi-v7a\libgdx-video-desktoparm.so

3) Inject libs into a mod jar

.\scripts\inject_into_modjar.ps1 -ModJar "D:\path\to\your_mod.jar"

Default output jar:

  • <original-name>.android-video.jar

4) Runtime expectation

If your runtime loader maps gdx-video-desktop to:

  • libgdx-video-desktoparm64.so on arm64
  • libgdx-video-desktoparm.so on armv7

then the mod can call desktop gdx-video APIs unchanged.

Notes

  • This project targets Android-hosted JVM environments that run desktop STS mods.
  • FFmpeg feature set is intentionally constrained to common STS mod formats:
    • containers: ogg, matroska/webm, mov/mp4
    • decoders: vorbis, opus, aac, vp8, vp9, theora, av1
  • If a mod uses additional codecs, extend build_ffmpeg_android.ps1 configure flags.