NET Network Synchronization

using OwnaudioNET;

// Initialize audio system
await OwnaudioNet.InitializeAsync();
OwnaudioNet.Start();

// Start as network sync server
await OwnaudioNet.StartNetworkSyncServerAsync(
    port: 9876,
    useLocalTimeOnly: true);  // No internet required!

// Get mixer and add tracks
var mixer = OwnaudioNet.GetAudioMixer();
var track = new FileSource("song.mp3");
track.AttachToClock(mixer.MasterClock);
mixer.AddSource(track);

// All commands are automatically broadcast to clients
track.Play();   // All clients start playing
track.Pause();  // All clients pause
track.Seek(30); // All clients seek to 30 seconds

// Monitor connected clients
var status = OwnaudioNet.GetNetworkSyncStatus();
Console.WriteLine($"Connected clients: {status.ClientCount}");

using OwnaudioNET;

// Initialize audio system
await OwnaudioNet.InitializeAsync();
OwnaudioNet.Start();

// Connect to server (auto-discovery or manual IP)
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: "192.168.1.100",  // Or null for auto-discovery
    port: 9876,
    allowOfflinePlayback: true);     // Continue if disconnected

// Add SAME tracks as server
var mixer = OwnaudioNet.GetAudioMixer();
var track = new FileSource("song.mp3");  // Same file as server!
track.AttachToClock(mixer.MasterClock);
mixer.AddSource(track);

// Client automatically follows server commands
// No manual control needed!

// Monitor connection state
OwnaudioNet.NetworkSyncConnectionChanged += (sender, e) =>
{
    Console.WriteLine($"Connection: {e.NewState}");
    
    if (e.NewState == ConnectionState.Synced)
        Console.WriteLine("✅ Synchronized with server!");
    else if (e.NewState == ConnectionState.Disconnected)
        Console.WriteLine("⚠️ Disconnected - playing standalone");
};

// Start server with custom port
await OwnaudioNet.StartNetworkSyncServerAsync(
    port: 9876,                  // UDP port (default: 9876)
    useLocalTimeOnly: true);     // Use local time sync only

// Server is now broadcasting at 100Hz (10ms interval)

// All FileSource commands are automatically broadcast
var track = new FileSource("music.mp3");
track.AttachToClock(mixer.MasterClock);
mixer.AddSource(track);

// These commands are broadcast to all clients:
track.Play();           // Start playback
track.Pause();          // Pause playback
track.Stop();           // Stop playback
track.Seek(45.0);       // Seek to 45 seconds
track.Tempo = 1.2f;     // Set tempo to 120%

// Manual command broadcasting (advanced)
var cmd = NetworkSyncProtocol.CreatePlayCommand(
    ntpTimestamp: DateTime.UtcNow.Ticks,
    scheduledExecutionTime: DateTime.UtcNow.AddMilliseconds(100).Ticks,
    startPosition: 0.0);

OwnaudioNet.BroadcastCommand(ref cmd);

// Get server status
var status = OwnaudioNet.GetNetworkSyncStatus();

if (status.IsServer)
{
    Console.WriteLine($"Server running");
    Console.WriteLine($"Connected clients: {status.ClientCount}");
    Console.WriteLine($"Time sync tier: {status.TimeSyncTier}");
}

// Client connection events
// (Events are raised on the server when clients connect/disconnect)
// Note: Currently implemented in NetworkSyncServer class

// Option 1: Auto-discovery (recommended)
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: null,             // Auto-discover server
    port: 9876,
    allowOfflinePlayback: true);

// Option 2: Manual IP address
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: "192.168.1.100",  // Specific server IP
    port: 9876,
    allowOfflinePlayback: true);

// Option 3: Hostname
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: "audio-server.local",
    port: 9876,
    allowOfflinePlayback: true);

// Monitor connection state changes
OwnaudioNet.NetworkSyncConnectionChanged += (sender, e) =>
{
    switch (e.NewState)
    {
        case ConnectionState.Disconnected:
            Console.WriteLine("⚠️ Disconnected from server");
            Console.WriteLine("   Continuing playback in standalone mode");
            // Client automatically continues playing
            break;
            
        case ConnectionState.Connecting:
            Console.WriteLine("🔄 Reconnecting to server...");
            break;
            
        case ConnectionState.Connected:
            Console.WriteLine("✅ Connected to server");
            break;
            
        case ConnectionState.Synced:
            Console.WriteLine("🎵 Synchronized with server!");
            var status = OwnaudioNet.GetNetworkSyncStatus();
            Console.WriteLine($"   Latency: {status.AverageLatency:F2}ms");
            break;
    }
};

// Check if local control is allowed
if (OwnaudioNet.IsNetworkSyncLocalControlAllowed())
{
    // Can control playback locally (disconnected)
    track.Play();
    track.Seek(60);
}
else
{
    // Server is controlling playback
    Console.WriteLine("Server is in control");
}

// Living Room (Server - Main Control)
await OwnaudioNet.StartNetworkSyncServerAsync();
var livingRoomTrack = new FileSource("party-mix.mp3");
mixer.AddSource(livingRoomTrack);
livingRoomTrack.Play();

// Kitchen (Client)
await OwnaudioNet.StartNetworkSyncClientAsync();
var kitchenTrack = new FileSource("party-mix.mp3");
mixer.AddSource(kitchenTrack);
// Automatically follows living room

// Bedroom (Client)
await OwnaudioNet.StartNetworkSyncClientAsync();
var bedroomTrack = new FileSource("party-mix.mp3");
mixer.AddSource(bedroomTrack);
// Automatically follows living room

// Perfect synchronization throughout your home!

// Main Mixer (Server)
await OwnaudioNet.StartNetworkSyncServerAsync();
var mainOutput = new FileSource("set-track-01.mp3");
mixer.AddSource(mainOutput);

// Monitor Speakers (Clients)
// Multiple monitor positions all receive the same audio
await OwnaudioNet.StartNetworkSyncClientAsync();

// Backup System (Client)
// Ready for instant failover if main system fails
await OwnaudioNet.StartNetworkSyncClientAsync(
    allowOfflinePlayback: true);  // Continues if main fails

// All systems play in perfect sync
// Backup automatically takes over if main disconnects

// Central Control Room (Server)
await OwnaudioNet.StartNetworkSyncServerAsync();
var soundtrack = new FileSource("installation-audio.wav");
mixer.AddSource(soundtrack);

// Multiple Display Zones (Clients)
// Zone 1, 2, 3, 4... all synchronized
for (int zone = 1; zone <= 10; zone++)
{
    // Each zone runs on separate device
    await OwnaudioNet.StartNetworkSyncClientAsync();
    var zoneTrack = new FileSource("installation-audio.wav");
    mixer.AddSource(zoneTrack);
}

// Synchronized audio-visual experience across entire installation

// Producer's Workstation (Server)
await OwnaudioNet.StartNetworkSyncServerAsync();
var projectMix = new FileSource("project-mix.wav");
mixer.AddSource(projectMix);

// Musicians' Headphones (Clients)
// Guitarist
await OwnaudioNet.StartNetworkSyncClientAsync();
var guitaristMix = new FileSource("project-mix.wav");
mixer.AddSource(guitaristMix);

// Vocalist
await OwnaudioNet.StartNetworkSyncClientAsync();
var vocalistMix = new FileSource("project-mix.wav");
mixer.AddSource(vocalistMix);

// Everyone hears exactly the same thing at the same time
// Perfect for recording sessions and rehearsals

// Main Phone/Tablet (Server)
await OwnaudioNet.StartNetworkSyncServerAsync();

// Other Phones/Tablets (Clients)
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: null,  // Auto-discovery on WiFi
    allowOfflinePlayback: true);

// All devices play in perfect sync over WiFi
// Great for parties, outdoor events, etc.

# Windows Firewall
netsh advfirewall firewall add rule name="OwnaudioSharp NetworkSync" dir=in action=allow protocol=UDP localport=9876

# Linux iptables
sudo iptables -A INPUT -p udp --dport 9876 -j ACCEPT

# macOS
# Allow in System Preferences > Security & Privacy > Firewall > Firewall Options