📷 Camera App

Arquitetura

Visão completa da arquitetura do Camera App, padrões utilizados e fluxo de dados.

🏛️ Padrão Arquitetural

A aplicação utiliza MVVM (Model-View-ViewModel) com comunicação reativa via Combine, garantindo:

📊 Diagrama Geral

┌─────────────────────────────────────────────────────────┐
│                    SwiftUI Views                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ ContentView  │  │ Teleprompter │  │ CameraPreview│  │
│  │              │  │   Overlay    │  │     View     │  │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  │
│         │                 │                 │           │
└─────────┼─────────────────┼─────────────────┼───────────┘
          │                 │                 │
          ▼                 ▼                 ▼
┌─────────────────────────────────────────────────────────┐
│                     ViewModels                          │
│  ┌──────────────────────────┐  ┌─────────────────────┐ │
│  │   CameraViewModel        │  │ TeleprompterViewModel│ │
│  │  @Published properties   │  │  @Published props    │ │
│  │  Business logic          │  │  Scroll management   │ │
│  └────────┬─────────────────┘  └─────────────────────┘ │
│           │                                             │
└───────────┼─────────────────────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────────────────────┐
│               Controllers & Services                    │
│  ┌──────────────────────┐  ┌──────────────────────┐    │
│  │ CaptureSession       │  │ SegmentedRecorder    │    │
│  │   Controller         │  │                      │    │
│  │ - Session management │  │ - Recording segments │    │
│  │ - Device config      │  │ - Delegate callbacks │    │
│  │ - Format selection   │  │                      │    │
│  └──────────────────────┘  └──────────────────────┘    │
└─────────────────────────────────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────────────────────┐
│                  AVFoundation                           │
│         AVCaptureSession • AVCaptureDevice              │
│    AVCaptureMovieFileOutput • AVCaptureDeviceInput      │
└─────────────────────────────────────────────────────────┘

📦 Responsabilidades por Camada

1. View (SwiftUI)

Responsabilidades:

Características:

Exemplo:

struct ContentView: View {
    @StateObject private var model = CameraViewModel()
    
    var body: some View {
        ZStack {
            CameraPreviewRepresentable(controller: model.controller)
            
            Button("Record") {
                model.toggleRecording() // Delega para ViewModel
            }
        }
    }
}

2. ViewModel

Responsabilidades:

Características:

Exemplo:

class CameraViewModel: ObservableObject {
    @Published var isRecording: Bool = false
    @Published var segments: [RecordedSegment] = []
    
    private let controller: CaptureSessionController
    private var recorder: SegmentedRecorder?
    
    func toggleRecording() {
        if isRecording {
            recorder?.stopCurrentSegment()
        } else {
            recorder?.startNewSegment()
        }
        isRecording.toggle()
    }
}

3. Controller/Service

Responsabilidades:

Características:

Exemplo:

class CaptureSessionController {
    private let session = AVCaptureSession()
    private let sessionQueue = DispatchQueue(label: "camera.session.queue")
    
    func configureSession(desiredFrameRate: DesiredFrameRate) {
        sessionQueue.async {
            self.session.beginConfiguration()
            // Configuração pesada...
            self.session.commitConfiguration()
        }
    }
}

4. AVFoundation

Responsabilidades:

Características:

🔄 Fluxo de Dados

Fluxo de Inicialização

sequenceDiagram
    participant ContentView
    participant CameraViewModel
    participant Controller
    participant System

    ContentView->>CameraViewModel: .onAppear()
    CameraViewModel->>CameraViewModel: requestPermissionsAndConfigure()
    CameraViewModel->>Controller: requestPermissions()
    Controller->>System: AVCaptureDevice.requestAccess(.video)
    Controller->>System: AVCaptureDevice.requestAccess(.audio)
    System-->>Controller: granted = true
    Controller-->>CameraViewModel: completion(granted: true)
    CameraViewModel->>CameraViewModel: isAuthorized = true
    CameraViewModel->>Controller: configureSession(fps: .fps60)
    Controller->>System: Configure devices and session
    Controller-->>CameraViewModel: completion(error: nil)
    CameraViewModel->>Controller: startSession()
    CameraViewModel-->>ContentView: isSessionRunning = true

Fluxo de Gravação

sequenceDiagram
    participant User
    participant ContentView
    participant CameraViewModel
    participant SegmentedRecorder
    participant AVFoundation
    participant FileSystem

    User->>ContentView: Tap Record Button
    ContentView->>CameraViewModel: toggleRecording()
    CameraViewModel->>SegmentedRecorder: startNewSegment()
    SegmentedRecorder->>FileSystem: Create temp URL
    SegmentedRecorder->>AVFoundation: output.startRecording(to: tempURL)
    AVFoundation-->>SegmentedRecorder: didStartRecordingTo
    SegmentedRecorder-->>CameraViewModel: (recording started)
    CameraViewModel-->>ContentView: isRecording = true
    
    Note over User,AVFoundation: User records...
    
    User->>ContentView: Tap Stop Button
    ContentView->>CameraViewModel: toggleRecording()
    CameraViewModel->>SegmentedRecorder: stopCurrentSegment()
    SegmentedRecorder->>AVFoundation: output.stopRecording()
    AVFoundation-->>SegmentedRecorder: didFinishRecordingTo: URL
    SegmentedRecorder-->>CameraViewModel: delegate.didFinishSegment(url)
    CameraViewModel->>CameraViewModel: Generate thumbnail
    CameraViewModel-->>ContentView: segments.append(segment)

Ver fluxo completo de dados →

🧩 Componentes Principais

CameraViewModel

Papel: ViewModel central da aplicação

Responsabilidades:

Documentação completa →

CaptureSessionController

Papel: Controller de baixo nível para AVFoundation

Responsabilidades:

Documentação completa →

SegmentedRecorder

Papel: Gerenciador de gravação segmentada

Responsabilidades:

Documentação completa →

TeleprompterOverlay

Papel: Componente UI do teleprompter

Responsabilidades:

Documentação completa →

🔀 Dependências entre Módulos

CameraApp (Entry Point)
    └── ContentView
            ├── CameraViewModel
            │       ├── CaptureSessionController
            │       │       └── AVFoundation
            │       └── SegmentedRecorder
            │               └── AVFoundation
            ├── CameraPreviewView (UIKit Bridge)
            │       └── AVCaptureVideoPreviewLayer
            └── TeleprompterOverlay
                    ├── TeleprompterViewModel
                    └── TeleprompterTextView (UIKit Bridge)
                            └── UITextView

Princípio: Dependências fluem para baixo. Views não conhecem Controllers. Controllers não conhecem Views.

🧵 Threading Model

Queues Utilizadas

Queue Propósito Tipo
Main Atualização de UI Serial
sessionQueue Configuração AVCapture Serial
Global(.userInitiated) Thumbnails Concurrent
Global(.utility) Export de vídeo Concurrent

Regras de Threading

⚠️ Crítico

Session Configuration: Sempre na sessionQueue sessionQueue.async {
  session.beginConfiguration()
  // modifications...
  session.commitConfiguration()
}

⚠️ Crítico

UI Updates: Sempre na Main thread DispatchQueue.main.async {
  self.isSessionRunning = true
}

✅ Best Practice

Device Lock: Na sessionQueue com try-catch sessionQueue.async {
  try device.lockForConfiguration()
  device.videoZoomFactor = 2.0
  device.unlockForConfiguration()
}

🎭 Padrões de Design

Observer Pattern

Usado via Combine para reatividade:

@Published var isRecording: Bool = false

View observa automaticamente:

.onChange(of: model.isRecording) { newValue in
    // React to change
}

Delegation Pattern

Usado para callbacks de gravação:

protocol SegmentedRecorderDelegate: AnyObject {
    func recorder(_ recorder: SegmentedRecorder, didFinishSegment url: URL)
    func recorder(_ recorder: SegmentedRecorder, didFailWith error: Error)
}

CameraViewModel implementa:

extension CameraViewModel: SegmentedRecorderDelegate {
    func recorder(_ recorder: SegmentedRecorder, didFinishSegment url: URL) {
        generateThumbnail(for: url)
    }
}

Coordinator Pattern

Usado em UIViewRepresentable bridges:

struct TeleprompterTextView: UIViewRepresentable {
    class Coordinator: NSObject, UITextViewDelegate {
        var isProgrammaticScroll: Bool = false
        
        func scrollViewDidScroll(_ scrollView: UIScrollView) {
            guard !isProgrammaticScroll else { return }
            // Update SwiftUI binding
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
}

🏗️ Arquitetura de Arquivos

Camera/
├── App Layer
│   └── CameraApp.swift                    # Entry point
│
├── View Layer
│   ├── ContentView.swift                  # Main orchestrator
│   ├── CameraPreviewView.swift            # UIKit bridge
│   ├── TeleprompterOverlay.swift          # Teleprompter UI
│   ├── TeleprompterTextView.swift         # UITextView bridge
│   └── GlassCompat.swift                  # Reusable UI components
│
├── ViewModel Layer
│   ├── CameraViewModel.swift              # Main state & logic
│   └── TeleprompterViewModel.swift        # Teleprompter state
│
├── Controller/Service Layer
│   ├── CaptureSessionController.swift     # AVFoundation manager
│   └── SegmentedRecorder.swift            # Recording manager
│
└── Resources
    ├── Assets.xcassets/                   # Visual assets
    └── Camera.entitlements                # Permissions

📏 Princípios Seguidos

Single Responsibility

Cada classe tem uma única responsabilidade clara:

Dependency Inversion

Controllers não conhecem ViewModels. ViewModels conhecem Controllers (injeção de dependência):

class CameraViewModel {
    private let controller: CaptureSessionController
    
    init(controller: CaptureSessionController = .init()) {
        self.controller = controller
    }
}

Open/Closed

Extensível sem modificar código existente. Exemplo: adicionar novos filtros:

enum VideoFilter: String, CaseIterable {
    case none
    case mono
    case sepia  // ← Novo filtro
}

🔍 Próximos Passos

Agora que você entende a arquitetura geral:

  1. Explore os Componentes - Detalhes de cada módulo
  2. Veja o Fluxo de Dados - Como os dados fluem
  3. Entenda as Escolhas Técnicas - Por que essas decisões
← Começando Componentes →