메인 콘텐츠로 건너뛰기
플러그인으로 돌아가기
@capgo/capacitor-youtube-player
튜토리얼
@capgo/capacitor-youtube-player

유튜브 플레이어

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

가이드

YouTube 플레이어 튜토리얼

@capgo/capacitor-youtube-player를 사용하여 YouTube 플레이어 플러그인 인터페이스.

Capacitor에서 YouTube 비디오 재생을 제어하는 방법을 제공합니다.

설치

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

이 플러그인은 다음을 제공합니다.

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

Main WebView Referer Patch

활성화 patchRefererHeader YouTube 콘텐츠가 플러그인에서 작동하지만 Capacitor의 Main WebView에서 실패하는 경우 Referer 브라우저와 같은 헤더를 예상하는 YouTube

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

, youtube.com, youtube-nocookie.com, and youtu.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

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

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

await YoutubePlayer.stopVideo({} as PlayerIdOptions);

playVideo

전체 참조

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

await YoutubePlayer.playVideo({} as PlayerIdOptions);

__CAPGO_KEEP_0__:

capgo/capacitor-youtube-player를 사용하여 계속 진행하세요.

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-youtube-player를 사용 중이시면 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, Getting Started의 구현 세부 사항을 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities를 사용하여 capgo/capacitor-live-activities의 네이티브 기능을 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.