nexxplay

Description:

nexxplay

nexxPLAY Flutter #
Features #
Flutter plugin serves as a wrapper for the Android nexxPLAY, and, combined with the custom code that the "example" app provides, enables next features:

nexxPLAY native view wrapped with a widget available for use
Dynamic configuration support
Public API, consisting from methods falling under these categories: 'Preparing and Configuring the Player', 'Playback Control', 'Requesting Player Status and Details'
Player events observation
Fullscreen mode
PiP mode
Please note that iOS is not supported by this plugin.

Integration guide #


First of all, nexxPLAY dependency has to be included into pubspec.yaml.


Secondly, there is a set of Gradle preparations that need to be done:
2.1. Exclude META-INF & LICENCE files from the packaging options:
packagingOptions {
exclude 'META-INF/ASL2.0'
exclude 'META-INF/LICENSE'
exclude 'META-INF/LICENSE.txt'
exclude 'LICENSE.txt'
exclude 'META-INF/license.txt'
exclude 'META-INF/NOTICE'
exclude 'META-INF/DEPENDENCIES'
exclude 'META-INF/NOTICE.txt'
exclude 'META-INF/notice.txt'
}
copied to clipboard
Refer to example/android/app/build.gradle for more details.
2.2. Minification has to be disabled. Either the native nexxPLAY package can be excluded by the minifier tool (tv.nexx.*) or the whole process could be disabled completely like this:
minifyEnabled false
shrinkResources false
copied to clipboard
Refer to example/android/app/build.gradle for more details.


Thirdly, a set of Android native configurations have to be done:
3.1. In the Android app's main manifest file, add tools:replace="android:label" to the application tag.
Refer to example/android/app/src/main/AndroidManifest.xml for more details.
3.2. In the Android app's main manifest file, add android:resizeableActivity="true" and android:supportsPictureInPicture="true" to the tag of the Activity you are using. Refer to example/android/app/src/main/AndroidManifest.xml for more details.
Refer to `example/android/app/src/main/AndroidManifest.xml` for more details.

3.3. In the Activity's code add (or extend) overrides for `onUserLeaveHint` and `onPictureInPictureModeChanged` methods like this:
```java
public class MainActivity extends FlutterActivity {
// ...
@Override
public void onUserLeaveHint() {
super.onUserLeaveHint();
NexxPlugin.post(OnUserLeaveHintEvent.create());
}

@Override
public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);
NexxPlugin.post(OnPIPModeChangedEvent.create(isInPictureInPictureMode, newConfig));
}
}
copied to clipboard
Refer to example/android/app/src/main/java/tv/nexx/flutter/android_example/MainActivity.java for more details.
Kotlin version:
class MainActivity : FlutterActivity {
override fun onUserLeaveHint() {
super.onUserLeaveHint()
NexxPlugin.post(OnUserLeaveHintEvent.create())
}

override fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean, newConfig: Configuration) {
super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig)
NexxPlugin.post(OnPIPModeChangedEvent.create(isInPictureInPictureMode,newConfig))
}
}
copied to clipboard


Next, inherit from the AppCompat theme for the Android native app part (required by ChromeCast, even if you don't use it, unfortunately):


<style name="NormalTheme" parent="Theme.AppCompat.DayNight.NoActionBar">
<item name="android:windowBackground">?android:colorBackground</item>
</style>
copied to clipboard
Ensure that you have the AndroidX AppCompat dependency, a transitive or a direct one ( implementation "androidx.appcompat:appcompat:1.4.0"). Refer to example/android/app/build.gradle, example/android/app/src/main/res/values/styles.xml and example/android/app/src/main/res/values-night/styles.xml for more details.


Kotlin Gradle Plugin (KGP) with the newer Android Gradle Plugin versions are including a set of the androidx.* dependencies necessary for the native library; the example project uses 1.9.20 for Kotlin and 8.5 for AGP, Gradle Wrapper's version being 8.7. One of the exceptions hinting to the Gradle environment update is Fatal Exception: java.lang.RuntimeException: Unable to get provider androidx.startup.InitializationProvider: java.lang.ClassNotFoundException: Didn't find class "androidx.startup.InitializationProvider".


Lastly, there is a set of things to be done from the Flutter PoV for proper fullscreen and PiP support. Example app's main.dart file contains all the documentation necessary for that. INTEGRATION_GUIDE markers were placed all over the documentation for navigation to make the integration process easier.


[OPTIONAL] Sharing Android's MediaSessionCompat instance for all the native nexxPLAY instances.
7.1. In the build.gradle's dependencies block, the following line should be present: implementation "androidx.media:media:1.6.0". Refer to example/android/app/build.gradle for more details.
7.2. In the host Activity class code, protected void onCreate(@Nullable Bundle savedInstanceState) method should be overriden (or, for Kotlin, protected onCreate(@Nullable savedInstanceState: Bundle)). Refer to example/android/app/src/main/java/tv/nexx/flutter/android_example/MainActivity.java for more details.
7.3. Inside the onCreate(Bundle) method, the following lines should be present:
final MediaSessionCompat mediaSession = new MediaSessionCompat(getApplicationContext(), getPackageName());
NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_MEDIA_SESSION, mediaSession);
copied to clipboard
Or, for Kotlin:
val mediaSession = MediaSessionCompat(applicationContext, packageName)
NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_MEDIA_SESSION, mediaSession)
copied to clipboard
The following import has to be present:
import android.support.v4.media.session.MediaSessionCompat;
copied to clipboard
For the Kotlin version, omit the ending semicolon.


[OPTIONAL] Advertisements support.
8.1. In the build.gradle's dependencies block, the following line should be present: implementation "tv.nexx.android:admanager:1.0.05". Refer to example/android/app/build.gradle for more details.
8.2. In the host Activity class code, protected void onCreate(@Nullable Bundle savedInstanceState) method should be overriden (or, for Kotlin, protected onCreate(@Nullable savedInstanceState: Bundle)). Refer to example/android/app/src/main/java/tv/nexx/flutter/android_example/MainActivity.java for more details.
8.3. Inside the onCreate(Bundle) method, the following lines should be present:
NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_AD_MANAGER, NexxPlayAdManager::new);
copied to clipboard
Or, for Kotlin:
NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_AD_MANAGER, ::NexxPlayAdManager)
copied to clipboard
The following import has to be present:
import tv.nexx.android.admanager.NexxPlayAdManager;
copied to clipboard
For the Kotlin version, omit the ending semicolon.


[OPTIONAL] Chromecast support.
9.1. The next native integration guide items have to be ensured to reproduced.
9.2. Application's activity should extend FlutterFragmentActivity or it's inheritor.
9.3. When resolving the CastContext instance as described by the native integration guide, a modification has to be applied so the CastContext instance is be included into the plugin's configuration:
CastContext.getSharedInstance(this, Executors.newSingleThreadExecutor())
.addOnSuccessListener(castContext -> NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_CAST_CONTEXT, castContext))
.addOnFailureListener(exception -> Log.e("nexxPLAY", "Could not resolve CastContext", exception));
copied to clipboard
Or, for Kotlin:
CastContext.getSharedInstance(this, Executors.newSingleThreadExecutor())
.addOnSuccessListener { NexxPlayPlugin.addEnvironmentConfigurationEntry(NexxPlayPlugin.KEY_CAST_CONTEXT, it) }
.addOnFailureListener { Log.e("nexxPLAY", "Could not resolve CastContext", it) }
copied to clipboard
The following imports have to be present:
import com.google.android.gms.cast.framework.CastContext;
import java.util.concurrent.Executors;
import android.util.Log;
copied to clipboard
For the Kotlin version, omit the ending semicolons.


[OPTIONAL] Custom notification icon.
10.1. Custom notification icon can be set to an Android's R.* resource via the native hook. First, the image resource has to be added to the Android's resources bundle. In case of PNGs or JPGs, it's sufficient to just put the file into **/android/app/src/main/res/drawable directory. Otherwise, official documentation contains additional information.
10.2. Then the image resource reference has to be used in the configuration. NexxPlayPlugin class includes the addNativeConfigurationEntry and a static "key" value KEY_NOTIFICATION_ICON; value to be passed is the image resource reference — Android framework creates those automatically using the file name itself as the corresponding variable name (e.g. if your image is called "my_image.png" and is placed into the **/res/drawable directory, then Android will generate the R.drawable.my_image variable). Regular place for it is the native Android application's MainActivity class, specifically the onCreate method override:
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// ... other configuration code
NexxPlayPlugin.addNativeConfigurationEntry(NexxPlayPlugin.KEY_NOTIFICATION_ICON, R.drawable.widget_icon);
}
copied to clipboard
Or, for Kotlin:
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ... other configuration code
NexxPlayPlugin.addNativeConfigurationEntry(NexxPlayPlugin.KEY_NOTIFICATION_ICON, R.drawable.widget_icon)
}
copied to clipboard
10.3. Refer to the example project for complete integration sample.