# Building a Custom Player

Architectural principles, format handling, and engineering guidelines for building resilient video players backed by Vyla infrastructure.

## Overview In the Vyla ecosystem, you are never locked into an official frontend. Vyla provides the discovery, resolution, and proxy layers; your application owns the player experience. Whether you are building a custom web portal, desktop client, or mobile app, this guide covers the core engineering patterns required for a robust player. --- ## Integration Boundaries Choose your integration point based on your architecture: | Architecture | Integration Point | Data Flow | Best For | | :--- | :--- | :--- | :--- | | **Node.js Backend** | **Vyla SDK Directly** | `sdk.getStream()` in-process | Applications with full backend control, custom authentication, and server-side session tracking. | | **Browser / Mobile** | **Stream API Gateway** | SSE `/movie` or `/tv` over HTTP | Web applications, smart TV frontends, or lightweight mobile clients requiring an HTTP/SSE source feed. | --- ## Playback Formats: HLS vs Direct Video Resolved candidate streams come in two primary container types: 1. **HLS Streams (`type: "hls"`)**: - Master M3U8 playlists containing multiple bitrate/resolution variants. - Proxied through Stream API (`/api?url=...`), which automatically rewrites chunk URLs and AES-128 encryption key URIs. - Requires native HLS support (Safari on macOS/iOS) or a JavaScript HLS MSE library such as [HLS.js](https://github.com/video-dev/hls.js/) in modern browsers. 2. **Direct Media Files (`type: "mp4"`)**: - Progressive MP4 or MKV streams. - Proxied with HTTP Range header forwarding (`206 Partial Content`), allowing smooth scrubbing and seeking. - Directly assignable to the HTML5 `