docs(android): Explain unstable replay captures

romtsn · codex · romtsn · commit 24786bff7227 · 2026-06-02T16:22:00.000+02:00
Document why PixelCopyStrategy caps skipped unstable captures so continuous animations keep producing replay frames. Refs GH-5489 Co-Authored-By: Codex <noreply@openai.com>
diff --git a/sentry-android-replay/src/main/java/io/sentry/android/replay/screenshot/PixelCopyStrategy.kt b/sentry-android-replay/src/main/java/io/sentry/android/replay/screenshot/PixelCopyStrategy.kt
@@ -41,6 +41,10 @@ internal class PixelCopyStrategy(
 ) : ScreenshotStrategy {
 
   private companion object {
+    /**
+     * An unstable capture means the view hierarchy changed while PixelCopy was in flight. Cap
+     * skipped unstable captures so continuous animations don't stop replay recording.
+     */
     const val MAX_UNSTABLE_CAPTURES_TO_SKIP = 1
   }
 

Original file line number	Diff line number	Diff line change
`@@ -41,6 +41,10 @@ internal class PixelCopyStrategy(`
`41`	`41`	`) : ScreenshotStrategy {`
`42`	`42`
`43`	`43`	`private companion object {`
	`44`	`+ /**`
	`45`	`+ * An unstable capture means the view hierarchy changed while PixelCopy was in flight. Cap`
	`46`	`+ * skipped unstable captures so continuous animations don't stop replay recording.`
	`47`	`+ */`
`44`	`48`	`const val MAX_UNSTABLE_CAPTURES_TO_SKIP = 1`
`45`	`49`	`}`
`46`	`50`