OSTP
Open Sonic Transport Protocol

stream_id[15:12] = deck_id    // 0 = Deck A, 1 = Deck B
stream_id[11:8]  = ch_count   // 0=legacy 2ch, 1=mono, 2=stereo, 6=5.1, 8=7.1
stream_id[7:0]   = reserved   // MUST be 0x00

"test"                    // シンプルな名前
"soluna/stage-a"          // 階層: ブランド/ステージ
"venue/tokyo/floor-1"     // 階層: 会場/都市/フロア
"dj/akira/set-20260316"  // 階層: アーティスト/セット

h = FNV1a_32(channel_name)
X = (h >> 8) & 0xFF
Y = h & 0xFF
multicast_addr = 239.69.X.Y
port           = 5004          // AES67互換

// UDP unicast to relay
relay.solun.art:5100

// TCP/WS control
JOIN:channel_name:password:device_name\n

PT      = 127          // FEC/XOR
stream_id = 0xFFFF     // FECパケット識別
seq     = base_seq     // 保護対象の先頭シーケンス番号

Payload = XOR(pkt[N], pkt[N+1], pkt[N+2], pkt[N+3], pkt[N+4])

{
  "command": "rx.receiver_report",
  "ssrc": 3141592653,
  "packets_received": 25000,
  "packets_lost": 12,
  "loss_rate_pct": 0.05,
  "jitter_ms": 1.8,
  "last_seq": 25012,
  "rtt_ms": 45.2
}

// ── 75%再生時点でプリバッファ開始 ─────────────────────────────

iOS/Android ──POST /api/player/upload?name=track.mp3&mode=next──→ solunad
solunad     ←── event: player.next_file_start {name, size} ──────→ 全受信者
            ←── binary: [0xFC][0xFD][hi][lo][32KB chunk] × N ──→ 全受信者
solunad     ←── event: player.next_file_done ────────────────────→ 全受信者
各受信者     ──command: player.next_file_ready ──────────────────────→ solunad

// ── 曲切替時 (全員準備完了後) ────────────────────────────────

solunad     ←── event: player.switch {switch_delay_ms: 50, file_pos_ms: 0} → 全受信者
各受信者     ── 50ms後にローカルAVPlayer/MediaPlayerで再生開始 ─────────

// リクエスト (id は任意の整数)
{ "id": 42, "command": "monitor.set_delay", "ms": 40 }

// レスポンス
{ "id": 42, "success": true, "data": "" }

// ブロードキャストイベント (id なし)
{ "event": "player.switch", "switch_delay_ms": 50, "file_pos_ms": 0 }

// クライアントサイド実装例 (TypeScript)
const t1 = Date.now()
ws.send(JSON.stringify({ command: "time.ping" }))

// recv: {"data": "{\"pong\":true}"}
const t2 = Date.now()
const latency = Math.max(20, Math.floor((t2 - t1) / 2) + 15)

// 遅延補正をデーモンに適用
ws.send(JSON.stringify({ command: "monitor.set_delay", ms: latency }))

// ジッターバッファも同期
jitterBufferTarget = latency

// クロスフェード位置設定 (0.0 = Deck A, 1.0 = Deck B)
{ "command": "deck.set_param", "deck": 0, "param": "crossfade", "value": 0.7 }

// BPM設定
{ "command": "deck.set_param", "deck": 1, "param": "bpm", "value": 128.0 }

// モード切替
{ "command": "deck.set_mode", "mode": "param_only" }

// crossfade: 0.0 = Deck A only, 1.0 = Deck B only
θ = crossfade × π / 2

gain_A = cos(θ)   // Deck A: 1.0 → 0.0 (equal-power curve)
gain_B = sin(θ)   // Deck B: 0.0 → 1.0 (equal-power curve)

output = gain_A × deck_A + gain_B × deck_B

// MUST smooth over ≥ 10ms (480 samples @ 48kHz) to prevent clicks
// クリックノイズ防止のため ≥480サンプルかけてスムーシングすること

// 256-bit random, base64url encoded
token = base64url(crypto.randomBytes(32))

// WebSocket Authorizationヘッダで送信
Authorization: Bearer <token>

// トークン有効期限: セッション終了まで (最大24時間)