feat: e2ee data channel

.changeset/nasty-kids-fail.md

@@ -0,0 +1,8 @@
+---
+"client-sdk-android": minor
+---
+
+End to end encryption for data channels option
+
+* Added EncryptionType fields to DataReceived events and StreamInfo objects to indicate the
+  encryption status.

gradle/libs.versions.toml

@@ -1,5 +1,5 @@
 [versions]
-webrtc = "137.7151.03"
+webrtc = "137.7151.04"
 
 androidJainSipRi = "1.3.0-91"
 androidx-activity = "1.9.0"

livekit-android-sdk/src/main/java/io/livekit/android/dagger/RTCModule.kt

@@ -33,6 +33,8 @@ import io.livekit.android.audio.AudioRecordSamplesDispatcher
 import io.livekit.android.audio.CommunicationWorkaround
 import io.livekit.android.audio.JavaAudioRecordPrewarmer
 import io.livekit.android.audio.NoAudioRecordPrewarmer
+import io.livekit.android.e2ee.DataPacketCryptorManager
+import io.livekit.android.e2ee.DataPacketCryptorManagerImpl
 import io.livekit.android.memory.CloseableManager
 import io.livekit.android.util.LKLog
 import io.livekit.android.util.LoggingLevel
@@ -373,6 +375,11 @@ internal object RTCModule {
         }!!
     }
 
+    @Provides
+    fun dataPacketCryptorManagerFactory(): DataPacketCryptorManager.Factory {
+        return DataPacketCryptorManagerImpl.Factory
+    }
+
     @Provides
     @Singleton
     fun peerConnectionFactory(

livekit-android-sdk/src/main/java/io/livekit/android/e2ee/DataPacketCryptorManager.kt

@@ -0,0 +1,129 @@
+/*
+ * Copyright 2025 LiveKit, Inc.
+ *
+ * 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
+ *
+ *     http://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 io.livekit.android.e2ee
+
+import io.livekit.android.room.participant.Participant
+import io.livekit.android.util.LKLog
+import livekit.LivekitModels
+import livekit.org.webrtc.DataPacketCryptor
+import livekit.org.webrtc.DataPacketCryptorFactory
+import livekit.org.webrtc.FrameCryptorAlgorithm
+
+/**
+ * @suppress
+ */
+interface DataPacketCryptorManager {
+    fun encrypt(participantId: Participant.Identity, keyIndex: Int, payload: ByteArray): EncryptedPacket?
+    fun decrypt(participantId: Participant.Identity, packet: EncryptedPacket): ByteArray?
+    fun dispose()
+
+    interface Factory {
+        fun create(keyProvider: KeyProvider): DataPacketCryptorManager
+    }
+}
+
+/**
+ * @suppress
+ */
+class EncryptedPacket(
+    val payload: ByteArray,
+    val iv: ByteArray,
+    val keyIndex: Int,
+)
+
+/**
+ * @suppress
+ */
+fun LivekitModels.EncryptedPacket.toSdkType() =
+    EncryptedPacket(
+        payload = this.encryptedValue.toByteArray(),
+        iv = this.iv.toByteArray(),
+        keyIndex = this.keyIndex,
+    )
+
+internal class DataPacketCryptorManagerImpl(
+    keyProvider: KeyProvider,
+) : DataPacketCryptorManager {
+    var isDisposed = false
+    private val dataPacketCryptor: DataPacketCryptor = DataPacketCryptorFactory.createDataPacketCryptor(FrameCryptorAlgorithm.AES_GCM, keyProvider.rtcKeyProvider)
+
+    @Synchronized
+    override fun encrypt(participantId: Participant.Identity, keyIndex: Int, payload: ByteArray): EncryptedPacket? {
+        if (isDisposed) {
+            return null
+        }
+        val packet = dataPacketCryptor.encrypt(
+            participantId.value,
+            keyIndex,
+            payload,
+        )
+
+        if (packet == null) {
+            LKLog.i { "Error encrypting packet: null packet" }
+            return null
+        }
+
+        val payload = packet.payload
+        val iv = packet.iv
+        val keyIndex = packet.keyIndex
+
+        if (payload == null) {
+            LKLog.w { "Error encrypting packet: null payload" }
+            return null
+        }
+        if (iv == null) {
+            LKLog.i { "Error encrypting packet: null iv returned" }
+            return null
+        }
+
+        return EncryptedPacket(
+            payload = payload,
+            iv = iv,
+            keyIndex = keyIndex,
+        )
+    }
+
+    @Synchronized
+    override fun decrypt(participantId: Participant.Identity, packet: EncryptedPacket): ByteArray? {
+        if (isDisposed) {
+            return null
+        }
+        return dataPacketCryptor.decrypt(
+            participantId.value,
+            DataPacketCryptor.EncryptedPacket(
+                packet.payload,
+                packet.iv,
+                packet.keyIndex,
+            ),
+        )
+    }
+
+    @Synchronized
+    override fun dispose() {
+        if (isDisposed) {
+            return
+        }
+        isDisposed = true
+        dataPacketCryptor.dispose()
+    }
+
+    object Factory : DataPacketCryptorManager.Factory {
+        override fun create(keyProvider: KeyProvider): DataPacketCryptorManager {
+            return DataPacketCryptorManagerImpl(keyProvider)
+        }
+    }
+}