개요
“개요” 섹션플레이어 API 제어와 이벤트 처리를 완전히 지원하는 YouTube 비디오 임베드
시작하기 initialize() 그리고 아래에 나열된 다른 핵심 메서드도 있습니다.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS에서는 | 예 | 네이티브 |
| Android | 예 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 가드하세요 |
핵심 기능
“핵심 기능” 섹션initialize- 새로운 YouTube player 인스턴스를 초기화합니다.destroy- player 인스턴스를 제거하고 리소스를 해제합니다.stopVideo- 비디오 재생을 중단하고 로딩을 취소합니다. 이 메서드는 가급적 사용을 지양하고 pauseVideo()를 사용하는 것이 좋습니다.playVideo- 현재 대기 중이거나 로드된 비디오를 재생합니다. 최종 player 상태는 PLAYING (1)이 됩니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
initialize | 새 YouTube player 인스턴스를 초기화합니다. |
destroy | player 인스턴스를 제거하고 리소스를 해제합니다. |
stopVideo | 비디오 재생을 중단하고 로딩을 취소합니다. 이 메서드는 가급적 사용을 자제하고 pauseVideo()를 사용하는 것이 좋습니다. |
playVideo | 현재 대기 중이거나 로드된 비디오를 재생합니다. 최종 player 상태는 PLAYING (1)이 됩니다. |
pauseVideo | 현재 재생 중인 비디오를 일시 정지합니다. 이미 ENDED (0) 상태가 아니라면 최종 player 상태는 PAUSED (2)가 됩니다. |
seekTo | 비디오의 특정 시간으로 이동합니다. player가 일시 정지 상태라면 정지 상태를 유지하며, 재생 중이라면 이동 후 계속 재생됩니다. |
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 | 플러그인 버전 번호를 가져옵니다. 플랫폼별 버전 정보를 반환합니다. |
기준 소스
“기준 소스” 섹션이 레퍼런스는 다음에서 동기화됩니다: 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 플러그인 디렉토리의 제품 워크플로우를 보려면, Capgo 제공 Capacitor 플러그인 Capgo 제공 Capacitor 플러그인의 구현 세부 사항을 보려면, 플러그인 추가 및 업데이트 플러그인 추가 및 업데이트의 구현 세부 사항을 확인하고, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우를 확인하세요.
