Streaming & Video Integrations

YouTubeLiveEmbed stores name, channel_id, video_id, an api_key_ref to Key Vault, privacy (public/unlisted/private), a YouTubePlayerParams block (autoplay, mute, controls, loop, modest_branding, rel, fs, cc_load_policy), embed dimensions, responsive flag, allowed_domains, and an optional competition_id link; GET /{id}/embed produces the embed URL plus an iframe HTML snippet wrapped in a responsive 16:9 container, GET /{id}/validate sanity-checks video_id and channel_id formats, and a live-chat iframe URL is generated when live_chat_embed=true. TwitchEmbed mirrors the same shape with channel_name, video_id, collection_id, layout (video or video_with_chat), TwitchPlayerParams, parent_domains (mandatory because Twitch requires explicit parent allowlists), theme, and a chat embed URL when layout=video_with_chat. RtmpRelayConfig models multi-destination fan-out — name, status (draft, active, paused, error, decommissioned), ingest_protocol (rtmp, rtmps, srt), ingest_url, ingest_key_ref, up to five RtmpRelayDestination rows (name, platform, rtmp_url, stream_key_ref, enabled, bitrate_kbps, resolution), max_bitrate_kbps, transcoding_enabled, recording_enabled, and competition_id; URL validation enforces rtmp://, rtmps://, or srt:// schemes and lifecycle transitions are guarded with HTTP 409 on illegal moves.

StreamMetadata is the canonical reference per stream with title, stream_type (live, vod, clip), status (scheduled, live, ended, processing, available, error, archived), platform, platform_stream_id, platform_url, thumbnail_url, embed_url, competition_id, match_id, language, tags, scheduled_start_at, actual_start_at, ended_at, duration_seconds, StreamViewerStats (peak_concurrent computed via max-aggregation, total_views, average_watch_time_s, unique_viewers), and is_featured/is_public flags. VimeoReplay records archived video with vimeo_video_id, vimeo_uri, api_token_ref, privacy (anybody/nobody/password/unlisted/disable), password_ref, and embed cosmetics. CloudflareStreamConfig holds the live or on-demand mode, account_id_ref, api_token_ref, cf_stream_id, cf_live_input_id, RTMP/SRT/WebRTC ingest URLs, HLS/DASH playback URLs, a SignedUrlConfig (signing_key_ref, token_ttl_seconds, require_signed_urls), and CloudflareStreamAllowedOrigin entries; signed playback URLs are generated with HMAC-SHA256 over a JWT-style payload using the configured TTL.