Element Call ringing notifications (#2978)

- Add `ActiveCallManager` to handle incoming and ongoing calls.
- Add ringing call notifications with full screen intents and missed call ones as part of the 'conversation' notifications.

---------

Co-authored-by: ElementBot <benoitm+elementbot@element.io>

libraries/push/api/build.gradle.kts

@@ -24,6 +24,7 @@ android {
 dependencies {
     implementation(libs.androidx.corektx)
     implementation(libs.coroutines.core)
+    implementation(libs.coil.compose)
     implementation(projects.libraries.matrix.api)
     implementation(projects.libraries.pushproviders.api)
 }

libraries/push/api/src/main/kotlin/io/element/android/libraries/push/api/notifications/NotificationBitmapLoader.kt

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2024 New Vector Ltd
+ *
+ * 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.element.android.libraries.push.api.notifications
+
+import android.graphics.Bitmap
+import androidx.core.graphics.drawable.IconCompat
+import coil.ImageLoader
+
+interface NotificationBitmapLoader {
+    /**
+     * Get icon of a room.
+     * @param path mxc url
+     * @param imageLoader Coil image loader
+     */
+    suspend fun getRoomBitmap(path: String?, imageLoader: ImageLoader): Bitmap?
+
+    /**
+     * Get icon of a user.
+     * Before Android P, this does nothing because the icon won't be used
+     * @param path mxc url
+     * @param imageLoader Coil image loader
+     */
+    suspend fun getUserIcon(path: String?, imageLoader: ImageLoader): IconCompat?
+}

libraries/push/api/src/main/kotlin/io/element/android/libraries/push/api/notifications/NotificationIdProvider.kt

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2024 New Vector Ltd
+ *
+ * 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.element.android.libraries.push.api.notifications
+
+import io.element.android.libraries.matrix.api.core.SessionId
+import kotlin.math.abs
+
+object NotificationIdProvider {
+    fun getSummaryNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + SUMMARY_NOTIFICATION_ID
+    }
+
+    fun getRoomMessagesNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + ROOM_MESSAGES_NOTIFICATION_ID
+    }
+
+    fun getRoomEventNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + ROOM_EVENT_NOTIFICATION_ID
+    }
+
+    fun getRoomInvitationNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + ROOM_INVITATION_NOTIFICATION_ID
+    }
+
+    fun getFallbackNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + FALLBACK_NOTIFICATION_ID
+    }
+
+    fun getCallNotificationId(sessionId: SessionId): Int {
+        return getOffset(sessionId) + ROOM_CALL_NOTIFICATION_ID
+    }
+
+    fun getForegroundServiceNotificationId(type: ForegroundServiceType): Int {
+        return type.id * 10 + FOREGROUND_SERVICE_NOTIFICATION_ID
+    }
+
+    private fun getOffset(sessionId: SessionId): Int {
+        // Compute a int from a string with a low risk of collision.
+        return abs(sessionId.value.hashCode() % 100_000) * 10
+    }
+
+    private const val FALLBACK_NOTIFICATION_ID = -1
+    private const val SUMMARY_NOTIFICATION_ID = 0
+    private const val ROOM_MESSAGES_NOTIFICATION_ID = 1
+    private const val ROOM_EVENT_NOTIFICATION_ID = 2
+    private const val ROOM_INVITATION_NOTIFICATION_ID = 3
+    private const val ROOM_CALL_NOTIFICATION_ID = 3
+
+    private const val FOREGROUND_SERVICE_NOTIFICATION_ID = 4
+}
+
+enum class ForegroundServiceType(val id: Int) {
+    INCOMING_CALL(1),
+    ONGOING_CALL(2),
+}

libraries/push/api/src/main/kotlin/io/element/android/libraries/push/api/notifications/OnMissedCallNotificationHandler.kt

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2024 New Vector Ltd
+ *
+ * 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.element.android.libraries.push.api.notifications
+
+import io.element.android.libraries.matrix.api.core.EventId
+import io.element.android.libraries.matrix.api.core.RoomId
+import io.element.android.libraries.matrix.api.core.SessionId
+
+/**
+ * Handles missed calls by creating a new notification.
+ */
+interface OnMissedCallNotificationHandler {
+    /**
+     * Adds a missed call notification.
+     */
+    suspend fun addMissedCallNotification(
+        sessionId: SessionId,
+        roomId: RoomId,
+        eventId: EventId,
+    )
+}