For AI agents: the complete documentation index is available at /1.x/llms.txt, the full documentation bundle is available at /1.x/llms-full.txt, and this page is available as Markdown at /1.x/guide/usage/inline-html-vs-webview.md.
  • English
  • 1.x
  • Inline HTML vs WebView

    On iOS and Android, 1.x supports two render strategies.

    Inline HTML mode

    <YoutubePlayer source="AbZH7XWDW_k" useInlineHtml />
    • default mode
    • loads HTML directly inside the app

    External WebView mode

    <YoutubePlayer
      source="AbZH7XWDW_k"
      useInlineHtml={false}
      webViewUrl="https://your-custom-player.com"
    />
    • loads an external player page
    • default hosted player page: https://react-native-youtube-bridge.pages.dev
    • useful when inline HTML runs into embed restrictions or origin constraints