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

유튜브 플레이어

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

장치에서 테스트

앱을 다운로드하고 QR코드를 스캔하세요.

애플 스토어에서 __CAPGO_KEEP_0__ 다운로드

Download the Capgo app, then scan the 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에서 실패하는 경우 Referer 브라우저와 같은 헤더를 기대하기 때문입니다.

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

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

예시 사용

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';

await YoutubePlayer.destroy({} as PlayerIdOptions);

stopVideo

비디오 재생을 중단하고 로딩을 취소합니다. 이 메서드를 사용할 때는 pauseVideo()를 사용하는 것을 권장합니다.

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, 시작하기 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.