Розробка платформи для подкастів

Розробка платформи подкастів

Подкасти здаються простими: аудіофайл + RSS. Але коли додається монетизація, аналітика, динамічне вставлення реклами та підтримка кількох ведучих на шоу, складність стрімко зростає. Нижче — архітектура реальної платформи, а не чергового RSS-хостингу.

RSS-лента як основний API

Подкаст-клієнти (Apple Podcasts, Spotify, Overcast) споживають RSS. Лента повинна відповідати специфікаціям Apple Podcasts та Podcast Namespace (podcastindex.org):

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
  xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd"
  xmlns:podcast="https://podcastindex.org/namespace/1.0"
  xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>My Podcast</title>
    <link>https://example.com/podcast</link>
    <language>uk</language>
    <itunes:author>John Doe</itunes:author>
    <itunes:category text="Technology"/>
    <itunes:image href="https://cdn.example.com/covers/show-1.jpg"/>
    <podcast:locked>yes</podcast:locked>
    <podcast:guid>urn:uuid:f8d3e2a1-...</podcast:guid>

    <item>
      <title>Ep. 42: Redis Internals</title>
      <guid isPermaLink="false">ep-42-redis-internals</guid>
      <pubDate>Fri, 14 Mar 2025 10:00:00 +0000</pubDate>
      <enclosure url="https://cdn.example.com/audio/ep42.mp3"
                 length="48291840" type="audio/mpeg"/>
      <itunes:duration>3456</itunes:duration>
      <itunes:episodeType>full</itunes:episodeType>
      <itunes:season>2</itunes:season>
      <itunes:episode>42</itunes:episode>
      <podcast:chapters type="application/json+chapters"
        url="https://cdn.example.com/chapters/ep42.json"/>
      <podcast:transcript url="https://cdn.example.com/transcripts/ep42.vtt"
        type="text/vtt"/>
    </item>
  </channel>
</rss>

Генерація ленти — не статичний файл, а динамічна кінцева точка з кешуванням:

class PodcastFeedController extends Controller
{
    public function feed(string $slug): Response
    {
        $show = Show::with(['episodes' => function ($q) {
            $q->where('status', 'published')
              ->orderByDesc('published_at')
              ->limit(100); // більшість клієнтів не беруть більше
        }])->where('slug', $slug)->firstOrFail();

        $xml = $this->feedBuilder->build($show);

        return response($xml, 200)
            ->header('Content-Type', 'application/rss+xml; charset=utf-8')
            ->header('Cache-Control', 'public, max-age=3600');
    }
}

Динамічне вставлення реклами (DAI)

Dynamic Ad Insertion — основне джерело монетизації. Дві моделі: server-side (файл перекодується з рекламою) та client-side (плеєр завантажує рекламу окремо через VAST).

Server-side через FFmpeg надійніше і працює в будь-якому клієнті:

import subprocess
from pathlib import Path

def insert_ads(episode_path: str, ad_slots: list[dict]) -> str:
    """
    ad_slots: [{"position_sec": 0, "ad_path": "preroll.mp3"},
               {"position_sec": 600, "ad_path": "midroll.mp3"}]
    """
    parts = []
    prev = 0

    # Нарізуємо епізод навколо рекламних вставок
    for slot in sorted(ad_slots, key=lambda x: x['position_sec']):
        pos = slot['position_sec']
        segment = f"/tmp/seg_{prev}_{pos}.mp3"
        subprocess.run([
            'ffmpeg', '-i', episode_path,
            '-ss', str(prev), '-to', str(pos),
            '-acodec', 'copy', segment, '-y'
        ], check=True)
        parts.extend([segment, slot['ad_path']])
        prev = pos

    # Хвіст після останньої реклами
    tail = f"/tmp/seg_{prev}_end.mp3"
    subprocess.run([
        'ffmpeg', '-i', episode_path, '-ss', str(prev),
        '-acodec', 'copy', tail, '-y'
    ], check=True)
    parts.append(tail)

    # Конкатенація
    list_file = "/tmp/concat_list.txt"
    with open(list_file, 'w') as f:
        for p in parts:
            f.write(f"file '{p}'\n")

    out = f"/tmp/episode_with_ads_{Path(episode_path).stem}.mp3"
    subprocess.run([
        'ffmpeg', '-f', 'concat', '-safe', '0',
        '-i', list_file, '-acodec', 'copy', out, '-y'
    ], check=True)

    return out

Транскрипція епізодів

Транскрипція потрібна для SEO, доступності та пошуку за змістом. OpenAI Whisper — найкращий баланс якості та вартості:

import whisper
import json

def transcribe_episode(audio_path: str, language: str = 'uk') -> dict:
    model = whisper.load_model('large-v3')
    result = model.transcribe(
        audio_path,
        language=language,
        word_timestamps=True,
        verbose=False
    )

    # Конвертуємо в WebVTT для podcast:transcript
    vtt_lines = ['WEBVTT\n']
    for seg in result['segments']:
        start = format_timestamp(seg['start'])
        end = format_timestamp(seg['end'])
        vtt_lines.append(f"{start} --> {end}")
        vtt_lines.append(seg['text'].strip())
        vtt_lines.append('')

    # Chapters JSON (podcastindex.org/namespace)
    chapters = detect_chapters(result['segments'])

    return {
        'vtt': '\n'.join(vtt_lines),
        'chapters': chapters,
        'full_text': result['text'],
        'duration': result['segments'][-1]['end'] if result['segments'] else 0
    }

def format_timestamp(seconds: float) -> str:
    h = int(seconds // 3600)
    m = int((seconds % 3600) // 60)
    s = seconds % 60
    return f"{h:02d}:{m:02d}:{s:06.3f}"

Аналітика прослуховування

IAB Podcast Measurement Standards v2.1 — індустріальний стандарт. Головне правило: один унікальний IP + User-Agent за 24 години = одна загрузка, незалежно від кількості запитів.

-- Дедупліація за IAB v2.1
CREATE TABLE download_events (
  id            BIGSERIAL PRIMARY KEY,
  episode_id    BIGINT NOT NULL,
  ip_hash       TEXT NOT NULL,  -- SHA-256 для GDPR
  user_agent    TEXT,
  bytes_sent    BIGINT,
  created_at    TIMESTAMPTZ DEFAULT now()
);

-- Унікальні загрузки за період
SELECT
  episode_id,
  COUNT(DISTINCT (ip_hash, LEFT(user_agent, 50))) AS unique_downloads
FROM download_events
WHERE created_at BETWEEN $1 AND $2
  AND bytes_sent > 0  -- виключаємо переривані
GROUP BY episode_id;

Геоаналітика через MaxMind GeoIP2 — не за сирими IP (GDPR), а за попередньо оброблені геотегами.

Субтитрові плеєри та розділи

Маркери розділів — killer feature для довгих епізодів. Формат podcast:chapters:

{
  "version": "1.2.0",
  "title": "Episode 42",
  "chapters": [
    { "startTime": 0, "title": "Intro", "img": "https://cdn.../ch0.jpg" },
    { "startTime": 120, "title": "Redis Data Structures" },
    { "startTime": 1800, "title": "Clustering", "url": "https://redis.io/docs/cluster" },
    { "startTime": 3000, "title": "Outro" }
  ]
}

Монетизація: підписки та інтеграція Patreon

Приватний RSS для платних підписників — токен в URL:

// Приватна лента з токеном підписника
Route::get('/feed/{show}/{token}', function (string $show, string $token) {
    $subscriber = Subscriber::where('feed_token', $token)
        ->where('status', 'active')
        ->firstOrFail();

    // Логуємо доступ до ленти (аналітика клієнтів)
    FeedAccess::create([
        'subscriber_id' => $subscriber->id,
        'user_agent' => request()->userAgent(),
        'ip_hash' => hash('sha256', request()->ip()),
    ]);

    $show = Show::where('slug', $show)->firstOrFail();
    // Включаємо бонусний контент для преміум
    $episodes = $show->episodes()
        ->where('status', 'published')
        ->when(!$subscriber->is_premium, fn($q) => $q->where('is_premium', false))
        ->orderByDesc('published_at')
        ->get();

    return response($this->buildFeed($show, $episodes, $subscriber))
        ->header('Content-Type', 'application/rss+xml');
});

Зберігання та доставка аудіо

Подкасти — великі файли з нерівномірним навантаженням (всплеск після виходу епізоду). S3 + CloudFront — стандартне рішення. Важливо: більшість клієнтів роблять Range-запити під час відтворення для перемотування — переконайтеся, що ваше сховище їх підтримує.

# Проксирування з підписаним токеном через Nginx
location /episode/ {
    set $signed 0;
    # Перевіряємо підпис через Lua або auth_request
    auth_request /validate-episode-access;
    proxy_pass https://s3.example.com/podcast-audio/;
    proxy_set_header Authorization "";  # видаляємо наші облікові дані
    add_header X-Robots-Tag "noindex"; # аудіо не потребує індексування
}

Часові рамки

Платформа з публічними шоу, RSS за стандартом Apple/Spotify, завантаженням файлів, базовою аналітикою (IAB-сумісною) та вбудованим плеєром: 8–10 тижнів. DAI (динамічна реклама), Whisper-транскрипція, приватний RSS для платних підписників, інтеграція Stripe: ще 5–7 тижнів. Мобільні додатки для iOS/Android: окрема історія.