Hosting Methods

July 2, 2026 · View on GitHub

Click to see the Chinese version

There are currently three hosting methods:

  • MavenCentral: Available after version 11.0.0, all base class packages are published and hosted here.
  • Github Package: Available from version 9.1.0, but before version 11.0.0, the basic dependencies of GSYIjkJava are still hosted on jitpack.
  • Jitpack IO: Will continue to be released, but there is a random loss of packages on the hosting platform.

Since jitpack keeps losing packages, it has been migrated to MavenCentral. The usage is as follows:

First Add

allprojects {
    repositories {
        ///...
        mavenCentral()
        maven { url "https://maven.aliyun.com/repository/public" }
    }
}

You can choose one of the following three and add it to the build.gradle under the module.

A. Direct Introduction

 //Complete version introduction

implementation 'io.github.carguo:gsyvideoplayer:13.1.0'


//Whether AliPlayer mode is needed
implementation 'io.github.carguo:gsyvideoplayer-aliplay:13.1.0'

B. Add java and the so support you want:

 implementation 'io.github.carguo:gsyvideoplayer-java:13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-exo2:13.1.0'

 //Whether AliPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-aliplay:13.1.0'

 //so of ijk mode according to your needs
 implementation 'io.github.carguo:gsyvideoplayer-arm64:13.1.0'
 implementation 'io.github.carguo:gsyvideoplayer-armv7a:13.1.0'
 implementation 'io.github.carguo:gsyvideoplayer-armv5:13.1.0'
 implementation 'io.github.carguo:gsyvideoplayer-x86:13.1.0'
 implementation 'io.github.carguo:gsyvideoplayer-x64:13.1.0'

C. Support other format protocols (mpeg, rtsp, concat, crypto protocols, support 16k Page Size)

A and B normal versions support 263/264/265, etc. For mpeg encoding, there will be sound but no picture. The so introduced by C supports mpeg encoding and other supplementary protocols, but the so package is relatively larger.

 implementation 'io.github.carguo:gsyvideoplayer-java:13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-exo2:13.1.0'

 //Whether AliPlayer mode is needed
 implementation 'io.github.carguo:gsyvideoplayer-aliplay:13.1.0'

 //More ijk encoding support
 implementation 'io.github.carguo:gsyvideoplayer-ex_so:13.1.0'

D. Jetpack Compose Support (Optional)

 implementation 'io.github.carguo:gsyvideoplayer-compose:13.1.0'

gsyvideoplayer-compose depends on gsyvideoplayer-java; if you need ExoPlayer, AliPlayer, or a specific IJK so package, keep adding the matching module above.

Since Jitpack often has the problem of random loss of historical packages, a new Github Package dependency method is added. The usage is as follows:

However, accessing github package requires a token to access, which is more troublesome, but it is stable.

allprojects {
    repositories {
		//...
        maven {
            url 'https://maven.pkg.github.com/CarGuo/GSYVideoPlayer'

            // You can also use your own GitHub account and token
            // For convenience, I have provided a token for an infrequently used account here
            credentials {
                // your github name
                username = 'carsmallguo'
                // your github generate new token
                password = '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'
            }
        }
        maven {
            url "https://maven.aliyun.com/repository/public"
        }
        mavenCentral()
    }
}

In theory, it is the avatar in the upper right corner - Settings - Developer Settings - Personal access tokens - tokens (classic) - Generate new token (classic) - read:packages Remember to choose permanent for the expiration time

You can choose one of the following three and add it to the build.gradle under the module.

A. Direct Introduction

 //Complete version introduction
 implementation 'com.shuyu:gsyvideoplayer:13.1.0'


 //Whether AliPlayer mode is needed
 implementation 'com.shuyu:gsyvideoplayer-aliplay:13.1.0'

B. Add java and the so support you want:

 implementation 'com.shuyu:gsyvideoplayer-java:13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'com.shuyu:gsyvideoplayer-exo2:13.1.0'

 //Whether AliPlayer mode is needed
 implementation 'com.shuyu:gsyvideoplayer-aliplay:13.1.0'

 //so of ijk mode according to your needs
 implementation 'com.shuyu:gsyvideoplayer-armv5:13.1.0'
 implementation 'com.shuyu:gsyvideoplayer-armv7a:13.1.0'
 implementation 'com.shuyu:gsyvideoplayer-arm64:13.1.0'
 implementation 'com.shuyu:gsyvideoplayer-x86:13.1.0'
 implementation 'com.shuyu:gsyvideoplayer-x64:13.1.0'

C. Support other format protocols (mpeg, rtsp, concat, crypto protocols, support 16k Page Size)

A and B normal versions support 263/264/265, etc. For mpeg encoding, there will be sound but no picture. The so introduced by C supports mpeg encoding and other supplementary protocols, but the so package is relatively larger.

 implementation 'com.shuyu:gsyvideoplayer-java:13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'com.shuyu:gsyvideoplayer-exo2:13.1.0'


 //Whether AliPlayer mode is needed
 implementation 'com.shuyu:gsyvideoplayer-aliplay:13.1.0'

 //More ijk encoding support
 implementation 'com.shuyu:gsyvideoplayer-ex_so:13.1.0'

D. Jetpack Compose Support (Optional)

 implementation 'com.shuyu:gsyvideoplayer-compose:13.1.0'

Historical packages may have random packet loss, and it is not easy to supplement, see #4144:

First, add in the build.gradle under the project

allprojects {
    repositories {
		//...
        maven { url 'https://jitpack.io' }
        maven { url "https://maven.aliyun.com/repository/public" }
        mavenCentral()
    }
}

You can choose one of the following three and add it to the build.gradle under the module.

A. Direct Introduction

 //Complete version introduction

 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer:v13.1.0'


 //Whether AliPlayer mode is needed
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-aliplay:v13.1.0'

B. Add java and the so support you want:

 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-java:v13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-exo2:v13.1.0'

 //Whether AliPlayer mode is needed
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-aliplay:v13.1.0'

 //so of ijk mode according to your needs
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-arm64:v13.1.0'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-armv7a:v13.1.0'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-armv5:v13.1.0'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-x86:v13.1.0'
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-x64:v13.1.0'

C. Support other format protocols (mpeg, rtsp, concat, crypto protocols, support 16k Page Size)

A and B normal versions support 263/264/265, etc. For mpeg encoding, there will be sound but no picture. The so introduced by C supports mpeg encoding and other supplementary protocols, but the so package is relatively larger.

 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-java:v13.1.0'

 //Whether ExoPlayer mode is needed
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-exo2:v13.1.0'

 //Whether AliPlayer mode is needed
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-aliplay:v13.1.0'

 //More ijk encoding support
 implementation 'com.github.CarGuo.GSYVideoPlayer:gsyvideoplayer-ex_so:v13.1.0'

Cast (DLNA/UPnP) Dependencies

The cast capability lives inside gsyVideoPlayer-java — no separate publishing module. The default implementation speaks DLNA AVTransport:1 on top of jUPnP 3.0.3, so only downstream projects that actually need casting have to add jUPnP; everybody else pays zero AAR increment.

Maven Central coordinates:

dependencies {
    // Kernel: CastCapability / CastProvider / CastSession SPI + the default JupnpDlnaProvider
    implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-java:v13.1.0'

    // Cast capability: DLNA/UPnP on jUPnP 3.0.3
    implementation 'org.jupnp:org.jupnp:3.0.3'
    implementation 'org.jupnp:org.jupnp.support:3.0.3'
}

Centralised version management lives in gradle/dependencies.gradle as deps.jupnp:

deps.jupnp = [
    core   : "org.jupnp:org.jupnp:3.0.3",
    support: "org.jupnp:org.jupnp.support:3.0.3",
]

Notes:

  • Network permissions: both sender and receiver need INTERNET, ACCESS_WIFI_STATE, CHANGE_WIFI_MULTICAST_STATE, and ACCESS_NETWORK_STATE. Devices only discover each other on the same Wi-Fi LAN via SSDP.
  • Android separate process: the demo Loopback Receiver runs in a dedicated :dlna process to keep jUPnP's static state out of the main process. See DevReceiverService when self-integrating.
  • Android 13+ requires RECEIVER_NOT_EXPORTED for internal broadcasts. See CastReceiverManager.
  • The floating-window receiver requires SYSTEM_ALERT_WINDOW. Production integrations should render the incoming stream in an Activity or Surface instead of a floating window.
  • If you do not need casting, do not pull in jUPnP; CastCapability falls back to a no-op implementation and the SPI stays intact.

See CAST_FEATURE_PLAN.md and CAST_TEST_PLAYBOOK.md for the capability goals and pass/fail criteria.