# React Native Youtube Bridge

## 가이드

- [개요](/ko/guide/getting-started/overview.md): React Native에서 YouTube 플레이어를 붙이려면 iframe 설정, 이벤트 연결, 재생 제어, 플랫폼 차이를 한 번에 처리해야 하는 경우가 많습니다. react-native-youtube-bridge는 YouTube IFrame Player API를 React Native에 맞는 방식으로 감싼 라이브러리이며, 핵심은 세 가지입니다. useYouTubePlayer로 플레이어 인스턴스를 만든다.YoutubeView로 플레이어를 렌더링한다.useYouTubeEvent로 상태, 진행률, 음소거, 에러를 구독한다.
- [설치](/ko/guide/getting-started/installation.md): 먼저 메인 패키지를 설치합니다.
- [빠른 시작](/ko/guide/getting-started/quick-start.md)
- [AI](/ko/guide/getting-started/ai.md): AI가 이 라이브러리의 기능, 버전별 문서, 프로젝트 규칙을 더 잘 이해해서 개발이나 트러블슈팅 과정에서 더 정확한 도움을 줄 수 있도록, 이 프로젝트는 다음 기능들을 제공합니다.
- [기본 사용법](/ko/guide/usage/basic-usage.md)
- [플레이어 제어](/ko/guide/usage/player-controls.md): useYouTubePlayer가 반환하는 플레이어 객체에는 직접 호출할 수 있는 메서드, 비동기 getter, 동적 비디오 로드 메서드가 포함됩니다. 비동기 getter 메서드는 플레이어가 준비된 뒤 사용하는 것을 권장합니다. YoutubeView가 내부 controller를 연결하기 전에는 getter가 undefined를 반환할 수 있으므로, 값에 의존해야 한다면 ready 이벤트 이후에 호출하세요.
- [이벤트 처리](/ko/guide/usage/handling-events.md): useYouTubeEvent는 reactive state 구독과 callback 기반 side effect를 모두 지원합니다.
- [플레이어 설정](/ko/guide/usage/player-config.md): 초기 옵션은 useYouTubePlayer의 두 번째 인자로 전달합니다.
- [스타일과 레이아웃](/ko/guide/usage/styling-and-layout.md): YoutubeView가 실제 렌더링 표면을 담당합니다.
- [Inline HTML vs WebView](/ko/guide/usage/inline-html-vs-webview.md): iOS와 Android에서는 두 가지 렌더링 전략을 지원합니다.
- [커스텀 WebView 플레이어](/ko/guide/usage/custom-webview-player.md): 직접 호스팅하는 외부 플레이어 페이지가 필요할 때만 @react-native-youtube-bridge/web를 사용하면 됩니다.
- [oEmbed 메타데이터](/ko/guide/usage/metadata-with-oembed.md): 재생 자체에는 필요 없지만, UI를 더 풍부하게 만들 때 유용합니다. useYoutubeOEmbed는 YouTube URL에 대한 메타데이터를 가져오며 아래 값을 반환합니다. oEmbedisLoadingerror
- [오류와 트러블슈팅](/ko/guide/usage/errors-and-troubleshooting.md)
- [API 레퍼런스](/ko/guide/usage/api-reference.md)
- [1.x에서 마이그레이션](/ko/guide/migration-from-1.x.md): 이 문서는 react-native-youtube-bridge 1.x에서 2.x로 이동하는 방법을 설명합니다. 2.x API는 expo-audio, expo-video 같은 현대적인 Expo API처럼 Hook 중심으로 다시 설계되었습니다.