Add resolution for custom video assets

Author: eandreeva-twr

src/content/docs/ios/migration-to-ios-sdk-v4.mdx

@@ -187,11 +187,18 @@ Rename the view, update the configuration parameter, and update any `didSelectPr
 
 ## AdaptyUI custom assets
 
-### AdaptyUICustomVideoAsset.player
+### AdaptyUICustomVideoAsset
 
-If you use custom video assets, replace `AVQueuePlayer` with `AVPlayer`:
+Two changes affect every existing call site:
+
+- `.player` now takes `AVPlayer` instead of `AVQueuePlayer`.
+- Every case gained a trailing `resolution: CGSize?` parameter. Pass `nil` to keep the current behavior, or pass the actual pixel size so the player can reserve layout space (aspect ratio = `width / height`) before the video loads.
 
 ```diff showLineNumbers
+- case file(url: URL, preview: AdaptyUICustomImageAsset?)
+- case remote(url: URL, preview: AdaptyUICustomImageAsset?)
 - case player(item: AVPlayerItem, player: AVQueuePlayer, preview: AdaptyUICustomImageAsset?)
-+ case player(item: AVPlayerItem, player: AVPlayer, preview: AdaptyUICustomImageAsset?)
++ case file(url: URL, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
++ case remote(url: URL, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
++ case player(item: AVPlayerItem, player: AVPlayer, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
 ```

src/content/docs/version-3.0/get-pb-paywalls.mdx

@@ -157,6 +157,7 @@ For example, you can:
 - Show a different image or video to some users.
 - Show a local preview image while a remote main image is loading.
 - Show a preview image before running a video.
+- Provide a video's pixel resolution so the player reserves layout space (aspect ratio = `width / height`) before the video loads. Pass `nil` to skip this.
 
 Here's an example of how you can provide custom assets via a simple dictionary:
 
@@ -175,11 +176,12 @@ let customAssets: [String: AdaptyCustomAsset] = [
         )
     ),
 
-    // Show a local video with a preview image
+    // Show a local video with a preview image and a known resolution
     "hero_video": .video(
         .file(
             url: Bundle.main.url(forResource: "custom_video", withExtension: "mp4")!,
-            preview: .uiImage(value: UIImage(named: "video_preview")!)
+            preview: .uiImage(value: UIImage(named: "video_preview")!),
+            resolution: CGSize(width: 1080, height: 1920)
         )
     ),
 ]