개요
“개요” 섹션플레이어 API 제어와 이벤트 처리를 모두 지원하는 YouTube 비디오 임베드
시작하기 initialize() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션initialize- 새 YouTube 플레이어 인스턴스를 초기화합니다.destroy- 플레이어 인스턴스를 제거하고 리소스를 해제합니다.stopVideo- 비디오 재생을 중지하고 로딩을 취소합니다. 가급적 사용을 자제하세요. 보통은 pauseVideo()가 더 적합합니다.playVideo- 현재 대기 중이거나 로드된 비디오를 재생합니다. 최종 플레이어 상태는 PLAYING (1)이 됩니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
initialize | 새 YouTube player 인스턴스를 초기화합니다. |
destroy | player 인스턴스를 제거하고 리소스를 해제합니다. |
stopVideo | 비디오 재생을 중단하고 로딩을 취소합니다. 가급적 사용을 자제하고, 보통은 pauseVideo()를 사용하세요. |
playVideo | 현재 대기 중이거나 로드된 비디오를 재생합니다. 최종 player 상태는 PLAYING (1)이 됩니다. |
pauseVideo | 현재 재생 중인 비디오를 일시 정지합니다. 이미 ENDED (0) 상태가 아니라면 최종 상태는 PAUSED (2)가 됩니다. |
seekTo | 비디오의 특정 시점으로 이동합니다. 일시 정지 상태라면 정지 상태를 유지하며, 재생 중이라면 이동 후 계속 재생됩니다. |
loadVideoById | YouTube ID로 비디오를 로드하고 재생합니다. |
cueVideoById | 재생하지 않고 ID로 비디오를 대기시킵니다. 썸네일을 로드하고 player를 준비하지만, playVideo()가 호출되기 전까지는 비디오를 요청하지 않습니다. |
loadVideoByUrl | 전체 URL로 비디오를 로드하고 재생합니다. |
cueVideoByUrl | 재생하지 않고 URL로 비디오를 대기시킵니다. |
cuePlaylist | 재생하지 않고 플레이리스트를 큐에 올립니다. 플레이리스트를 로드하고 첫 번째 영상을 준비합니다. |
loadPlaylist | 플레이리스트를 로드하고 재생합니다. |
nextVideo | 플레이리스트의 다음 영상을 재생합니다. |
previousVideo | 플레이리스트의 이전 영상을 재생합니다. |
playVideoAt | 인덱스로 플레이리스트의 특정 영상을 재생합니다. |
mute | 플레이어 오디오를 음소거합니다. |
unMute | 플레이어 오디오의 음소거를 해제합니다. |
isMuted | 플레이어가 현재 음소거 상태인지 확인합니다. |
setVolume | 플레이어 볼륨을 설정합니다. |
getVolume | 현재 플레이어 볼륨을 가져옵니다. 음소거 상태여도 볼륨 값을 반환합니다. |
setSize | 플레이어 크기를 픽셀 단위로 설정합니다. |
getPlaybackRate | 현재 재생 속도를 가져옵니다. |
setPlaybackRate | 재생 속도를 설정합니다. |
getAvailablePlaybackRates | 현재 비디오의 사용 가능한 재생 속도 목록을 가져옵니다. |
setLoop | 플레이리스트 반복 재생을 활성화하거나 비활성화합니다. 활성화 시 마지막 비디오가 끝나면 처음부터 다시 재생됩니다. |
setShuffle | 플레이리스트 셔플을 활성화하거나 비활성화합니다. |
getVideoLoadedFraction | 버퍼링된 비디오의 비율을 가져옵니다. 비추천되는 getVideoBytesLoaded/getVideoBytesTotal보다 신뢰할 수 있습니다. |
getPlayerState | 플레이어의 현재 상태를 가져옵니다. |
getAllPlayersEventsState | 모든 활성 플레이어의 이벤트 상태를 가져옵니다. 여러 플레이어 인스턴스를 추적하는 데 유용합니다. |
getCurrentTime | 현재 재생 위치를 초 단위로 가져옵니다. |
toggleFullScreen | 전체 화면 모드를 켜거나 끕니다. |
getPlaybackQuality | 현재 재생 품질을 가져옵니다. |
setPlaybackQuality | 권장 재생 품질을 설정합니다. 네트워크 상태에 따라 실제 품질이 달라질 수 있습니다. |
getAvailableQualityLevels | 현재 비디오의 사용 가능한 품질 수준 목록을 가져옵니다. |
getDuration | 현재 비디오의 재생 시간을 초 단위로 가져옵니다. |
getVideoUrl | 현재 비디오의 YouTube.com URL을 가져옵니다. |
getVideoEmbedCode | 현재 비디오의 code 임베드를 가져옵니다. HTML iframe 임베드 code를 반환합니다. |
getPlaylist | 현재 재생 목록의 비디오 ID 배열을 가져옵니다. |
getPlaylistIndex | 재생 목록에서 현재 재생 중인 비디오의 인덱스를 가져옵니다. |
getIframe | 플레이어의 iframe DOM 요소를 가져옵니다. Web 플랫폼 전용입니다. |
addEventListener | 플레이어에 이벤트 리스너를 추가합니다. Web 플랫폼 전용입니다. |
removeEventListener | 플레이어에서 이벤트 리스너를 제거합니다. Web 플랫폼 전용입니다. |
getPluginVersion | 플러그인 버전 번호를 가져옵니다. 플랫폼별 버전 정보를 반환합니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-youtube-player.
@capgo/capacitor-youtube-player에서 계속하기
“@capgo/capacitor-youtube-player에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-youtube-player 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-youtube-player 사용하기 @capgo/capacitor-youtube-player 사용 시 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.
