# ivanmurzak/unity-audioloader architecture

> Architecture diagram of the GitHub repository ivanmurzak/unity-audioloader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ivanmurzak/unity-audioloader
- Repository: https://github.com/ivanmurzak/unity-audioloader

## Overview

Audio Loader is a Unity runtime library for asynchronously loading audio from local or web locations, caching it in memory and on disk, and optionally assigning it to AudioSource components. The documented workflow starts with main-thread initialization, then a load request checks memory before disk and loads from the requested source if needed; concurrent requests for the same audio wait for the same load. The graph reflects README-documented behavior only: source excerpts were unavailable, so internal call ownership and finer implementation details cannot be verified.

Main entry points: [`Unity-Package/Assets/root/Runtime/AudioLoader.cs`](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.cs) (Audio loader), [`Unity-Package/Assets/root/Runtime/AudioLoader.AudioSource.cs`](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.AudioSource.cs) (AudioSource adapter), [`Unity-Package/Assets/root/Runtime/AudioLoader.MemoryCache.cs`](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.MemoryCache.cs) (Memory cache), [`Unity-Package/Assets/root/Runtime/AudioLoader.DiskCache.cs`](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.DiskCache.cs) (Disk cache)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_loading["Audio loading"]
  node_init["Initialization<br/>[AudioLoader.cs]"]
  node_loader["Audio loader<br/>[AudioLoader.cs]"]
  node_source["Audio source"]
  node_settings["Loader settings"]
end

subgraph group_cache["Audio caches"]
  node_memory[("Memory cache")]
  node_disk[("Disk cache")]
  node_diskthread["Disk worker"]
end

subgraph group_integration["Unity integration"]
  node_audiooutput["AudioSource adapter"]
end

node_caller(("Unity app"))
node_unityaudio["Unity AudioSource"]

node_caller -->|"initializes on main thread"| node_init
node_caller -->|"requests audio"| node_loader
node_loader -->|"uses configuration"| node_settings
node_loader -->|"checks first"| node_memory
node_loader -->|"checks next"| node_disk
node_loader -->|"loads on cache miss"| node_source
node_source -->|"returns audio"| node_loader
node_loader -->|"uses disk worker"| node_diskthread
node_caller -->|"requests assignment"| node_audiooutput
node_audiooutput -->|"sets clip"| node_unityaudio
node_caller -->|"manages cache"| node_memory
node_caller -->|"manages cache"| node_disk

click node_init "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.cs"
click node_loader "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.cs"
click node_settings "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.Settings.cs"
click node_memory "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.MemoryCache.cs"
click node_disk "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.DiskCache.cs"
click node_diskthread "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/LimitedConcurrencyLevelTaskScheduler.cs"
click node_audiooutput "https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.AudioSource.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_init,node_loader,node_source,node_settings toneBlue
class node_memory,node_disk,node_diskthread toneAmber
class node_audiooutput toneMint
class node_caller,node_unityaudio toneIndigo
```

## Components

### Audio loading

- [Initialization](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.cs`
- [Audio loader](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.cs`
- **Audio source**
- [Loader settings](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.Settings.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.Settings.cs`

### Audio caches

- [Memory cache](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.MemoryCache.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.MemoryCache.cs`
- [Disk cache](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.DiskCache.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.DiskCache.cs`
- [Disk worker](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/LimitedConcurrencyLevelTaskScheduler.cs): `Unity-Package/Assets/root/Runtime/LimitedConcurrencyLevelTaskScheduler.cs`

### Unity integration

- [AudioSource adapter](https://github.com/ivanmurzak/unity-audioloader/blob/main/Unity-Package/Assets/root/Runtime/AudioLoader.AudioSource.cs): `Unity-Package/Assets/root/Runtime/AudioLoader.AudioSource.cs`

### Other components

- **Unity app**
- **Unity AudioSource**

## Connections

- Unity app → Initialization: initializes on main thread (evidence: `README.md`)
- Unity app → Audio loader: requests audio (evidence: `README.md`)
- Audio loader → Loader settings: uses configuration (evidence: `README.md`)
- Audio loader → Memory cache: checks first (evidence: `README.md`)
- Audio loader → Disk cache: checks next (evidence: `README.md`)
- Audio loader → Audio source: loads on cache miss (evidence: `README.md`)
- Audio source → Audio loader: returns audio (evidence: `README.md`)
- Audio loader → Disk worker: uses disk worker (evidence: `README.md`)
- Unity app → AudioSource adapter: requests assignment (evidence: `README.md`)
- AudioSource adapter → Unity AudioSource: sets clip (evidence: `README.md`)
- Unity app → Memory cache: manages cache (evidence: `README.md`)
- Unity app → Disk cache: manages cache (evidence: `README.md`)
