Niche Guides·6 min read·

VeloCMS'e Bölüm Ses Dosyalarını Yükleme

MP3 ya da M4A formatındaki bölüm seslerinizi nasıl yükleyeceğinizi, yazınızdaki ses URL'si alanını nasıl ayarlayacağınızı ve Podcast temasında oynatıcının düzgün çalıştığından nasıl emin olacağınızı bu yazıda bulabilirsiniz.

VeloCMS, podcast ses dosyalarını tıpkı görseller gibi standart medya dosyaları olarak saklar. Podcast temasındaki her yazı, bir 'Audio URL' alanı sunar. Bu alanı doldurduğunuzda, dahili AudioPlayer oynatıcısı, herkese açık bölüm sayfasında otomatik olarak belirir. Üstelik oynatma, duraklatma, ileri/geri sarma ve ses kontrolü gibi tüm özellikleriyle birlikte.

Adım 1 — Ses dosyanızı Medya Kütüphanesi'ne yükleyin

Admin > Media yolunu izleyip Upload butonuna tıklayın. VeloCMS, dosya başına 500 MB'a kadar MP3, M4A ve OGG formatlarını destekliyor. Daha büyük dosyalarınız varsa (mesela canlı kayıtlar veya sıkıştırılmamış WAV'lar), yüklemeden önce bunları 128–192 kbps MP3 formatına sıkıştırmanızda fayda var. Bu sayede, özellikle konuşma odaklı seslerde fark edilir bir kalite kaybı yaşamadan akıcı bir dinleme deneyimi sunabilirsiniz.

  • Kabul edilen formatlar: .mp3, .m4a, .ogg
  • Maksimum dosya boyutu: Yükleme başına 500 MB
  • Önerilen bit hızı: Röportajlar için 128 kbps, müzik ağırlıklı prodüksiyonlar için 192 kbps
  • Stereo da olur ama mono, konuşma seslerinde hissedilir bir kalite kaybı olmadan dosya boyutunu yarı yarıya düşürür.

Dosyalar Cloudflare R2'de saklanır ve dinleyiciye en yakın CDN uç noktası üzerinden sunulur. Bu sayede standart bir bağlantıyla dünyanın herhangi bir yerinden yayın 200 milisaniyenin altında başlar.

Adım 2 — Dosya URL'sini kopyalayın

Yükleme tamamlandığında, medya ögesi için `https://media.velocms.org/tenant-id/filename.mp3` formatında herkese açık bir URL gösterilir. URL'nin yanındaki kopyalama ikonuna tıklayın. Bu adresi bir sonraki adımda yazı ayarlarına yapıştıracaksınız.

Adım 3 — Ses URL'sini bölüm yazısına yapıştırın

Bölümünüze ait yazı düzenleyiciyi açın (veya yeni bir yazı oluşturun). Sağ taraftaki Ayarlar panelinde, Podcast bölümüne kadar aşağı kaydırın. Kopyaladığınız URL'yi Audio URL alanına yapıştırın. Bu alan harici olarak barındırılan herhangi bir MP3 URL'sini de kabul eder. Yani URL'si desteklenen bir uzantıyla bittiği sürece Anchor.fm, Buzzsprout gibi servisler de sorunsuz çalışacaktır.

Adım 4 — Süre ve dosya boyutunu ayarlayın

Audio URL'nin altında iki isteğe bağlı alan belirecektir: Duration (saniye cinsinden, örneğin bir saatlik bölüm için 3600) ve File Size (byte cinsinden). Bu alanlar, iTunes RSS akışındaki 'enclosure' elementini doldurur. Spotify, Apple Podcasts ve Overcast gibi podcast uygulamaları da bölüm uzunluğunu göstermek ve önceden indirme özelliğini aktif etmek için bu bilgiyi kullanır. Boş bırakırsanız akışınız yine geçerli olur ama podcast uygulamalarındaki süre rozetinde 'Bilinmiyor' yazar.

  • Süre formatı: saniye cinsinden tam sayı — örn. 30 dakika için 1800
  • Dosya boyutu: byte cinsinden tam sayı — bu bilgiye dosyaya sağ tıklayıp macOS'te 'Get Info', Windows'ta ise 'Properties' seçerek ulaşabilirsiniz.
  • İki alan da isteğe bağlıdır ancak Apple Podcast Connect uyumluluğu için doldurulması tavsiye edilir.

Adım 5 — Yayınlayın ve oynatıcıyı kontrol edin

Yazıyı yayınlayın. Herkese açık blogunuzdaki bölüm sayfasını ziyaret edin (Podcast teması bu sayfayı `/blog/bolum-adresiniz` yolunda oluşturur). Bölüm başlığının hemen altında, bölüm notlarından önce AudioPlayer çubuğunun belirdiğini görmelisiniz. Bu çubukta bir oynatma tuşu, dalga formunda bir ilerleme çubuğu, zaman sayacı ve ses kontrolü bulunur. Eğer oynatıcıyı göremiyorsanız, Audio URL alanının boş olmadığından ve `https://` ile başladığından emin olun.

HTTP (yani HTTPS olmayan) ses URL'leri, karma içerik politikası nedeniyle tarayıcılar tarafından engellenir. Ses dosyanızın URL'sinin her zaman HTTPS versiyonunu kullanmaya özen gösterin.

Sorun Giderme

  • Oynatıcı görünmüyor: Aktif temanın Podcast olduğundan emin olun (Admin > Themes). Diğer temalar podcast'e özel bu yerleşimi göstermez.
  • Ses çalmıyor: Dosya URL'sinin herkese açık olup olmadığını kontrol edin — adresi gizli bir tarayıcı sekmesinde açmayı deneyin. Eğer 403 hatası alıyorsanız, R2 bucket politikasının 'public' olarak ayarlanması gerekir.
  • RSS akışında 'enclosure' eksik: Audio URL ve File Size alanlarının dolu olduğunu teyit edin. RSS akışınız `blogadresiniz.velocms.org/podcast.xml` adresindedir.
  • Süre yanlış görünüyor: Süre saniye cinsinden saklanır. Örneğin 3660 değeri, podcast uygulamalarında 1:01:00 olarak görünür.