이 패키지에는 YouTube Android Player API의 모든 인터페이스 및 클래스가 포함되어 있습니다. 이 API를 사용하면 YouTube 동영상을 간편하게 재생할 수 있고 Android 애플리케이션에 YouTube 동영상의 미리보기 이미지를 표시할 수 있습니다.
동영상을 재생하는 방법은 두 가지가 있습니다. 첫 번째 옵션은
YouTubePlayerFragment나 YouTubePlayerView를 View 계층에 배치한 다음
YouTubePlayer를 사용하여
View에서 동영상 재생을 제어하는 것입니다. 이렇게 하면 재생 환경을 세밀하게 조정할 수
있습니다. 예를 들어 동영상의 크기를 결정하고 플레이어의 이벤트를 듣고
재생을 제어할 수 있습니다.
두 번째 옵션은 개별 활동에서 동영상을 재생할 YouTubeStandalonePlayer를
사용하는 것입니다. 이 방법은 더 간편하지만 동영상 재생과 관련된
유연성과 제어 능력이 줄어듭니다. 또한
StandalonePlayer는 전체 화면 모드 또는 라이트박스 모드 두 가지를 모두 지원합니다.
라이트박스 모드에서 플레이어를 실행하는 활동은 계속 플레이어 뒤에
약간 흐리게 표시됩니다.
YouTube 미리보기 이미지를 표시하려면 view 계층에 YouTubeThumbnailView를
배치한 다음 YouTubeThumbnailLoader를 사용하여 단일 동영상 미리보기 이미지
또는 전체 재생목록을 로드합니다.
이 API는 특정 부분을 사용하는 방법에 대해 설명하는 샘플 집합과
함께 배포되었습니다. 샘플은 배포된 zip 파일의 sample
디렉토리에 있습니다.
인터페이스
| YouTubePlayer | YouTubePlayer는 YouTube 동영상 재생을 로드, 재생 및 제어하기 위한 메소드를 제공합니다. |
| YouTubePlayer.OnFullscreenListener | 사용자가 전체 화면 버튼을 클릭하거나 setFullscreen(boolean)을 호출함으로써 플레이어가
전체 화면 사용 또는 사용 중지 사이에서 전환할 때 호출되는 콜백에 대한 인터페이스
정의입니다. |
| YouTubePlayer.OnInitializedListener | 플레이어가 초기화되거나 초기화되지 못했을 때 호출되는 콜백에 대한 인터페이스 정의입니다. |
| YouTubePlayer.PlaybackEventListener | 동영상 재생 이벤트가 발생하면 호출되는 콜백에 대한 인터페이스 정의입니다. |
| YouTubePlayer.PlayerStateChangeListener | 높은 수준의 플레이어 상태가 변경되면 호출되는 콜백에 대한 인터페이스 정의입니다. |
| YouTubePlayer.PlaylistEventListener | 재생목록과 관련된 이벤트가 발생하면 호출되는 콜백에 대한 인터페이스 정의입니다. |
| YouTubePlayer.Provider | 이 인터페이스를 구현하는 클래스는 YouTubePlayer 인스턴스를 제공할 수 있습니다. |
| YouTubeThumbnailLoader | YouTubeThumbnailLoader는 YouTube 미리보기 이미지를 YouTubeThumbnailView로 로드하는 메소드를 제공합니다. |
| YouTubeThumbnailLoader.OnThumbnailLoadedListener | 미리보기 이미지가 로드되면 호출되는 리스너에 대한 인터페이스 정의입니다. |
| YouTubeThumbnailView.OnInitializedListener | 미리보기 이미지 뷰가 초기화되거나 초기화되지 못할 때 호출되는 콜백의 정의를 포함한 인터페이스입니다. |
클래스
| YouTubeApiServiceUtil | 이 기기에서 YouTube Player API 서비스 사용 가능 여부 및 최신 상태 여부를 확인하기 위한 유틸리티 클래스입니다. |
| YouTubeBaseActivity | UI에 직접 YouTubePlayerView 뷰를 통합하려는 모든 활동은 이 활동을
확장해야 합니다. |
| YouTubeIntents | 기본 YouTube 애플리케이션 내의 특정 활동으로 이동하는 인텐트를 만드는 정적 메소드 컬렉션입니다. |
| YouTubePlayerFragment | YouTubePlayerView를 포함한 프래그먼트입니다. |
| YouTubePlayerSupportFragment | YouTubePlayerFragment의 지원 프래그먼트 버전입니다. |
| YouTubePlayerView | YouTube 동영상을 표시하기 위한 뷰입니다. |
| YouTubeStandalonePlayer | 이 클래스는 독립형 플레이어 활동에서 YouTube 동영상을 재생할 인텐트를 만듭니다. |
| YouTubeThumbnailView | 특정 YouTube 동영상 또는 YouTube 재생목록의 YouTube 미리보기 이미지를 표시하는 데 사용할 수 있는 뷰입니다. |
Enum
| YouTubeInitializationResult | YouTube API 서비스 초기화의 결과를 제공합니다. |
| YouTubePlayer.ErrorReason | YouTubePlayer에 발생한 오류의 원인을 설명합니다. |
| YouTubePlayer.PlayerStyle | 플레이어에서 사용 가능한 다양한 스타일입니다. |
| YouTubeThumbnailLoader.ErrorReason | YouTubeThumbnailView에 발생한 오류의 원인을 설명합니다. |