← Cloudflare Realtime / realtime / sfu
Adaptéry pro přenos médií
Adaptéry pro přenos médií propojují WebRTC s dalšími přenosovými protokoly. Zajišťují konverzi protokolů, převod kodeků a obousměrný tok médií mezi relacemi WebRTC a externími koncovými body.
Co dělají adaptéry
Adaptéry rozšiřují možnosti Realtime nad rámec komunikace typu WebRTC-to-WebRTC:
- Přijímejte zvuk a video z externích zdrojů do WebRTC relací
- Streamujte média WebRTC do externích systémů za účelem zpracování nebo uložení
- Integrace s AI službami pro přepis, překlad nebo generování
- Propojování aplikací WebRTC se staršími komunikačními systémy
Dostupné adaptéry
WebSocket adaptér (beta)
Streamujte zvuk a video mezi stopami WebRTC a koncovými body WebSocket. Video je pouze odchozí (egress) a je převedeno do formátu JPEG. Aktuálně ve verzi beta, rozhraní API se může změnit.
Architektura
Adaptéry pro přenos médií fungují jako prostředníci mezi relacemi Cloudflare Realtime SFU a externími koncovými body:
graph LR
A[WebRTC Client] <--> B[Realtime SFU Session]
B <--> C[Media Transport Adapter]
C <--> D[External Endpoint]
Klíčové koncepty
Instance adaptéru: Každé připojení vytvoří jedinečnou instanci s adapterId a spravovat tak jeho životní cyklus.
Typy umístění:
local(Ingest): přijímá média z externích endpointů a vytváří z nich nové WebRTC trackyremote(Stream): odesílá média z existujících WebRTC tracků do externích endpointů
Podpora kodeků: Adaptéry převádějí formáty mezi WebRTC a externími systémy.
Běžné případy použití
Zpracování AI
- Přepis řeči na text
- Generování řeči z textu (text-to-speech)
- Překlad v reálném čase
- Vylepšení zvuku
Nahrávání médií
- Cloudové nahrávání
- Sítě pro doručování obsahu
- Pipeline pro zpracování médií
Starší integrace
- Tradiční telefonie
- Infrastruktura pro vysílání
- Vlastní mediální servery
Přehled API
Adaptéry pro přenos médií se spravují prostřednictvím API Realtime SFU:
POST /v1/apps/{appId}/adapters/{adapterType}/new
POST /v1/apps/{appId}/adapters/{adapterType}/closeKaždý typ adaptéru má specifické požadavky na konfiguraci a specifické možnosti. Podrobné specifikace API najdete v dokumentaci jednotlivých adaptérů.
Osvědčené postupy
- Zavírejte instance adaptéru, jakmile již nejsou potřeba
- Implementujte logiku pro opětovné připojení při výpadcích sítě
- Zvolte kodeky podle požadavků na šířku pásma a kvalitu
- Zabezpečení koncových bodů ověřováním pro citlivá média
Omezení
- Každý typ adaptéru má specifickou podporu kodeků a formátů
- Latence sítě mezi edge Cloudflare a externími koncovými body ovlivňuje výkon v reálném čase
- Maximální velikost zprávy a režimy streamování se liší podle typu adaptéru
Začínáme
WebSocket adaptér (beta) - Streamovat zvuk a video mezi koncovými body WebRTC a WebSocket (video egress do formátu JPEG)