주요 콘텐츠로 건너뛰기
@capgo/capacitor-youtube-player 미디어 오픈 소스

유튜브 플레이어 Capacitor 플러그인

API를 사용하여 YouTube 비디오를 완전한 플레이어 API 제어 및 이벤트 처리와 함께 임베드합니다.

설치

bun add @capgo/capacitor-youtube-player bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-youtube-player
  • pnpm add @capgo/capacitor-youtube-player
  • yarn add @capgo/capacitor-youtube-player

Guide

How to use YouTube Player in Capacitor

Capacitor YouTube Player

다운로드하여 Capgo 앱을 설치한 후 QR code 코드를 스캔하세요.

유튜브 플레이어 플러그인 미리보기 QR code

@capgo/capacitor-youtube-player을 사용하여

Capacitor용 유튜브 플레이어 플러그인 인터페이스입니다. 앱에서 유튜브 비디오 재생을 제어하는 방법을 제공합니다.

설치

bun add @capgo/capacitor-youtube-player
bunx cap sync

이 플러그인이 제공하는 것

  • initialize - 새로운 유튜브 플레이어 인스턴스를 초기화합니다.
  • destroy - 플레이어 인스턴스를 삭제하고 자원을 해제합니다.
  • stopVideo - 비디오 재생을 중지하고 로딩을 취소합니다. 이 메서드를 자주 사용하지 마세요. - pauseVideo()를 사용하는 것이 일반적입니다.
  • playVideo - 현재 재생할 동영상 재생. 최종 플레이어 상태는 PLAYING (1)입니다.

Main WebView Referer Patch

Enable patchRefererHeader YouTube 콘텐츠가 플러그인에서 작동하지만 Capacitor의 Main WebView에서 실패하는 경우에만 적용됩니다. YouTube는 브라우저와 같은 헤더를 기대하기 때문입니다. Referer 이 패치는

{
  "plugins": {
    "YoutubePlayer": {
      "patchRefererHeader": true,
      "refererHeader": "https://www.youtube.com"
    }
  }
}

와 youtube.com, youtube-nocookie.com, and youtu.be 기본값으로 설정됩니다. Referer 예시 사용법 refererHeader 기본값으로 사용합니다. https://www.youtube.com The patch only applies to

, and

initialize

YouTube 플레이어 인스턴스 초기화.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

await YoutubePlayer.initialize({
  playerId: 'my-player',
  videoId: 'dQw4w9WgXcQ',
  playerSize: { width: 640, height: 360 },
  privacyEnhanced: true
});

destroy

플레이어 인스턴스 파괴하고 자원 해제.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

const result = await YoutubePlayer.destroy({ playerId: 'player-id-123' });
console.log(result);

stopVideo

비디오 재생을 중지하고 로딩 취소. 이 메서드를 사용할 때는 pauseVideo()를 사용하는 것이 일반적입니다.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

const result = await YoutubePlayer.stopVideo({ playerId: 'player-id-123' });
console.log(result);

playVideo

현재 큐드 또는 로드된 비디오 재생. 최종 플레이어 상태는 PLAYING (1)입니다.

import { YoutubePlayer } from '@capgo/capacitor-youtube-player';

const result = await YoutubePlayer.playVideo({ playerId: 'player-id-123' });
console.log(result);

전체 참조

Using @capgo/capacitor-youtube-player

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-youtube-player를 사용하여 Using @capgo/capacitor-유튜브 플레이어 이 플러그인을 사용하여 @capgo/capacitor-youtube-player @capgo/capacitor-youtube-player 시작하기 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities @capgo/capacitor-live-activities @capgo/capacitor-live-activities Using @capgo/capacitor-video-player Using @capgo/capacitor-video-player Using @capgo/capacitor-video-player Using @capgo/capacitor-youtube-player

FAQ

YouTube Player 플러그인 FAQ

YouTube Player 플러그인을 Capacitor 앱에 설치하는 방법은?

Run "bun add @capgo/capacitor-youtube-player" (or "npm install @capgo/capacitor-youtube-player"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-youtube-player" in your app code.

리액트, 뷰, 앵귤러와 함께 @capgo/capacitor-youtube-player가 작동합니까?

네. YouTube Player는 Capacitor 패키지이므로 Capacitor 내부에서 실행되는 모든 웹 프레임워크와 함께 작동합니다. 이에는 Ionic, React, Vue, Angular, Svelte 및 단순한 JavaScript가 포함됩니다.

어떤 Capacitor 버전을 @capgo/capacitor-youtube-player이 지원하는지 궁금하십니까?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-youtube-player은 무료이고 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-youtube-player/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code를 업데이트할 수 있나요?

code를 업데이트하면 native code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo live updates와 함께 즉시 배포할 수 있습니다.

앱 리뷰 대기 없이 YouTube Player 변경을 배포

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트 사용자에게 몇 분 안에 자바스크립트, HTML 및 CSS 변경을 푸시합니다.

시작하기 Capgo