YouTubePlayer

public interface
YouTubePlayer
com.google.android.youtube.player.YouTubePlayer

개요

YouTubePlayer는 YouTube 동영상 재생을 로드, 재생 및 제어하기 위한 메소드를 제공합니다. YouTubePlayerFragment 또는 YouTubePlayerView 같은 YouTubePlayer.Provider에서 initialize를 호출하여 이 클래스의 인스턴스를 가져옵니다.

loadVideo(String) 또는 cuePlaylist(String) 같은 메소드에서 필요한 동영상 및 재생목록 ID는  YouTube Data API에서 제공합니다. 이 API에 대한 자세한 내용은 다음을 참조하세요. https://developers.google.com/youtube/

YouTubePlayer는 플레이어의 YouTubePlayer.Provider에서 자동으로 관리하는 상태 저장을 지원합니다. 저장된 상태는 현재 YouTubePlayer.PlayerStyle 또는 전체화면 제어 플래그 등 플레이어 구성, 로드한 동영상, 현재 재생 위치를 포함합니다. 상태는 플레이어에서 설정될 수 있는 리스너는 포함하지 않으므로 플레이어를 다시 만든 후에는 리스너를 다시 설정해야 합니다.

UI 스레드에서 YouTubePlayer 개체의 메소드만 호출해야 합니다.

요약

중첩된 클래스
enum YouTubePlayer.ErrorReason YouTubePlayer에 발생한 오류의 원인을 설명합니다.
interface YouTubePlayer.OnFullscreenListener 사용자가 전체 화면 버튼을 클릭하거나 setFullscreen(boolean)을 호출하여 플레이어가 전체화면 사용 또는 사용 중지 사이에서 전환할 때 호출되는 콜백에 대한 인터페이스 정의입니다. 
interface YouTubePlayer.OnInitializedListener 플레이어가 초기화되거나 초기화되지 못할 때 호출되는 콜백에 대한 인터페이스 정의입니다. 
interface YouTubePlayer.PlaybackEventListener 동영상 재생 이벤트가 발생하면 호출되는 콜백에 대한 인터페이스 정의입니다.
interface YouTubePlayer.PlayerStateChangeListener 높은 수준의 플레이어 상태가 변경되면 호출되는 콜백에 대한 인터페이스 정의입니다.
enum YouTubePlayer.PlayerStyle 플레이어에서 사용 가능한 다양한 스타일입니다.
interface YouTubePlayer.PlaylistEventListener 재생목록과 관련된 이벤트가 발생하면 호출되는 콜백에 대한 인터페이스 정의입니다.
interface YouTubePlayer.Provider 이 인터페이스를 구현하는 클래스는 YouTubePlayer 인스턴스를 제공할 수 있습니다. 
상수
int FULLSCREEN_FLAG_ALWAYS_FULLSCREEN_IN_LANDSCAPE 기기가 가로 방향이 될 때마다 플레이어가 자동으로 전체화면이 되도록 하는 setFullscreenControlFlags(int)의 플래그입니다.
int FULLSCREEN_FLAG_CONTROL_ORIENTATION 방향을 자동으로 제어하도록 설정하는 setFullscreenControlFlags(int)의 플래그입니다.
int FULLSCREEN_FLAG_CONTROL_SYSTEM_UI 시스템 UI를 자동으로 제어하도록 설정하는 setFullscreenControlFlags(int)의 플래그입니다.
int FULLSCREEN_FLAG_CUSTOM_LAYOUT 기본 전체화면 레이아웃 핸들러를 사용하지 못하도록 설정하고, 전체화면 레이아웃 전환을 수동으로 제어하게 하는 setFullscreenControlFlags(int)의 플래그입니다.
공개 메소드
abstract void addFullscreenControlFlag(int controlFlag)
이미 설정된 플래그를 변경하지 않지만 현재 설정된 플래그에 제공된 플래그를 추가만 하는 setFullscreenControlFlags(int)의 변형입니다.
abstract void cuePlaylist(String playlistId)
지정된 재생목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.
abstract void cuePlaylist(String playlistId, int startIndex, int timeMillis)
지정된 재생목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.
abstract void cueVideo(String videoId)
지정한 동영상의 미리보기 이미지를 로드하고 플레이어가 동영상을 재생하도록 준비하지만 play()를 호출하기 전에는 동영상 스트림을 다운로드하지 않습니다.
abstract void cueVideo(String videoId, int timeMillis)
지정한 동영상의 미리보기 이미지를 로드하고 플레이어가 동영상을 재생하도록 준비하지만 play()를 호출하기 전에는 동영상 스트림을 다운로드하지 않습니다.
abstract void cueVideos(List<String> videoIds)
동영상 목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.
abstract void cueVideos(List<String> videoIds, int startIndex, int timeMillis)
동영상 목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.
abstract int getCurrentTimeMillis()
재생 중인 동영상의 시작부터 현재 경과된 시간을 가져옵니다.
abstract int getDurationMillis()
현재 로드한 동영상의 재생 시간을 가져옵니다.
abstract int getFullscreenControlFlags()
현재 설정된 전체화면 제어 플래그를 가져옵니다.
abstract boolean hasNext()
현재 로드한 재생목록에 다음 동영상이 있는지를 확인합니다.
abstract boolean hasPrevious()
현재 로드한 재생목록에 이전 동영상이 있는지를 확인합니다.
abstract boolean isPlaying()
플레이어가 현재 재생 중인지 확인합니다.
abstract void loadPlaylist(String playlistId)
지정한 재생목록을 로드하고 재생합니다.
abstract void loadPlaylist(String playlistId, int startIndex, int timeMillis)
지정한 재생목록을 로드하고 재생합니다.
abstract void loadVideo(String videoId)
지정한 동영상을 로드하고 재생합니다.
abstract void loadVideo(String videoId, int timeMillis)
지정한 동영상을 로드하고 재생합니다.
abstract void loadVideos(List<String> videoIds, int startIndex, int timeMillis)
동영상 목록을 로드하고 재생합니다.
abstract void loadVideos(List<String> videoIds)
동영상 목록을 로드하고 재생합니다.
abstract void next()
로드한 재생목록의 다음 동영상을 재생합니다.
abstract void pause()
현재 재생 중인 동영상을 일시중지합니다.
abstract void play()
현재 신호를 주거나 로드된 동영상의 재생을 시작합니다.
abstract void previous()
로드한 재생목록의 이전 동영상을 재생합니다.
abstract void release()
동영상 로드 또는 재생을 중지하고 이 YouTubePlayer에서 사용한 시스템 리소스를  해제합니다.
abstract void seekRelativeMillis(int milliSeconds)
지정한 시간(초)만큼 앞으로 또는 뒤로 찾습니다.
abstract void seekToMillis(int milliSeconds)
동영상에서 지정한 시간을 찾습니다.
abstract void setFullscreen(boolean fullscreen)
플레이어가 전체화면으로 배치되도록 합니다.
abstract void setFullscreenControlFlags(int controlFlags)
전체화면 모드가 전환될 때 자동 동작을 제어합니다.
abstract void setManageAudioFocus(boolean manage)
플레이어에서 재생 주기의 일환으로 오디오 포커스를 처리할지 여부를 지정합니다.
abstract void setOnFullscreenListener(YouTubePlayer.OnFullscreenListener listener)
abstract void setPlaybackEventListener(YouTubePlayer.PlaybackEventListener listener)
abstract void setPlayerStateChangeListener(YouTubePlayer.PlayerStateChangeListener listener)
abstract void setPlayerStyle(YouTubePlayer.PlayerStyle style)
플레이어에 대한 사용자의 제어 수준에 영향을 주는 플레이어의 현재 스타일을  설정합니다.
abstract void setPlaylistEventListener(YouTubePlayer.PlaylistEventListener listener)
abstract void setShowFullscreenButton(boolean show)
플레이어 컨트롤에 전체화면 버튼을 표시하거나 숨깁니다.

상수

public static final int FULLSCREEN_FLAG_ALWAYS_FULLSCREEN_IN_LANDSCAPE

기기가 가로 방향이 될 때마다 플레이어가 자동으로 전체화면이 되도록 하는  setFullscreenControlFlags(int)의 플래그입니다. 액티비티가 세로 모드로 잠겨 있고  매니페스트에 세로 모드로 지정된 경우에만 이 플래그를 설정할 수 있습니다.

액티비티에 가로 레이아웃이 없지만 동영상을 전체화면으로 볼 때만  가로 방향으로 설정하려는 경우에 이 플래그가 유용합니다.

이 플래그를 설정하면 사용자가 Activity.setRequestedOrientation(int)을 사용하여  기기를 가로 방향으로 회전할 때마다 액티비티의 화면 방향이 가로로  바뀝니다. 전체화면을 종료하면 요청한 화면 방향은 원래 값으로 재설정됩니다.

이 플래그에서는 FULLSCREEN_FLAG_CONTROL_ORIENTATION도 설정해야 합니다.

상수 값: 4 (0x00000004)

public static final int FULLSCREEN_FLAG_CONTROL_ORIENTATION

방향을 자동으로 제어하도록 설정하는 setFullscreenControlFlags(int)의 플래그입니다.

전체화면 모드가 될 때 가로 방향으로 바꾸고 전체화면을 종료하면 원래 방향 설정으로 바꾸는 동작입니다. 또한 기기가 세로 방향으로 회전하면 자동으로 전체화면을 종료하도록 구현됩니다. 애플리케이션이 가로 방향으로 잠겨 있거나 세로 방향 전체 화면이 필요하지 않은 한 일반적으로 이렇게 설정해야 합니다.

상수 값: 1 (0x00000001)

public static final int FULLSCREEN_FLAG_CONTROL_SYSTEM_UI

시스템 UI를 자동으로 제어하도록 설정하는 setFullscreenControlFlags(int)의 플래그입니다.

이 플래그를 설정하면 시스템 UI는 사용자 상호작용이 생기지 않으면 표시되지 않고, 사용자가 기기와  상호작용할 때마다 플레이어 컨트롤과 동시에 다시 표시됩니다.

상태 표시줄과 기기에 있는 다른 표시줄(탐색 표시줄, 시스템 표시줄 등)이 표시되는 경우,  시스템 UI는 상태 표시줄을 포함합니다.

애플리케이션이 ActionBar을 표시하는 경우 작업 표시줄이 Window#FEATURE_ACTION_BAR_OVERLAY를 사용하여  오버레이로 만들어지면 사용자의 상호작용이 있을 때 플레이어의 컨트롤 및 다른 시스템 UI와 동시에 표시되거나 숨겨집니다. 오버레이로 만들어지지 않은 경우 전체화면 세션  동안 표시되지 않습니다.

시스템 UI를 수동으로 제어해야 할 필요가 없다면 일반적으로 이렇게 설정해야 합니다.

상수 값: 2 (0x00000002)

public static final int FULLSCREEN_FLAG_CUSTOM_LAYOUT

기본 전체화면 레이아웃 핸들러를 사용하지 못하도록 설정하고, 전체화면 레이아웃 전환을 수동으로 제어하게 하는 setFullscreenControlFlags(int)의 플래그입니다. 이 옵션을 사용하여 맞춤 전체화면 레이아웃을 구현할 수 있을 뿐만 아니라, 기본 전체화면 동작에서 버퍼링이 다시 발생하지 않도록 할 수 있는 이점이 있습니다.

사용자가 전체화면 버튼을 클릭하거나 setFullscreen(boolean)을 호출하여 전체화면이 전환될 때 사용하려는 전체화면 레이아웃이 있는 경우 이 플래그를 사용합니다.

기본 전체화면 동작은 전체화면 대화상자에 동영상 플레이어를 배치합니다. 그러나, 이 기본 동작을 사용하려면 전체화면으로 전환하거나 되돌아갈 때 동영상을 다시 버퍼링해야 합니다. 이렇게 다시 버퍼링하지 않으려면 개발자는 이 플래그를 설정하여 전체화면 이벤트를 직접 처리하는 것이 좋습니다.

맞춤 전체화면 동작을 구현하는 애플리케이션은 다음 두 가지를 따라야 합니다.

  • 플레이어의 뷰는 onFullscreen(boolean)이 호출될 때마다 애플리케이션 창의 전체 공간을 차지합니다.
  • 방향이 가로로 변경될 때 액티비티를 다시 만들지 않습니다. 세로 모드를 지원하는 액티비티에서 이렇게 하려면 액티비티가 orientation, keyboardHidden, screenSize 등 애플리케이션의 매니페스트에서 일부 구성의 변경을 자동으로 처리하도록 지정해야 합니다.

이 플래그는 방향과 시스템 UI 제어에 영향을 미치지 않습니다. 이 플래그를 설정하여 레이아웃을 직접 제어하더라도 FULLSCREEN_FLAG_CONTROL_ORIENTATIONFULLSCREEN_FLAG_CONTROL_SYSTEM_UI를 설정한 경우 YouTubePlayer는 방향과 시스템 UI 둘 모두를 자동으로 계속하여 제어합니다.

상수 값: 8 (0x00000008)

공개 메소드

public abstract void addFullscreenControlFlag (int controlFlag)

이미 설정된 플래그를 변경하지 않지만 현재 설정된 플래그에 제공된 플래그를 추가만 하는 setFullscreenControlFlags(int)의 변형입니다. setFullscreenControlFlags(getFullscreenControlFlags() | controlFlag)와 같습니다.

public abstract void cuePlaylist (String playlistId)

지정된 재생목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.

매개변수
playlistId YouTube Data API에서 반환될 때 신호를 줄 재생목록의 ID입니다.

public abstract void cuePlaylist (String playlistId, int startIndex, int timeMillis)

지정된 재생목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.

사용자가 재생을 누르거나 play()가 호출될 때 동영상 목록에서 지정된 인덱스가 있는 동영상을 지정된 시간 위치부터 시작하며 재생합니다.

매개변수
playlistId YouTube Data API에서 반환될 때 신호를 줄 재생목록의 ID입니다.
startIndex 신호를 줄 첫 번째 동영상 재생목록의 인덱스입니다.
timeMillis 신호를 준 첫 번째 동영상에서 재생을 시작해야 하는 위치를 나타내는 시간(밀리초)입니다.

public abstract void cueVideo (String videoId)

지정한 동영상의 미리보기 이미지를 로드하고 플레이어가 동영상을 재생하도록 준비하지만 play()를 호출하기 전에는 동영상 스트림을 다운로드하지 않습니다.

매개변수
videoId YouTube Data API에서 반환될 때 신호를 줄 동영상의 ID입니다.

public abstract void cueVideo (String videoId, int timeMillis)

지정한 동영상의 미리보기 이미지를 로드하고 플레이어가 동영상을 재생하도록 준비하지만 play()를 호출하기 전에는 동영상 스트림을 다운로드하지 않습니다.

사용자가 재생을 누르거나 play()가 호출될 때 동영상에서 지정된 시간 위치부터 재생을 시작합니다.

매개변수
videoId YouTube Data API에서 반환될 때 신호를 줄 동영상의 ID입니다.
timeMillis 동영상에서 재생을 시작해야 하는 위치를 나타내는 시간(밀리초)입니다.

public abstract void cueVideos (List<String> videoIds)

동영상 목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는 동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.

매개변수
videoIds YouTube Data API에서 반환될 때 신호를 줄 YouTube 동영상 ID 목록입니다.

public abstract void cueVideos (List<String> videoIds, int startIndex, int timeMillis)

동영상 목록에 신호를 주지만 play() 또는 seekToMillis(int)를 호출하기 전에는  동영상 스트림을 다운로드하거나 재생을 시작하지 않습니다.

사용자가 재생을 누르거나 play()가 호출될 때 지정된 인덱스가 있는 동영상을  지정된 시간 위치부터 시작하며 재생합니다.

매개변수
videoIds YouTube Data API에서 반환될 때 신호를 줄 YouTube 동영상 ID 목록입니다.
startIndex 신호를 줄 첫 번째 동영상 목록의 인덱스입니다.
timeMillis 신호를 준 첫 번째 동영상에서 재생을 시작해야 하는 위치를 나타내는  시간(밀리초)입니다.

public abstract int getCurrentTimeMillis ()

재생 중인 동영상의 시작부터 현재 경과된 시간을 가져옵니다.

반환
  • 재생 중인 동영상의 시작부터 현재 경과된 시간. 결과는 동영상 로드를 마친 후에만 명확하게 나타납니다.
참고 항목

public abstract int getDurationMillis ()

현재 로드된 동영상의 재생 시간을 가져옵니다.

반환
  • 현재 로드된 동영상의 재생 시간(밀리초). 결과는 동영상이 로드를 마친 후에만 나타나고 동영상이 재생을 시작할 때 좀 더 정확한 값으로 변경될 수 있습니다.

public abstract int getFullscreenControlFlags ()

현재 설정된 전체화면 제어 플래그를 가져옵니다.

public abstract boolean hasNext ()

현재 로드한 재생목록에 다음 동영상이 있는지를 확인합니다.

반환
  • 로드한 재생목록에 다음 동영상이 있으면 true, 없으면 false를 반환합니다.

public abstract boolean hasPrevious ()

현재 로드한 재생목록에 이전 동영상이 있는지를 확인합니다.

반환
  • 로드한 재생목록에 이전 동영상이 있으면 true, 없으면 false를 반환합니다.

public abstract boolean isPlaying ()

플레이어가 현재 재생 중인지 확인합니다.

반환
  • 플레이어가 현재 재생 중이거나 재생 상태에서 버퍼링 중인 경우 true, 아니면 false를 반환합니다.

public abstract void loadPlaylist (String playlistId)

지정한 재생목록을 로드하고 재생합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
playlistId YouTube Data API에서 반환될 때 재생할 재생목록의 ID입니다.

public abstract void loadPlaylist (String playlistId, int startIndex, int timeMillis)

지정한 재생목록을 로드하고 재생합니다. 지정된 인덱스가 있는 동영상을 지정된 시간 위치부터  시작하며 재생합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
playlistId YouTube Data API에서 반환될 때 재생할 재생목록의 ID입니다.
startIndex 재생을 시작할 재생목록의 인덱스입니다.
timeMillis 재생되는 첫 번째 동영상에서 재생을 시작해야 하는 위치를 나타내는 시간(밀리초)입니다.

public abstract void loadVideo (String videoId)

지정한 동영상을 로드하고 재생합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
videoId YouTube Data API에서 반환될 때 재생할 동영상의 ID입니다.

public abstract void loadVideo (String videoId, int timeMillis)

지정한 동영상을 로드하고 재생합니다. 동영상에서 지정된 시간 위치부터 재생을 시작합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
videoId YouTube Data API에서 반환될 때 재생할 동영상의 ID입니다.
timeMillis 동영상에서 재생을 시작해야 하는 위치를 나타내는 시간(밀리초)입니다.

public abstract void loadVideos (List<String> videoIds, int startIndex, int timeMillis)

동영상 목록을 로드하고 재생합니다. 지정된 인덱스가 있는 동영상을 지정된 시간 위치부터  시작하며 재생합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
videoIds YouTube Data API에서 반환될 때 재생할 YouTube 동영상 ID 목록입니다.
startIndex 재생할 첫 번째 동영상 목록의 인덱스입니다.
timeMillis 재생되는 첫 번째 동영상에서 재생을 시작해야 하는 위치를 나타내는 시간(밀리초)입니다.

public abstract void loadVideos (List<String> videoIds)

동영상 목록을 로드하고 재생합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

매개변수
videoIds YouTube Data API에서 반환될 때 재생할 YouTube 동영상 ID 목록입니다.

public abstract void next ()

로드한 재생목록의 다음 동영상을 재생합니다.

onLoaded(String)에서 표시된 첫 번째 호출이 완료되기 전에 next() 또는 previous()를 두 번째 호출하면 무시될 수 있습니다.

Throw
NoSuchElementException 재생목록의 끝에서 이 메소드가 호출되면 이 예외가 반환됩니다.

public abstract void pause ()

현재 재생 중인 동영상을 일시중지합니다.

public abstract void play ()

현재 신호를 주거나 로드된 동영상의 재생을 시작합니다.

참고: YouTube는 기본 재생 버튼을 통해 시작된 재생 횟수만 카운트합니다.

public abstract void previous ()

로드한 재생목록의 이전 동영상을 재생합니다.

onLoaded(String)에서 표시된 첫 번째 호출이 완료되기 전에 next() 또는 previous()를 두 번째 호출하면 무시될 수 있습니다.

Throw
NoSuchElementException 재생목록의 시작 부분에서 이 메소드가 호출되면 이 예외가 반환됩니다.

public abstract void release ()

동영상 로드 또는 재생을 중지하고 이 YouTubePlayer에서 사용한 시스템 리소스를 해제합니다.

이 메소드를 호출한 후에는 이 YouTubePlayer와의 추가 상호작용은 모두 금지됩니다. 다시 재생 가능하도록 하려면 새 인스턴스를 만들어야 합니다.

public abstract void seekRelativeMillis (int milliSeconds)

지정한 시간(초)만큼 앞으로 또는 뒤로 찾습니다.

이 함수를 호출할 때 플레이어가 일시중지되거나 중지된 경우 플레이어는 같은 상태를 유지하지만 다시 재생할 때 찾은 위치부터 동영상을 시작합니다.

매개변수
milliSeconds 양수인 경우 앞으로 찾고 음수인 경우 뒤로 찾는 밀리초 숫자입니다.

public abstract void seekToMillis (int milliSeconds)

동영상에서 지정한 시간을 찾습니다.

이 함수를 호출할 때 플레이어가 일시중지되거나 중지된 경우 플레이어는 같은 상태를 유지하지만 다시 재생할 때 찾은 위치부터 동영상을 시작합니다.

매개변수
milliSeconds 찾을 시간(밀리초)입니다.

public abstract void setFullscreen (boolean fullscreen)

플레이어가 전체화면으로 배치되도록 합니다. 이 함수를 호출하면 플레이어 컨트롤 모양에 영향을 미칩니다. 예를 들어, 전체화면으로 표시하거나 종료하는 옵션을 표시하거나 현재 플레이어 크기에 더 잘 맞도록 레이아웃을 변경합니다. 참고: 이 함수를 호출하면 등록된 YouTubePlayer.OnFullscreenListeneronFullscreen(boolean) 이벤트를 실행하게 됩니다.

매개변수
fullscreen 플레이어가 전체화면인 경우 true, 아닌 경우 false를 지정합니다.

public abstract void setFullscreenControlFlags (int controlFlags)

전체화면 모드가 전환될 때 자동 동작을 제어합니다.

이 메소드를 사용하면 라이브러리에서 자동화할 수 있는 전체화면 동작의 일부를 사용하거나 사용하지 않을 수 있습니다. 예를 들어 화면 방향 제어, 전체화면 이벤트에서 시스템 UI 표시/숨기기, 기본 전체화면 레이아웃 등이 있습니다. 설정된 기본 플래그는 FULLSCREEN_FLAG_CONTROL_SYSTEM_UIFULLSCREEN_FLAG_CONTROL_ORIENTATION입니다.

매개변수
controlFlags 0, FULLSCREEN_FLAG_CONTROL_SYSTEM_UI, FULLSCREEN_FLAG_ALWAYS_FULLSCREEN_IN_LANDSCAPE, FULLSCREEN_FLAG_CUSTOM_LAYOUT의 논리합입니다. 0 값은 자동 동작 사용을 모두 중지합니다.

public abstract void setManageAudioFocus (boolean manage)

플레이어에서 재생 주기의 일환으로 오디오 포커스를 처리할지 여부를 지정합니다.

true인 경우, 플레이어는 재생을 시작하고 종료할 때에 맞춰 오디오 포커스를 요청하거나 중지하며 오디오 포커스가 손실되면 재생을 일시중지합니다. 더킹(자동 음량 조정)할 때 플레이어는 볼륨을 낮춥니다.

또한 오디오 포커스 처리에는 오디오 출력이 변경되어 오디오가 너무 커진 경우 필요에 따라 플레이어를 일시중지하는 것도 포함됩니다. (AudioManager.ACTION_AUDIO_BECOMING_NOISY를 참조하세요).

기본값은 true입니다.

매개변수
manage 오디오 포커스의 자동 처리를 사용하려면 true, 사용하지 않으려면 false를 지정합니다.

public abstract void setOnFullscreenListener (YouTubePlayer.OnFullscreenListener listener)

매개변수
listener 전체화면 전환 알림을 받을 리스너입니다.

public abstract void setPlaybackEventListener (YouTubePlayer.PlaybackEventListener listener)

매개변수
listener 등록할 리스너를 지정하거나, 이전 리스너의 등록을 취소하려면 null을 지정합니다.

public abstract void setPlayerStateChangeListener (YouTubePlayer.PlayerStateChangeListener listener)

매개변수
listener 등록할 리스너를 지정하거나, 이전 리스너의 등록을 취소하려면 null을 지정합니다.

public abstract void setPlayerStyle (YouTubePlayer.PlayerStyle style)

플레이어에 대한 사용자의 제어 수준에 영향을 주는 플레이어의 현재 스타일을 설정합니다.

매개변수
style 선택한 YouTubePlayer.PlayerStyle입니다. 기본 스타일은 DEFAULT입니다.

public abstract void setPlaylistEventListener (YouTubePlayer.PlaylistEventListener listener)

매개변수
listener 등록할 리스너를 지정하거나, 이전 리스너의 등록을 취소하려면 null을 지정합니다.

public abstract void setShowFullscreenButton (boolean show)

플레이어 컨트롤에 전체화면 버튼을 표시하거나 숨깁니다. 기본값은 전체화면 버튼을 표시하여 사용자가 전체화면 모드와 일반 모드 사이를 전환할 수 있도록 설정하는 것입니다. 동영상을 전체화면 모드로만 표시하는 경우 등 필요에 따라 이 메소드를 사용하여 전체화면 버튼을 숨길 수 있습니다.

참고: DEFAULT 플레이어 스타일에서만 이 버튼을 지원하며, 이 메소드는 다른 플레이어 스타일에는 영향을 미치지 않습니다.

매개변수
show 전체화면 버튼을 표시하려면 true, 전체화면 버튼을 숨기려면 false를 지정합니다.