Skip to main content
플러그인으로 돌아가기
@capgo/capacitor-유튜브 플레이어
튜토리얼
@capgo/capacitor-유튜브 플레이어

유튜브 플레이어

유튜브 비디오를 완전한 플레이어 API 제어와 이벤트 처리와 함께 임베드하세요.

라이브 업데이트 제품 페이지

Capgo 마케팅 웹사이트

Capgo 마케팅 웹사이트

Download the Capgo app, then scan the QR code.

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

유튜브 플레이어 플러그인 사용 (@capgo/capacitor-youtube-player)

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

설치

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

이 플러그인이 제공하는 것

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

메인 웹뷰 REFERER 패치

활성화 patchRefererHeader YouTube 콘텐츠가 플러그인에서 작동하지만 Capacitor의 메인 WebView에서 실패하는 경우 Referer YouTube는 브라우저와 같은 환경을 기대하기 때문입니다.

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

이 패치는 youtube.com, youtube-nocookie.comyoutu.be 요청에만 적용됩니다. 기존 요청 수준 Referer 헤더는 보존되고, refererHeader omitted일 때 기본값이 https://www.youtube.com 예시 사용법

새로운 YouTube 플레이어 인스턴스를 초기화합니다.

initialize

플레이어 인스턴스를 삭제하고 리소스를 해제합니다.

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

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

destroy

비디오 재생을 중지하고 로딩을 취소합니다. 이 기능을 자주 사용하지 마세요 - pauseVideo()는 일반적으로 선호됩니다.

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

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

Stop video playback and cancel loading. Use this sparingly - pauseVideo() is usually preferred.

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

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

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

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

await YoutubePlayer.playVideo({} as PlayerIdOptions);

전체 참조

Using @capgo/capacitor-youtube-player

이미 사용 중인 경우 Using @capgo/capacitor-youtube-player @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-youtube-player @capgo/capacitor-youtube-player for the implementation detail in @capgo/capacitor-youtube-player, __CAPGO_KEEP_0__ Capacitor YouTube Player Using @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities for the implementation detail in @capgo/capacitor-live-activities, and Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player.