Add Ktor HTTP data source module

RELEASENOTES.md

@@ -157,6 +157,9 @@
 *   Downloads:
 *   OkHttp extension:
 *   Cronet extension:
+*   Ktor extension:
+    *   Add a new `media3-datasource-ktor` extension module providing a
+        `KtorDataSource` backed by the [Ktor](https://ktor.io/) HTTP stack.
 *   RTMP extension:
 *   HLS extension:
     *   Fix a bug where an `ArrayIndexOutOfBoundsException` is thrown during

core_settings.gradle.kts

@@ -95,6 +95,10 @@ include("${modulePrefix}lib-datasource-cronet")
 
 project("${modulePrefix}lib-datasource-cronet").projectDir = file("libraries/datasource_cronet")
 
+include("${modulePrefix}lib-datasource-ktor")
+
+project("${modulePrefix}lib-datasource-ktor").projectDir = file("libraries/datasource_ktor")
+
 include("${modulePrefix}lib-datasource-rtmp")
 
 project("${modulePrefix}lib-datasource-rtmp").projectDir = file("libraries/datasource_rtmp")

gradle/libs.versions.toml

@@ -67,6 +67,7 @@ kotlinAnnotationsVersion = "1.9.0"
 kotlinBomVersion = "1.8.0"
 # Not the same as kotlin version, https://github.com/Kotlin/kotlinx.coroutines/releases
 kotlinxCoroutinesVersion = "1.9.0"
+ktorVersion = "3.0.3"
 leakCanaryVersion = "2.10"
 lottieVersion = "6.6.0"
 mockitoVersion = "3.12.4"
@@ -143,6 +144,9 @@ kotlinx-coroutines-android = { group = "org.jetbrains.kotlinx", name = "kotlinx-
 kotlinx-coroutines-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-core", version.ref = "kotlinxCoroutinesVersion" }
 kotlinx-coroutines-guava = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesVersion" }
 kotlinx-coroutines-test = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-test", version.ref = "kotlinxCoroutinesVersion" }
+ktor-client-android = { group = "io.ktor", name = "ktor-client-android", version.ref="ktorVersion" }
+ktor-client-core = { group = "io.ktor", name = "ktor-client-core", version.ref="ktorVersion" }
+ktor-client-okhttp = { group = "io.ktor", name = "ktor-client-okhttp", version.ref="ktorVersion" }
 leakcanary-android = { group = "com.squareup.leakcanary", name = "leakcanary-android", version.ref = "leakCanaryVersion" }
 lottie = { group = "com.airbnb.android", name = "lottie", version.ref = "lottieVersion" }
 material = { group = "com.google.android.material", name = "material", version.ref = "androidxMaterialVersion" }

libraries/datasource_ktor/README.md

@@ -0,0 +1,47 @@
+# Ktor DataSource module
+
+This module provides an [HttpDataSource] implementation that uses [Ktor].
+
+Ktor is a multiplatform HTTP client developed by JetBrains. It supports HTTP/2,
+WebSocket, and Kotlin coroutines for asynchronous operations.
+
+[HttpDataSource]: ../datasource/src/main/java/androidx/media3/datasource/HttpDataSource.java
+[Ktor]: https://ktor.io/
+
+## Getting the module
+
+The easiest way to get the module is to add it as a gradle dependency:
+
+```groovy
+implementation 'androidx.media3:media3-datasource-ktor:1.X.X'
+```
+
+where `1.X.X` is the version, which must match the version of the other media
+modules being used.
+
+Alternatively, you can clone this GitHub project and depend on the module
+locally. Instructions for doing this can be found in the [top level README].
+
+[top level README]: ../../README.md
+
+## Using the module
+
+Media components request data through `DataSource` instances. These instances
+are obtained from instances of `DataSource.Factory`, which are instantiated and
+injected from application code.
+
+If your application only needs to play http(s) content, using the Ktor
+extension is as simple as updating any `DataSource.Factory` instantiations in
+your application code to use `KtorDataSource.Factory`. If your application
+also needs to play non-http(s) content such as local files, use:
+```
+new DefaultDataSourceFactory(
+    ...
+    /* baseDataSourceFactory= */ new KtorDataSource.Factory(...));
+```
+
+## Links
+
+*   [Javadoc][]
+
+[Javadoc]: https://developer.android.com/reference/androidx/media3/datasource/ktor/package-summary

libraries/datasource_ktor/build.gradle.kts

@@ -0,0 +1,52 @@
+// Copyright 2026 The Android Open Source Project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+  alias(libs.plugins.android.library)
+  alias(libs.plugins.kotlin.android)
+}
+
+apply(from = "${gradle.extra["androidxMediaSettingsDir"]}/common_config.gradle")
+
+android {
+  namespace = "androidx.media3.datasource.ktor"
+
+  publishing { singleVariant("release") { withSourcesJar() } }
+  kotlin { compilerOptions { jvmTarget.set(JvmTarget.JVM_1_8) } }
+}
+
+dependencies {
+  api(libs.ktor.client.android)
+  api(libs.ktor.client.core)
+  api(project(modulePrefix + "lib-common"))
+  api(project(modulePrefix + "lib-datasource"))
+  implementation(libs.androidx.annotation)
+  compileOnly(libs.errorprone.annotations)
+  compileOnly(libs.checkerframework.qual)
+  compileOnly(libs.kotlin.annotations.jvm)
+  implementation(libs.kotlinx.coroutines.core)
+  androidTestImplementation(project(modulePrefix + "test-utils"))
+  androidTestImplementation(libs.androidx.test.runner)
+  androidTestImplementation(libs.dexmaker.mockito)
+  androidTestImplementation(libs.ktor.client.okhttp)
+  androidTestImplementation(libs.okhttp.mockwebserver)
+  androidTestImplementation(libs.test.parameter.injector)
+}
+
+extra["releaseArtifactId"] = "media3-datasource-ktor"
+
+extra["releaseName"] = "Media3 Ktor DataSource module"
+
+apply(from = "../../publish.gradle")

libraries/datasource_ktor/src/androidTest/AndroidManifest.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright 2026 The Android Open Source Project
+
+     Licensed under the Apache License, Version 2.0 (the "License");
+     you may not use this file except in compliance with the License.
+     You may obtain a copy of the License at
+
+          https://www.apache.org/licenses/LICENSE-2.0
+
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+     See the License for the specific language governing permissions and
+     limitations under the License.
+-->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="androidx.media3.datasource.ktor.test">
+
+  <uses-permission android:name="android.permission.INTERNET"/>
+  <uses-sdk/>
+
+  <application
+    android:usesCleartextTraffic="true" />
+
+  <instrumentation
+    android:targetPackage="androidx.media3.datasource.ktor.test"
+    android:name="androidx.test.runner.AndroidJUnitRunner"/>
+</manifest>

libraries/datasource_ktor/src/androidTest/java/androidx/media3/datasource/ktor/KtorDataSourceContractTest.kt

@@ -0,0 +1,67 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package androidx.media3.datasource.ktor
+
+import androidx.media3.datasource.DataSource
+import androidx.media3.test.utils.DataSourceContractTest
+import androidx.media3.test.utils.HttpDataSourceTestEnv
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import com.google.common.collect.ImmutableList
+import io.ktor.client.HttpClient
+import io.ktor.client.engine.android.Android
+import io.ktor.client.engine.okhttp.OkHttp
+import io.ktor.client.plugins.HttpTimeout
+import org.junit.Rule
+import org.junit.runner.RunWith
+
+@RunWith(AndroidJUnit4::class)
+class KtorDataSourceContractTest : DataSourceContractTest() {
+
+  @JvmField @Rule var httpDataSourceTestEnv = HttpDataSourceTestEnv()
+
+  override fun createDataSources(): List<DataSource> {
+    return listOf(
+      KtorDataSource.Factory(
+          HttpClient(Android) {
+            install(HttpTimeout) {
+              requestTimeoutMillis = 800
+              connectTimeoutMillis = 800
+              socketTimeoutMillis = 800
+            }
+          }
+        )
+        .createDataSource(),
+      KtorDataSource.Factory(
+          HttpClient(OkHttp) {
+            install(HttpTimeout) {
+              requestTimeoutMillis = 800
+              connectTimeoutMillis = 800
+              socketTimeoutMillis = 800
+            }
+          }
+        )
+        .createDataSource(),
+    )
+  }
+
+  override fun getTestResources(): ImmutableList<TestResource> {
+    return httpDataSourceTestEnv.servedResources
+  }
+
+  override fun getNotFoundResources(): MutableList<TestResource> {
+    return httpDataSourceTestEnv.notFoundResources
+  }
+}