feat(android): ExoPlayer for Android

packages/audioplayers/example/pubspec.yaml

@@ -4,6 +4,7 @@ publish_to: none
 
 dependencies:
   audioplayers: ^6.1.2
+  audioplayers_android_exo: ^0.0.1
   collection: ^1.16.0
   file_picker: ^8.0.3
   flutter:

packages/audioplayers_android_exo/.gitignore

@@ -0,0 +1,17 @@
+*.iml
+.DS_Store
+.atom/
+.idea
+.packages
+.dart_tool/
+.pub/
+build/
+ios/.generated/
+packages
+.classpath
+.project
+.settings
+.vscode
+testing
+.flutter-plugins-dependencies
+flutter_export_environment.sh

packages/audioplayers_android_exo/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: a0860f6e87ba4f9031bee4d6f56c08b970606bee
+  channel: dev
+
+project_type: plugin

packages/audioplayers_android_exo/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+- **FEAT**: AudioPlayers for Android based on ExoPlayer

packages/audioplayers_android_exo/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Luan Nico
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/audioplayers_android_exo/README.md

@@ -0,0 +1,22 @@
+<p align="center">
+  <a href="https://pub.dev/packages/audioplayers">
+    <img alt="AudioPlayers" height="150px" src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/logo_ap_compact.svg">
+  </a>
+</p>
+
+---
+
+# audioplayers_android_exo
+<p>
+  <a title="Pub" href="https://pub.dev/packages/audioplayers_android_exo"><img src="https://img.shields.io/pub/v/audioplayers_android_exo.svg?style=popout&include_prereleases"/></a>
+  <a title="Build Status" href="https://github.com/bluefireteam/audioplayers/actions?query=workflow%3Abuild+branch%3Amain"><img src="https://github.com/bluefireteam/audioplayers/workflows/build/badge.svg?branch=main"/></a>
+  <a title="Discord" href="https://discord.gg/pxrBmy4"><img src="https://img.shields.io/discord/509714518008528896.svg"/></a>
+  <a title="Melos" href="https://github.com/invertase/melos"><img src="https://img.shields.io/badge/maintained%20with-melos-f700ff.svg"/></a>
+</p>
+
+The Android implementation of [`audioplayers`](https://pub.dev/packages/audioplayers).
+
+## Usage
+
+This package is [not endorsed](https://flutter.dev/docs/development/packages-and-plugins/developing-packages#endorsed-federated-plugin),
+which means you can replace the default Android implementation of `audioplayers` with this package by adding `audioplayers_android_exo` to the apps `pubspec.yaml`.

packages/audioplayers_android_exo/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:flame_lint/analysis_options.yaml

packages/audioplayers_android_exo/android/.gitignore

@@ -0,0 +1,12 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures
+
+/gradle
+/gradlew
+/gradlew.bat

packages/audioplayers_android_exo/android/build.gradle

@@ -0,0 +1,83 @@
+group 'xyz.luan.audioplayers'
+version '1.0-SNAPSHOT'
+
+buildscript {
+    ext.kotlin_version = '1.7.10'
+    ext.coroutines_version = '1.6.4'
+
+    repositories {
+        google()
+        mavenCentral()
+    }
+
+    dependencies {
+        classpath 'com.android.tools.build:gradle:7.3.1'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+        classpath "de.mannodermaus.gradle.plugins:android-junit5:1.7.1.1"
+    }
+}
+
+rootProject.allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply plugin: 'de.mannodermaus.android-junit5'
+
+android {
+    compileSdk 33
+
+    // Conditional for compatibility with AGP <4.2.
+    if (project.android.hasProperty('namespace')) {
+        namespace 'xyz.luan.audioplayers'
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+
+    sourceSets {
+        main.java.srcDirs += 'src/main/kotlin'
+    }
+
+    defaultConfig {
+        minSdkVersion 16
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    lint {
+        disable 'InvalidPackage'
+    }
+}
+
+allprojects {
+    gradle.projectsEvaluated {
+        tasks.withType(JavaCompile) {
+            options.compilerArgs << "-Xlint:unchecked" << "-Xlint:deprecation"
+        }
+    }
+}
+
+dependencies {
+    implementation "androidx.core:core-ktx:1.9.0" // Do not pump unless dropping support for AGP7
+    implementation 'androidx.media3:media3-exoplayer:1.1.1'
+    implementation "androidx.media3:media3-exoplayer-dash:1.1.1"
+    implementation 'androidx.media3:media3-transformer:1.1.1'
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutines_version"
+    testImplementation 'org.junit.jupiter:junit-jupiter:5.9.0'
+    testImplementation 'org.assertj:assertj-core:3.23.1'
+}
+repositories {
+    mavenCentral()
+}

packages/audioplayers_android_exo/android/gradle.properties

@@ -0,0 +1,2 @@
+org.gradle.jvmargs=-Xmx1536M
+android.useAndroidX=true

packages/audioplayers_android_exo/android/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'audioplayers_android_exo'

packages/audioplayers_android_exo/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest package="xyz.luan.audioplayers"/>

packages/audioplayers_android_exo/android/src/main/kotlin/xyz/luan/audioplayers/AudioContextAndroid.kt

@@ -0,0 +1,69 @@
+package xyz.luan.audioplayers
+
+import android.annotation.SuppressLint
+import android.media.AudioAttributes
+import android.media.AudioAttributes.Builder
+import android.media.AudioAttributes.CONTENT_TYPE_MUSIC
+import android.media.AudioAttributes.USAGE_MEDIA
+import android.media.AudioAttributes.USAGE_NOTIFICATION_RINGTONE
+import android.media.AudioAttributes.USAGE_VOICE_COMMUNICATION
+import android.media.AudioManager
+import android.media.MediaPlayer
+import android.os.Build
+import androidx.annotation.RequiresApi
+import java.util.*
+
+data class AudioContextAndroid(
+    val isSpeakerphoneOn: Boolean,
+    val stayAwake: Boolean,
+    val contentType: Int,
+    val usageType: Int,
+    val audioFocus: Int,
+    val audioMode: Int,
+) {
+    @SuppressLint("InlinedApi") // we are just using numerical constants
+    constructor() : this(
+        isSpeakerphoneOn = false,
+        stayAwake = false,
+        contentType = CONTENT_TYPE_MUSIC,
+        usageType = USAGE_MEDIA,
+        audioFocus = AudioManager.AUDIOFOCUS_GAIN,
+        audioMode = AudioManager.MODE_NORMAL,
+    )
+
+    fun setAttributesOnPlayer(player: MediaPlayer) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            player.setAudioAttributes(buildAttributes())
+        } else {
+            @Suppress("DEPRECATION")
+            player.setAudioStreamType(getStreamType())
+        }
+    }
+
+    @RequiresApi(Build.VERSION_CODES.LOLLIPOP)
+    fun buildAttributes(): AudioAttributes {
+        return Builder()
+            .setUsage(usageType)
+            .setContentType(contentType)
+            .build()
+    }
+
+    @Deprecated("This is used for Android older than LOLLIPOP", replaceWith = ReplaceWith("buildAttributes"))
+    private fun getStreamType(): Int {
+        return when (usageType) {
+            USAGE_VOICE_COMMUNICATION -> AudioManager.STREAM_VOICE_CALL
+            USAGE_NOTIFICATION_RINGTONE -> AudioManager.STREAM_RING
+            else -> AudioManager.STREAM_MUSIC
+        }
+    }
+
+    override fun hashCode() = Objects.hash(isSpeakerphoneOn, stayAwake, contentType, usageType, audioFocus, audioMode)
+
+    override fun equals(other: Any?) = (other is AudioContextAndroid) &&
+        isSpeakerphoneOn == other.isSpeakerphoneOn &&
+        stayAwake == other.stayAwake &&
+        contentType == other.contentType &&
+        usageType == other.usageType &&
+        audioFocus == other.audioFocus &&
+        audioMode == other.audioMode
+}