Skip to content

feat(apple): Update session replay docs with AVFoundation limitation #14700

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 26, 2025
Merged

feat(apple): Update session replay docs with AVFoundation limitation #14700

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d8f89d2
Add known limitations section for AVFoundation views in Session Replay
cursoragent Aug 25, 2025
93d73d8
Update docs/platforms/apple/guides/ios/session-replay/troubleshooting…
philprime Aug 25, 2025
510812e
Merge remote-tracking branch 'origin/master' into cursor/update-sessi…
philprime Aug 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion docs/platforms/apple/guides/ios/session-replay/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,22 @@ notSupported:
description: "Troubleshoot and resolve common issues with the iOS Session Replay."
---

<Expandable title="AVFoundation views and layers are not rendered" permalink>

Session Replay currently cannot capture content from AVFoundation views and layers. This includes:

- `AVPlayerLayer` and other AVFoundation-backed video content
- `AVCaptureVideoPreviewLayer` used for camera previews
- Any media content rendered using AVFoundation components

As a result, camera views, video players, and other AVFoundation-based UI elements will not appear in session replays, even when using `unmaskedViewClasses` configuration.

We are aware of this limitation and are exploring potential solutions to support AVFoundation content in future releases.

You can follow the progress in [this GitHub issue](https://github.com/getsentry/sentry-cocoa/issues/5835).

</Expandable>

<Expandable title="Session Replay is not recording with custom window setup" permalink>

If you have a custom window setup (e.g., multiple instances of `UIWindow`), you need to ensure that the Sentry SDK is able to find the correct window.
Expand Down Expand Up @@ -70,4 +86,4 @@ final class SceneDelegate: NSObject, UIWindowSceneDelegate {
}
```

</Expandable>
</Expandable>