Expose ReplayCache as public api

Author: romtsn

sentry-android-replay/api/sentry-android-replay.api

@@ -6,6 +6,29 @@ public final class io/sentry/android/replay/BuildConfig {
 	public fun <init> ()V
 }
 
+public final class io/sentry/android/replay/GeneratedVideo {
+	public fun <init> (Ljava/io/File;IJ)V
+	public final fun component1 ()Ljava/io/File;
+	public final fun component2 ()I
+	public final fun component3 ()J
+	public final fun copy (Ljava/io/File;IJ)Lio/sentry/android/replay/GeneratedVideo;
+	public static synthetic fun copy$default (Lio/sentry/android/replay/GeneratedVideo;Ljava/io/File;IJILjava/lang/Object;)Lio/sentry/android/replay/GeneratedVideo;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getDuration ()J
+	public final fun getFrameCount ()I
+	public final fun getVideo ()Ljava/io/File;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class io/sentry/android/replay/ReplayCache : java/io/Closeable {
+	public fun <init> (Lio/sentry/SentryOptions;Lio/sentry/protocol/SentryId;Lio/sentry/android/replay/ScreenshotRecorderConfig;)V
+	public final fun addFrame (Ljava/io/File;J)V
+	public fun close ()V
+	public final fun createVideoOf (JJILjava/io/File;)Lio/sentry/android/replay/GeneratedVideo;
+	public static synthetic fun createVideoOf$default (Lio/sentry/android/replay/ReplayCache;JJILjava/io/File;ILjava/lang/Object;)Lio/sentry/android/replay/GeneratedVideo;
+}
+
 public final class io/sentry/android/replay/ReplayIntegration : io/sentry/Integration, io/sentry/android/replay/ScreenshotRecorderCallback, java/io/Closeable {
 	public static final field Companion Lio/sentry/android/replay/ReplayIntegration$Companion;
 	public static final field VIDEO_BUFFER_DURATION J
@@ -33,6 +56,24 @@ public abstract interface class io/sentry/android/replay/ScreenshotRecorderCallb
 	public abstract fun onScreenshotRecorded (Landroid/graphics/Bitmap;)V
 }
 
+public final class io/sentry/android/replay/ScreenshotRecorderConfig {
+	public fun <init> (IIFI)V
+	public synthetic fun <init> (IIFIILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public final fun component1 ()I
+	public final fun component2 ()I
+	public final fun component3 ()F
+	public final fun component4 ()I
+	public final fun copy (IIFI)Lio/sentry/android/replay/ScreenshotRecorderConfig;
+	public static synthetic fun copy$default (Lio/sentry/android/replay/ScreenshotRecorderConfig;IIFIILjava/lang/Object;)Lio/sentry/android/replay/ScreenshotRecorderConfig;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getFrameRate ()I
+	public final fun getRecordingHeight ()I
+	public final fun getRecordingWidth ()I
+	public final fun getScaleFactor ()F
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
 public abstract interface class io/sentry/android/replay/video/SimpleFrameMuxer {
 	public abstract fun getVideoTime ()J
 	public abstract fun isStarted ()Z

sentry-android-replay/src/main/java/io/sentry/android/replay/ReplayCache.kt

@@ -13,11 +13,18 @@ import io.sentry.protocol.SentryId
 import java.io.Closeable
 import java.io.File
 
-internal class ReplayCache(
+public class ReplayCache internal constructor(
     private val options: SentryOptions,
     private val replayId: SentryId,
     private val recorderConfig: ScreenshotRecorderConfig,
-    private val encoderCreator: (File) -> SimpleVideoEncoder = { videoFile ->
+    private val encoderCreator: (File) -> SimpleVideoEncoder
+) : Closeable {
+
+    public constructor(
+        options: SentryOptions,
+        replayId: SentryId,
+        recorderConfig: ScreenshotRecorderConfig
+    ) : this(options, replayId, recorderConfig, encoderCreator = { videoFile ->
         SimpleVideoEncoder(
             options,
             MuxerConfig(
@@ -27,11 +34,10 @@ internal class ReplayCache(
                 bitrate = 20 * 1000
             )
         ).also { it.start() }
-    }
-) : Closeable {
+    })
 
     private val encoderLock = Any()
-    internal var encoder: SimpleVideoEncoder? = null
+    private var encoder: SimpleVideoEncoder? = null
 
     internal val replayCacheDir: File? by lazy {
         if (options.cacheDirPath.isNullOrEmpty()) {
@@ -48,7 +54,7 @@ internal class ReplayCache(
     // TODO: maybe account for multi-threaded access
     internal val frames = mutableListOf<ReplayFrame>()
 
-    fun addFrame(bitmap: Bitmap, frameTimestamp: Long) {
+    internal fun addFrame(bitmap: Bitmap, frameTimestamp: Long) {
         if (replayCacheDir == null) {
             return
         }
@@ -61,11 +67,20 @@ internal class ReplayCache(
             it.flush()
         }
 
+        addFrame(screenshot, frameTimestamp)
+    }
+
+    public fun addFrame(screenshot: File, frameTimestamp: Long) {
         val frame = ReplayFrame(screenshot, frameTimestamp)
         frames += frame
     }
 
-    fun createVideoOf(duration: Long, from: Long, segmentId: Int): GeneratedVideo? {
+    public fun createVideoOf(
+        duration: Long,
+        from: Long,
+        segmentId: Int,
+        videoFile: File = File(replayCacheDir, "$segmentId.mp4")
+    ): GeneratedVideo? {
         if (frames.isEmpty()) {
             options.logger.log(
                 DEBUG,
@@ -75,7 +90,6 @@ internal class ReplayCache(
         }
 
         // TODO: reuse instance of encoder and just change file path to create a different muxer
-        val videoFile = File(replayCacheDir, "$segmentId.mp4")
         encoder = synchronized(encoderLock) { encoderCreator(videoFile) }
 
         val step = 1000 / recorderConfig.frameRate.toLong()
@@ -160,7 +174,7 @@ internal data class ReplayFrame(
     val timestamp: Long
 )
 
-internal data class GeneratedVideo(
+public data class GeneratedVideo(
     val video: File,
     val frameCount: Int,
     val duration: Long

sentry-android-replay/src/main/java/io/sentry/android/replay/ScreenshotRecorder.kt

@@ -230,7 +230,7 @@ internal class ScreenshotRecorder(
     }
 }
 
-internal data class ScreenshotRecorderConfig(
+public data class ScreenshotRecorderConfig(
     val recordingWidth: Int,
     val recordingHeight: Int,
     val scaleFactor: Float,