chore: sync with upstream livekit/client-sdk-flutter (v2.8.0) keeping our audio fixes

.changes/agp9-built-in-kotlin

@@ -0,0 +1 @@
+patch type="fixed" "Android plugin compatibility with AGP 9 built-in Kotlin"

.changes/android-media-routing

@@ -0,0 +1,3 @@
+patch type="fixed" "Apply Android media audio attributes during WebRTC initialization"
+patch type="fixed" "Use initialization audio options as the default Android session policy"
+patch type="fixed" "Avoid sticky Android speaker routing when updating route preference"

.changes/audio-manager-api

@@ -0,0 +1 @@
+minor type="added" "AudioManager audio session options with engine-driven native lifecycle and platform routing controls"

.changes/audio-processing-create-cleanup

@@ -0,0 +1 @@
+patch type="fixed" "Clean up local audio tracks when recording start fails"

.changes/audio-processing-platform-gate

@@ -0,0 +1 @@
+patch type="fixed" "Throw platformUnavailable when runtime audio processing is unsupported"

.changes/audio-processing-start-flow

@@ -0,0 +1 @@
+patch type="fixed" "Apply create-time audio processing when local recording is prepared"

.changes/runtime-audio-options

@@ -0,0 +1 @@
+minor type="added" "Runtime audio processing controls for local audio tracks"

.changes/video-degradation-default

@@ -0,0 +1 @@
+patch type="fixed" "Use maintain-resolution as the default video degradation preference for local video publishing"

.github/workflows/build.yaml

@@ -24,7 +24,7 @@ on:
 
 jobs:
   dart-format-check:
-    name: Dart Format Check
+    name: Dart Format
     runs-on: ubuntu-latest
 
     steps:
@@ -35,7 +35,7 @@ jobs:
         run: dart format . --set-exit-if-changed
 
   import-sorter-check:
-    name: Import Sorter Check
+    name: Import Sorter
     runs-on: ubuntu-latest
 
     steps:
@@ -46,7 +46,7 @@ jobs:
         run: dart run import_sorter:main --no-comments --exit-if-changed
 
   version-consistency-check:
-    name: Version Consistency Check
+    name: Version Consistency
     runs-on: ubuntu-latest
 
     steps:
@@ -57,7 +57,7 @@ jobs:
         run: dart run scripts/check_version.dart
 
   dart-analyze-check:
-    name: Dart Analyze Check
+    name: Dart Analyze
     runs-on: ubuntu-latest
 
     steps:
@@ -68,7 +68,7 @@ jobs:
         run: flutter analyze
 
   dart-test-check:
-    name: Dart Test Check
+    name: Dart Test
     runs-on: ubuntu-latest
 
     steps:
@@ -79,7 +79,7 @@ jobs:
         run: flutter test
 
   build-for-android:
-    name: Build for Flutter Android
+    name: Android
     runs-on: ubuntu-latest
 
     steps:
@@ -93,7 +93,7 @@ jobs:
         run: flutter build apk
 
   build-for-ios:
-    name: Build for Flutter iOS
+    name: iOS
     runs-on: macos-latest
 
     steps:
@@ -112,7 +112,7 @@ jobs:
         run: flutter build ios --release --no-codesign
 
   build-for-windows:
-    name: Build for Flutter Windows
+    name: Windows
     runs-on: windows-latest
 
     steps:
@@ -124,7 +124,7 @@ jobs:
         run: flutter build windows --release
 
   build-for-macos:
-    name: Build for Flutter macOS
+    name: macOS
     runs-on: macos-latest
 
     steps:
@@ -136,7 +136,7 @@ jobs:
         run: flutter build macos --release
 
   build-for-linux:
-    name: Build for Flutter Linux
+    name: Linux
     runs-on: ubuntu-latest
 
     steps:
@@ -154,7 +154,7 @@ jobs:
         run: flutter build linux
 
   build-for-web:
-    name: Build for Flutter Web
+    name: Web
     runs-on: ubuntu-latest
 
     steps:
@@ -168,7 +168,7 @@ jobs:
         run: flutter build web
 
   build-for-web-wasm:
-    name: Build for Flutter Web WASM
+    name: Web WASM
     runs-on: ubuntu-latest
 
     steps:

.version

@@ -1 +1 @@
-2.7.0
+2.8.0

CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## 2.8.0
+
+* Added: Session API support for simpler E2EE setup
+* Changed: Manual video quality selection can be used with adaptive stream enabled
+* Changed: Generated protocol definitions for LiveKit protocol v1.45.8
+* Fixed: waitForBufferStatusLow busy-waiting after engine close
+* Fixed: Simulcast lower layers exceeding the top layer
+* Fixed: forceRelay log message interpolation
+* Fixed: sendSyncState error handling so sync-state preparation failures are not swallowed
+* Fixed: Screen share simulcast default low layer alignment
+* Fixed: Region failover null-provider dereference
+* Fixed: Android builds with dependencies that require compileSdk 36
+* Fixed: Deferred track listener leaks across reconnects
+* Fixed: Adaptive stream dimensions on high-density displays
+* Fixed: Session.start() reentrancy during concurrent calls
+* Fixed: Connected server address resolving from the wrong peer connection
+* Fixed: Reconnect counter null assertion on the first reconnect attempt
+* Fixed: Premature publication disposal during unpublish
+
 ## 2.7.0
 
 * Added: Add setVideoDimensions for remote track publications

README.md

@@ -46,7 +46,7 @@ Include this package to your `pubspec.yaml`
 ```yaml
 ---
 dependencies:
-  livekit_client: ^2.7.0
+  livekit_client: ^2.8.0
 ```
 
 ### iOS
@@ -150,30 +150,18 @@ void main() async {
 
 #### Audio Modes
 
-By default, we use the `communication` audio mode on Android which works best for two-way voice communication.
+By default LiveKit uses the `communication` audio mode on Android, which works best for two-way voice communication.
 
-If your app is media playback oriented and does not need the use of the device's microphone, you can use the `media`
-audio mode which will provide better audio quality.
+If your app is media playback oriented and does not need the device's microphone, apply the `media` session yourself. This
+switches `AudioManager` to manual mode, where your app owns the session.
 
 ```dart
-import 'package:flutter_webrtc/flutter_webrtc.dart' as webrtc;
-
-Future<void> _initializeAndroidAudioSettings() async {
-  await webrtc.WebRTC.initialize(options: {
-    'androidAudioConfiguration': webrtc.AndroidAudioConfiguration.media.toMap()
-  });
-  webrtc.Helper.setAndroidAudioConfiguration(
-      webrtc.AndroidAudioConfiguration.media);
-}
-
-void main() async {
-  await _initializeAudioSettings();
-  runApp(const MyApp());
-}
+await AudioManager.instance.setAudioSessionOptions(
+  const AudioSessionOptions.media(),
+);
 ```
 
-Note: the audio routing will become controlled by the system and cannot be manually changed with functions like
-`Hardware.selectAudioOutput`.
+See the [audio session guide](https://github.com/livekit/client-sdk-flutter/blob/main/docs/audio.md) for more.
 
 ### Desktop support
 
@@ -322,6 +310,13 @@ Widget build(BuildContext context) {
 
 Audio tracks are played automatically as long as you are subscribed to them.
 
+LiveKit owns the platform audio session through `AudioManager`. A call is managed automatically with no setup. Speaker routing and, when you need it, manual session control go through the same object. See the [audio session guide](https://github.com/livekit/client-sdk-flutter/blob/main/docs/audio.md) for examples covering the automatic and manual modes, speaker routing, per platform overrides, and migration from the older `Hardware` APIs.
+
+```dart
+// A call is managed automatically. Route to the speaker when you want.
+await AudioManager.instance.setSpeakerOutputPreferred(true);
+```
+
 ### Handling changes
 
 LiveKit client makes it simple to build declarative UI that reacts to state changes. It notifies changes in two ways

android/build.gradle

@@ -2,7 +2,7 @@ group = "io.livekit.plugin"
 version = "1.0-SNAPSHOT"
 
 buildscript {
-    ext.kotlin_version = "1.8.22"
+    ext.kotlin_version = "2.1.0"
     repositories {
         google()
         mavenCentral()
@@ -18,11 +18,23 @@ allprojects {
     repositories {
         google()
         mavenCentral()
+        maven { url 'https://jitpack.io' }
     }
 }
 
 apply plugin: "com.android.library"
-apply plugin: "kotlin-android"
+
+// AGP 9's built-in Kotlin compiles Kotlin itself and rejects the Kotlin Gradle
+// Plugin. Apply KGP only when built-in Kotlin is NOT active: that means AGP < 9,
+// or AGP 9 with android.builtInKotlin=false (the configuration Flutter currently
+// ships by default while the ecosystem migrates).
+def agpMajor = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize(".")[0] as int
+def builtInKotlinActive = agpMajor >= 9 &&
+    (!project.hasProperty("android.builtInKotlin") ||
+        Boolean.parseBoolean(project.property("android.builtInKotlin").toString()))
+if (!builtInKotlinActive) {
+    apply plugin: "kotlin-android"
+}
 
 android {
     if (project.android.hasProperty("namespace")) {
@@ -36,10 +48,6 @@ android {
         targetCompatibility = JavaVersion.VERSION_1_8
     }
 
-    kotlinOptions {
-        jvmTarget = JavaVersion.VERSION_1_8
-    }
-
     sourceSets {
         main.java.srcDirs += "src/main/kotlin"
         test.java.srcDirs += "src/test/kotlin"
@@ -52,8 +60,11 @@ android {
     dependencies {
         testImplementation("org.jetbrains.kotlin:kotlin-test")
         testImplementation("org.mockito:mockito-core:5.0.0")
-        implementation 'io.github.webrtc-sdk:android:144.7559.01'
+        implementation 'io.github.webrtc-sdk:android:144.7559.09'
         implementation 'io.livekit:noise:2.0.0'
+        // Audio device/focus/mode routing. Pinned to the same revision used by
+        // the LiveKit Android SDK (AudioSwitchHandler).
+        implementation 'com.github.davidliu:audioswitch:039a35aefab7747c557242fa216c9ea11743b604'
     }
 
     testOptions {
@@ -68,3 +79,19 @@ android {
         }
     }
 }
+
+// Configure the Kotlin JVM target. The compilerOptions DSL requires KGP 1.9+ or
+// AGP 9 built-in Kotlin; older Flutter app templates ship KGP 1.8.x, which only
+// supports the legacy kotlinOptions DSL.
+def kotlinExt = project.extensions.findByName("kotlin")
+if (kotlinExt?.hasProperty("compilerOptions")) {
+    kotlin {
+        compilerOptions {
+            jvmTarget = org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8
+        }
+    }
+} else {
+    android.kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_1_8.toString()
+    }
+}