Displaying low-latency connected video

At a glance

Project structure

Source bundle/
└── RealityKit-LowLatencyCameraStreaming/
    ├── Model/
    │   └── AppModel.swift  # ResolutionPreset, AppModel
    ├── CameraCapture/
    │   ├── CameraCoordinator.swift  # CameraCoordinator
    │   └── CameraCaptureSession.swift  # CameraCaptureEvent, CameraError, CameraConfiguration
    ├── Rendering/
    │   └── LowLatencyRenderer.swift  # LowLatencyRenderer, RendererError
    ├── LowLatencyCameraStreamingApp.swift  # LowLatencyCameraStreamingApp
    └── Views/
        ├── CameraTextureRealityView.swift  # CameraTextureRealityView
        └── CameraControlsView.swift  # CameraControlsView

Structure observations

• The runtime boundary is WindowGroup; the tree is pruned to lifecycle, state, framework, rendering, and ECS files.
• The source is Swift; role-named types and feature folders separate the major responsibilities.

Overall architecture

flowchart LR
    LowLatencyCameraStreamingApp_1["LowLatencyCameraStreamingApp"]
    WindowGroup_2["WindowGroup"]
    CameraTextureRealityView_3["CameraTextureRealityView"]
    AppModel_4["AppModel"]
    LowLatencyRenderer_5["LowLatencyRenderer"]
    RealityKit_entity_graph_6["RealityKit entity graph"]
    AV_capture___Metal_shared_texture_7["AV capture + Metal shared texture"]
    LowLatencyCameraStreamingApp_1 --> WindowGroup_2
    WindowGroup_2 --> CameraTextureRealityView_3
    CameraTextureRealityView_3 --> AppModel_4
    AppModel_4 --> LowLatencyRenderer_5
    LowLatencyRenderer_5 --> RealityKit_entity_graph_6
    RealityKit_entity_graph_6 --> AV_capture___Metal_shared_texture_7

Reference code

RealityKit-LowLatencyCameraStreaming/LowLatencyCameraStreamingApp.swift:11 — executable or app-lifecycle anchor.

struct LowLatencyCameraStreamingApp: App {
    // ...
}

The diagram is a responsibility flow, not a claim that every adjacent node directly calls the next. It separates lifecycle, presentation, stable state, framework/session work, and the RealityKit entity graph.

Ownership and state

classDiagram
    LowLatencyCameraStreamingApp *-- AppModel : appModel
    AppModel --> CameraCoordinator : cameraCoordinator
    CameraTextureRealityView o-- AppModel : appModel
    AppModel --> ResolutionPreset : resolution

Ownership evidence

RealityKit-LowLatencyCameraStreaming/LowLatencyCameraStreamingApp.swift:13 — representative stored state or nearest verified lifecycle anchor.

@main
struct LowLatencyCameraStreamingApp: App {
    // ...
    @State private var appModel = AppModel()
    // ...
}

Ownership is intentionally narrow: environment, bindings, observed objects, weak links, and delegate callbacks do not prove lifetime ownership. Initialized stored services and wrapper-managed state do; entities added inside a RealityKit content closure belong to that entity graph.

Class and protocol design

The reviewed source defines no local substitution protocol. Its App, View, delegate, renderer, ARKit, and RealityKit conformances are framework-facing contracts, so this document does not label the whole app protocol-oriented.

Access control

No reviewed Swift access example uses fileprivate, public, open; declarations without a modifier are internal.

Reference code

RealityKit-LowLatencyCameraStreaming/CameraCapture/CameraCoordinator.swift:20 — representative visibility boundary.

    private(set) var renderer: LowLatencyRenderer?

    @ObservationIgnored private var eventTask: Task<Void, Never>?

    var isStereo: Bool = false

Logic ownership and placement

Design patterns

Naming conventions

• Role suffixes are evidence, not decoration: App: LowLatencyCameraStreamingApp; Model: AppModel; Coordinator: CameraCoordinator; Session: CameraCaptureSession; Renderer: LowLatencyRenderer.
• Protocols: no app-defined protocol in the reviewed source.
• Commands use verb-led methods: observeDeviceChanges, handleDeviceRemoved, createCameraFeedTexture, enableCamera, disableCamera, start, stop, startObservingEvents.
• Files and folders use primary-type or responsibility names such as Views, Models, Rendering, Components, Systems, Packages, or feature names where those boundaries exist.

Architecture takeaways

• Treat LowLatencyCameraStreamingApp as the owner of executable or scene lifecycle, not automatically as the owner of every entity created later.
• Keep view/controller input near presentation, but move sessions, reconstruction, capture, rendering, shared game state, or documents into stable owners when their lifetime exceeds one callback or render pass.
• Tie asynchronous session/output consumers to an explicit owner so cancellation and teardown follow the same lifecycle.

Source map

• Official Apple documentation