Soft Mode Analizi

Basit Anlatım (Herkes İçin)

Muzibu'da müzik iki farklı yöntemle gönderilebilir:

BÜTÜN (MP3)

Şarkı tek seferde, komple indirilir. Tıpkı bir fotoğraf indirmek gibi — ya gelir ya gelmez.

Kalite seçenekleri: 64 kbps veya 128 kbps

PARÇALI (HLS)

Şarkı küçük parçalara bölünerek gönderilir. YouTube veya Netflix gibi — internet hızına göre kaliteyi otomatik ayarlar.

Kalite seçenekleri: 32, 64, 128 kbps + orijinal

SOFT MODE

Soft Mode = Parçalı (HLS) sisteminin "hafifletilmiş" hali.

Normal HLS'de 4 kalite seviyesi arasında geçiş yapılırken, Soft Mode'da sadece en düşük 2 seviye kullanılır (32 + 64 kbps). Yüksek kalite seçenekleri tamamen kaldırılır.

Neden? İnternet zayıf olan yerlerde yüksek kaliteye geçiş yapılmasını engellemek için. Böylece şarkı hiç takılmaz.

Kritik Bilgi: Soft Mode Sadece HLS'te (Parçalı) Çalışır!

Seçenek	Gönderim	Soft Mode?	Açıklama
mp3_64	Bütün	HAYIR	Sabit 64 kbps MP3 dosyası gönderilir. Parça yok, soft yok.
mp3_128	Bütün	HAYIR	Sabit 128 kbps MP3 dosyası gönderilir. Parça yok, soft yok.
mp3_auto	Bütün	HAYIR	Cihaz kapasitesine göre 64 veya 128 kbps MP3. Yine de soft yok.
hls_soft	Parçalı	EVET	Tek gerçek soft mode! HLS master.m3u8'den mid + high kaldırılır.
hls_32	Parçalı	HAYIR	Tek seviyeye kilitli (ultralow). Soft değil, level lock.
hls_64	Parçalı	HAYIR	Tek seviyeye kilitli (low). Soft değil, level lock.
hls_128	Parçalı	HAYIR	Tek seviyeye kilitli (mid). Soft değil, level lock.
hls_auto	Parçalı	HAYIR	Tüm seviyeler açık, ABR serbest. En güçlü mod.

Normal HLS vs Soft HLS — Ne Değişiyor?

Normal HLS (hls_auto)

high orijinal kalite ~256 kbps

mid 128 kbps

low 64 kbps

ultralow 32 kbps

4 seviye arası otomatik geçiş (ABR)

Soft HLS (hls_soft)

high kaldırıldı

mid kaldırıldı

low 64 kbps aktif

ultralow 32 kbps aktif

Sadece 2 seviye: ultralow + low (max 64 kbps)

Soft Mode Nasıl Tetikleniyor?

1. Kullanıcı Play'e Basar

Frontend → GET /api/muzibu/songs/{id}/stream

2. Backend Karar Veriyor

// SongStreamController.php satır 222
$isSoft = ($forceFormat === 'hls_soft') || ($userPref === 'hls_soft');

// Sadece bu 2 koşulda $isSoft = true olur!
// mp3_64, mp3_128, mp3_auto → $isSoft = false (çünkü MP3'e gider)
                    

3. URL'ye Parametre Eklenir

// SignedUrlService.php
master.m3u8?soft=1&expires=...&token=...&sig=...
                    

4. Master Playlist Filtrelenir

// serveHls() satır 829-835
if ($isSoftPlayer) {
    $allowedVariants = config('muzibu.audio.soft_player_variants');
    // → ['ultralow', 'low']
    // mid ve high satırları master.m3u8'den SİLİNİR
}
                    

5. HLS.js Sadece 2 Seviye Görür

Tarayıcı ultralow (32kbps) ile low (64kbps) arasında otomatik geçiş yapar. Daha yüksek kaliteye çıkamaz.

MP3 (Bütün) Neden Soft Değil?

MP3'te olan:

1. Şarkı tek dosya olarak gönderilir
2. Kalite sabit — ya 64 ya 128 kbps
3. Parçalama yok — segment, playlist yok
4. Adaptif kalite yok — ne gönderilirse o çalar

Soft Mode'un ihtiyacı:

1. Birden fazla kalite seviyesi olmalı (filtrelenecek)
2. Playlist dosyası olmalı (master.m3u8)
3. Variant filtreleme yapılabilmeli
4. ABR (Adaptif Bitrate) çalışmalı

Sonuç: MP3'te filtrelenecek bir playlist yok. Zaten tek bir kalitede tek bir dosya gönderiliyor. "Soft" kavramı MP3 için anlamsız.

MP3 64 kbps seçmek ≠ Soft Mode. O sadece "düşük kaliteli MP3 gönder" demek.

Soft Mode vs Level Lock — Fark Ne?

Özellik	Soft Mode (hls_soft)	Level Lock (hls_32/64/128)
Kullanılan variant sayısı	2 (ultralow + low)	1 (sadece seçilen)
ABR (otomatik geçiş)	EVET (2 seviye arası)	HAYIR (sabit)
Max kalite	64 kbps	Seçime bağlı (32/64/128)
İnternet kötüleşirse	64 → 32'ye düşer (takılmaz)	Düşemez, takılabilir
Kullanım senaryosu	İnternet dalgalı, bazen iyi bazen kötü	İnternet sürekli aynı hızda

Admin Panelde Hangilere "Soft" Yazmalı?

Bütün mp3_64 Soft DEĞİL — MP3, parçalama yok, soft anlamsız

Bütün mp3_128 Soft DEĞİL — MP3, parçalama yok, soft anlamsız

Bütün mp3_auto Soft DEĞİL — MP3, parçalama yok, soft anlamsız

Parçalı hls_32 Soft DEĞİL — Level lock (tek seviye), ABR yok

Parçalı hls_64 Soft DEĞİL — Level lock (tek seviye), ABR yok

Parçalı hls_soft SOFT — Tek gerçek Soft Mode! 2 seviye arası ABR

Parçalı hls_128 Soft DEĞİL — Level lock (tek seviye), ABR yok

Parçalı hls_auto Soft DEĞİL — Full ABR (4 seviye), en güçlü mod

Sonuç: Admin panelde "Soft" etiketi sadece hls_soft seçeneğinde olmalı. MP3 seçeneklerine "Soft" yazmak teknik olarak yanlış — onlar sadece düşük kaliteli MP3.

Önerilen Admin Panel Dropdown

─── Genel ───
  0 — Auto — Varsayılan
─── Bütün ───
  1. Seviye — En sorunlu müşteri
  2. Seviye — Sorunlu müşteri
  0 — Auto — Normal internet, normal cihaz
─── Parçalı ───
  1. Seviye — Normal cihaz, internet çok sorunlu
  2. Seviye — Normal cihaz, internet sorunlu
  1+2. Seviye — Soft — İyi cihaz, internet sorunlu
  3. Seviye — İyi cihaz, normal internet
  0 — Auto — İyi cihaz, iyi internet

Not: "Soft" etiketi sadece hls_soft'ta var. MP3'lerdeki "Soft" kaldırıldı.

Soft Mode Nedir?