Custom Paused Ads

// Create a session for the event
StreamLayer.createSession(for: "your-event-id")

private var pausedAdWorkItem: DispatchWorkItem?

func handlePlayingState() {
    pausedAdWorkItem?.cancel()
    pausedAdWorkItem = nil
    StreamLayer.hidePausedAd()
}

func handlePausedState() {
    let workItem = DispatchWorkItem { [weak self] in
        guard self?.pausedAdWorkItem?.isCancelled == false else { return }
        self?.presentPausedAd()
    }
    DispatchQueue.main.asyncAfter(deadline: .now() + 5, execute: workItem)
    self.pausedAdWorkItem = workItem
}

private func presentPausedAd() {
    // Pick whichever pause-ad type fits your inventory — see "Displaying a Custom Pause Ad" below
    let vastURL = URL(string: "https://example.com/vast.xml")!
    StreamLayer.showPausedAd(.transparentBackgroundVAST(
        vastTagURL: vastURL,
        resumeButton: .hidden
    ))
}

func handlePausedState() {
    // Show a fullscreen pause ad with custom configuration
    let config = SLRPausedAdConfiguration(
        title: "Sponsored Content",
        body: "Check out our latest offers",
        sponsorLogo: UIImage(named: "sponsor_logo"),
        backgroundImage: UIImage(named: "ad_background")
    )
    StreamLayer.showPausedAd(.fullScreen(configuration: config))
}

func handlePausedState() {
    // Direct creative URL
    let adURL = URL(string: "https://example.com/pause-ad.html")!
    StreamLayer.showPausedAd(.transparentBackground(
        url: adURL,
        resumeButton: .hidden,
        bypassTouches: false
    ))

    // Or let the bell-ad proxy resolve an ad-server slot
    StreamLayer.showPausedAd(.transparentBackground(
        slot: "/12345/pause_ad_ctv",
        resumeButton: .hidden
    ))
}

func handlePausedState() {
    let vastURL = URL(string: "https://example.com/vast.xml")!
    StreamLayer.showPausedAd(.transparentBackgroundVAST(
        vastTagURL: vastURL,
        resumeButton: .hidden,
        bypassTouches: false
    ))
}

/// Configuration for the resume button displayed on transparent background paused ads
public struct SLRResumeButtonConfiguration {
    /// Button content type
    public enum Content {
        /// Display resume button with a custom image and size
        case image(UIImage, size: CGSize)

        /// Display resume button with custom text
        case text(String)

        /// Hide the resume button completely
        case hidden
    }

    /// Predefined positions for the resume button
    public enum Position {
        case topLeft(insets: UIEdgeInsets)
        case topRight(insets: UIEdgeInsets)
        case bottomLeft(insets: UIEdgeInsets)
        case bottomRight(insets: UIEdgeInsets)
        case center
        case custom((UIView, UIView) -> Void) // Custom closure for complete control

        /// Default position for landscape iPad
        public static var defaultLandscape: Position

        /// Default position for portrait iPad/iPhone
        public static var defaultPortrait: Position
    }

    public let content: Content
    public let position: Position
}

let vastURL = URL(string: "https://example.com/vast.xml")!

// Default position with custom image
let config = SLRResumeButtonConfiguration.image(
    UIImage(named: "play_button")!,
    size: CGSize(width: 100, height: 100)
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: config))

// Default position with text
let textConfig = SLRResumeButtonConfiguration.text("RESUME")
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: textConfig))

// Hidden button
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: .hidden))

// Top-left corner
let topLeftConfig = SLRResumeButtonConfiguration(
    content: .text("RESUME"),
    position: .topLeft(insets: UIEdgeInsets(top: 60, left: 80, bottom: 0, right: 0))
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: topLeftConfig))

// Top-right corner
let topRightConfig = SLRResumeButtonConfiguration.image(
    UIImage(systemName: "play.circle.fill")!,
    size: CGSize(width: 80, height: 80),
    position: .topRight(insets: UIEdgeInsets(top: 60, left: 0, bottom: 0, right: 80))
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: topRightConfig))

// Bottom-right corner
let bottomRightConfig = SLRResumeButtonConfiguration(
    content: .text("Continue"),
    position: .bottomRight(insets: UIEdgeInsets(top: 0, left: 0, bottom: 80, right: 80))
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: bottomRightConfig))

// Center of screen
let centerConfig = SLRResumeButtonConfiguration.text(
    "Resume Video",
    position: .center
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: centerConfig))

let customConfig = SLRResumeButtonConfiguration(
    content: .image(playIcon, size: CGSize(width: 100, height: 100)),
    position: .custom { button, containerView in
        // Apply SnapKit constraints
        button.snp.makeConstraints { make in
            make.trailing.equalToSuperview().offset(-150)
            make.centerY.equalToSuperview().offset(50)
            make.width.height.equalTo(100)
        }

        // Optional: Add custom styling
        button.layer.cornerRadius = 50
        button.layer.shadowColor = UIColor.black.cgColor
        button.layer.shadowOpacity = 0.3
        button.layer.shadowOffset = CGSize(width: 0, height: 4)
        button.layer.shadowRadius = 8
        button.backgroundColor = UIColor.white.withAlphaComponent(0.2)
    }
)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: customConfig))

// Hide the button (user can tap anywhere to resume on iOS)
StreamLayer.showPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL, resumeButton: .hidden))

// Allow the host app's player controls to remain interactive while the ad is shown
StreamLayer.showPausedAd(.transparentBackgroundVAST(
    vastTagURL: vastURL,
    resumeButton: .hidden,
    bypassTouches: true
))

/// Prefetches a paused ad by parsing the VAST tag URL and downloading any associated images.
///
/// The prefetching process includes:
/// - Parsing the VAST tag XML
/// - Downloading and caching any images referenced in the VAST response
/// - Validating the ad content
/// - Caching with automatic expiration after the specified interval
///
/// - Parameters:
///   - adType: The type of paused ad to prefetch
///   - expirationInterval: Time in seconds after which the cached ad expires (default: 3600 = 1 hour)
///   - completion: A completion handler called when prefetching completes
public class func prefetchPausedAd(
    _ adType: SLRPausedAdType,
    expirationInterval: TimeInterval = 3600,
    completion: @escaping (Swift.Result<Void, Error>) -> Void
)

// Prefetch a VAST pause ad with default 1-hour expiration
let vastURL = URL(string: "https://example.com/vast.xml")!
StreamLayer.prefetchPausedAd(.transparentBackgroundVAST(vastTagURL: vastURL)) { result in
    switch result {
    case .success:
        print("Ad cached for 1 hour")
    case .failure(let error):
        print("Prefetch failed: \(error)")
    }
}

// Prefetch with custom 30-minute expiration
StreamLayer.prefetchPausedAd(
    .transparentBackgroundVAST(vastTagURL: vastURL),
    expirationInterval: 1800
) { result in
    print("Ad cached for 30 minutes")
}

// Prefetch with no expiration (cache until manually cleared)
StreamLayer.prefetchPausedAd(
    .transparentBackgroundVAST(vastTagURL: vastURL),
    expirationInterval: .infinity
) { result in
    print("Ad cached indefinitely")
}

// Prefetch fullscreen ad with configuration (and optional VAST hydration)
let config = SLRPausedAdConfiguration(
    title: "Sponsored Content",
    body: "Check out our latest offers",
    sponsorLogo: UIImage(named: "sponsor_logo"),
    backgroundImage: UIImage(named: "ad_background"),
    vastTagURL: URL(string: "https://example.com/vast.xml")
)
StreamLayer.prefetchPausedAd(.fullScreen(configuration: config)) { result in
    switch result {
    case .success:
        print("Fullscreen ad prefetched successfully")
    case .failure(let error):
        print("Prefetch failed: \(error)")
    }
}

/// Clears all prefetched paused ad data from memory.
///
/// Use this method to free up memory by removing cached ad content.
///
/// - Note: This only clears the in-memory cache. The underlying image cache managed by
///   the image loading system is not affected.
public class func clearPrefetchedPausedAds()

// Clear prefetched ads when the user navigates away or to free up memory
StreamLayer.clearPrefetchedPausedAds()

extension YourViewController: SLROverlayDelegate {
    func playVideo(_ userInitiated: Bool) {
        // Resume video playback
        player.play()

        // Cancel any pending ad display
        pausedAdWorkItem?.cancel()
        pausedAdWorkItem = nil
    }
}

/// Manually dismisses the currently displayed paused ad.
///
/// Use this method to programmatically hide a paused ad that is currently being shown.
/// This is useful when you need to dismiss the ad based on custom logic or user actions
/// outside of the standard resume/play button.
///
/// - Note: This method has no effect if no paused ad is currently displayed.
/// - Note: iOS SDK - This feature is only available on iPad. Calling this method on iPhone will have no effect.
public class func hidePausedAd()

// Dismiss the ad when receiving a specific notification
NotificationCenter.default.addObserver(forName: .userDidPerformAction, object: nil, queue: .main) { _ in
    StreamLayer.hidePausedAd()
}

// Dismiss the ad after a timeout
DispatchQueue.main.asyncAfter(deadline: .now() + 30) {
    StreamLayer.hidePausedAd()
}

// Dismiss the ad based on custom business logic
func handleCustomEvent() {
    if shouldDismissAd {
        StreamLayer.hidePausedAd()
        player.play()
    }
}