First Commit

libraries/audio/api/build.gradle.kts

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2025 New Vector Ltd.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+ * Please see LICENSE files in the repository root for full details.
+ */
+plugins {
+    id("io.element.android-library")
+}
+
+android {
+    namespace = "io.element.android.libraries.audio.api"
+}

libraries/audio/api/src/main/kotlin/io/element/android/libraries/audio/api/AudioFocus.kt

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2025 New Vector Ltd.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+ * Please see LICENSE files in the repository root for full details.
+ */
+
+package io.element.android.libraries.audio.api
+
+enum class AudioFocusRequester {
+    ElementCall,
+    VoiceMessage,
+    MediaViewer,
+}
+
+interface AudioFocus {
+    /**
+     * Request audio focus for the given requester.
+     * @param requester The mode for which to request audio focus.
+     * @param onFocusLost Callback to be invoked when the audio focus is lost.
+     * @return true if the audio focus was successfully requested, false otherwise.
+     */
+    fun requestAudioFocus(
+        requester: AudioFocusRequester,
+        onFocusLost: () -> Unit,
+    )
+
+    /**
+     * Release the audio focus.
+     */
+    fun releaseAudioFocus()
+}