duckplayer

DuckPlayer Implementation Guide

Overview

DuckPlayer provides video playback within the app, separate from the web view-based player. The architecture separates concerns into distinct components using a presenter pattern, native UI views, and JavaScript integration for seamless video playback experiences.

Architecture Components

Core Architecture Pattern

DuckPlayer follows a presenter-driven architecture with clear separation of concerns:

// ✅ CORRECT - Presenter coordinates between components
final class DuckPlayerNativeUIPresenter {
    private let navigationHandler: NativeDuckPlayerNavigationHandler
    private let state: DuckPlayerState
    private let pixelFiring: DuckPlayerPixelFiring
    
    func presentPlayer(for videoID: String) {
        // Coordinates pill presentation, player setup, and analytics
        updateState(videoID: videoID)
        configurePillType()
        firePixels()
    }
}

// ❌ INCORRECT - Don't manage all responsibilities in one view
struct DuckPlayerView: View {
    @State private var videoID: String = ""
    @State private var isPresented = false
    // Don't handle navigation, state, and analytics directly in views
}

State Management Pattern

Use DuckPlayerState for centralized video state management:

// ✅ CORRECT - Centralized state management
final class DuckPlayerState {
    var videoID: String?
    var hasBeenShown: Bool = false
    var timestamp: TimeInterval?
    
    func reset() {
        videoID = nil
        hasBeenShown = false
        timestamp = nil
    }
}

// ❌ INCORRECT - Scattered state across components
struct DuckPlayerView: View {
    @State private var videoID: String = ""
    @State private var timestamp: TimeInterval = 0
    // Don't duplicate state management
}

Component Responsibilities

DuckPlayerNativeUIPresenter

Role: Primary coordinator and state manager for the Native UI

Key Responsibilities:

• Manages presentation lifecycle of player UI components
• Coordinates between pill types (welcome, entry, re-entry)
• Handles user interactions and navigation events
• Manages constraint updates and visibility state
• Integrates with app navigation and browser features
• Handles orientation changes and UI adaptations
• Manages pixel firing for analytics tracking
• Controls toast notifications and dismiss count tracking