플레이어 제어

useYouTubePlayer가 반환하는 플레이어 객체에는 직접 호출할 수 있는 메서드, 비동기 getter, 동적 비디오 로드 메서드가 포함됩니다.

비동기 getter 메서드는 플레이어가 준비된 뒤 사용하는 것을 권장합니다. YoutubeView가 내부 controller를 연결하기 전에는 getter가 undefined를 반환할 수 있으므로, 값에 의존해야 한다면 ready 이벤트 이후에 호출하세요.

재생 제어

player.play();
player.pause();
player.stop();
player.seekTo(30, true);

볼륨과 음소거

player.setVolume(50);
player.mute();
player.unMute();

const volume = await player.getVolume();
const muted = await player.isMuted();

상태와 비디오 정보 조회

const [currentTime, duration, state, loadedFraction, url, embedCode] = await Promise.all([
  player.getCurrentTime(),
  player.getDuration(),
  player.getPlayerState(),
  player.getVideoLoadedFraction(),
  player.getVideoUrl(),
  player.getVideoEmbedCode(),
]);

재생 속도

const currentRate = await player.getPlaybackRate();
const availableRates = await player.getAvailablePlaybackRates();

player.setPlaybackRate(1.5);

다른 비디오 로드 또는 큐잉

player.loadVideoById('M7lc1UVf-VE');
player.cueVideoById('M7lc1UVf-VE', 30);
  • loadVideoById는 바로 로드를 시작합니다.
  • cueVideoById는 재생 없이 다음 비디오를 준비합니다.

크기 변경

player.setSize(640, 360);

초기 렌더 이후 imperative하게 크기를 바꿔야 할 때 유용합니다.