chore(apple): Add docs about photo picker and masking view controllers (#15656)

Author: philprime

docs/platforms/apple/common/session-replay/customredact.mdx

@@ -28,6 +28,12 @@ By default, our Session Replay SDK masks all text content, images, and user inpu
 
 You can choose which type of view you want to mask or unmask by using the `maskedViewClasses` or `unmaskedViewClasses` options.
 
+<Alert level="info">
+
+Custom masking only works with subclasses of `UIView`. You cannot mask or unmask `UIViewController` classes or other non-view types. If you need to mask content within a view controller, you should target the specific `UIView` instances instead.
+
+</Alert>
+
 Let's say you have a custom view that you want to mask and a `UILabel` subclass (which normally would be masked) that you don't want to mask. You can set the options like this:
 
 ```swift

docs/platforms/apple/common/session-replay/troubleshooting.mdx

@@ -85,6 +85,15 @@ You can follow the progress in [this GitHub issue](https://github.com/getsentry/
 
 </Expandable>
 
+<Expandable title="Photo pickers and camera views are not captured" permalink>
+
+Session Replay cannot capture photo picker interfaces (`PHPickerViewController` and `UIImagePickerController`) or camera views due to iOS limitations. These pickers use a remote view rendering process rather than being rendered directly in your app's view hierarchy.
+
+On physical devices, photo pickers and camera views will not appear in session replays. On simulators, they may appear because simulators don't use the same remote rendering approach, but this behavior should not be relied upon.
+
+This limitation exists at the iOS system level and cannot be worked around by configuring `unmaskedViewClasses` or other Session Replay settings.
+</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.