# React Native Youtube Bridge

## Guide

- [Overview](/guide/getting-started/overview.md): Using a YouTube player in React Native usually means juggling iframe setup, event wiring, playback control, and platform differences. react-native-youtube-bridge wraps the YouTube IFrame Player API in a React Native-friendly API built around three ideas: useYouTubePlayer creates and owns the player instance.YoutubeView renders the player on iOS, Android, and Web.useYouTubeEvent lets you react to player state, progress, mute, and error updates.
- [Installation](/guide/getting-started/installation.md): Install the main package:
- [Quick Start](/guide/getting-started/quick-start.md)
- [AI](/guide/getting-started/ai.md): To help AI better understand this library's features, versioned documentation, and project conventions so it can provide more accurate help during development and troubleshooting, this project provides the following capabilities:
- [Basic Usage](/guide/usage/basic-usage.md)
- [Player Controls](/guide/usage/player-controls.md): The player object returned by useYouTubePlayer exposes direct playback controls, async getters, and dynamic video loading methods. Async getter methods are useful after the player is ready. Before YoutubeView attaches the underlying controller, a getter can return undefined, so subscribe to ready before relying on these values.
- [Handling Events](/guide/usage/handling-events.md): useYouTubeEvent supports both reactive state subscriptions and callback-style side effects.
- [Player Config](/guide/usage/player-config.md): Pass initial player options as the second argument to useYouTubePlayer.
- [Styling and Layout](/guide/usage/styling-and-layout.md): YoutubeView handles the actual render surface.
- [Inline HTML vs WebView](/guide/usage/inline-html-vs-webview.md): On iOS and Android, the library supports two render strategies.
- [Custom WebView Player](/guide/usage/custom-webview-player.md): You only need @react-native-youtube-bridge/web when you want to host your own external player page.
- [Metadata with oEmbed](/guide/usage/metadata-with-oembed.md): Playback does not require oEmbed, but UI often benefits from it. useYoutubeOEmbed fetches metadata for a YouTube URL and returns: oEmbedisLoadingerror
- [Errors and Troubleshooting](/guide/usage/errors-and-troubleshooting.md)
- [API Reference](/guide/usage/api-reference.md)
- [Migration from 1.x](/guide/migration-from-1.x.md): This guide helps you migrate from react-native-youtube-bridge 1.x to 2.x. The 2.x API was redesigned to be more React-friendly by using hooks, similar to modern Expo APIs such as expo-audio and expo-video.