YouTube Android Player API

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
This SDK is no longer supported or maintained by YouTube. It will be fully deprecated on or after May 1, 2023. This SDK should not be used, due to security vulnerabilities. Please use the YouTube IFrame Player API instead.

YouTube Android Player API를 사용하면 Android 애플리케이션에 동영상 재생 기능을 통합할 수 있습니다. 이 API는 YouTube 동영상(및 재생목록)을 로드하고 재생하는 방식 및 동영상 재생 환경을 맞춤설정하고 제어하는 방식을 정의합니다.

API를 사용하면 애플리케이션의 UI에 삽입된 플레이어 보기에 동영상을 로드하거나 실행할 수 있습니다. 그런 다음 재생을 프로그래밍 방식으로 제어할 수 있습니다. 예를 들어 현재 로드된 동영상을 재생, 일시중지하거나 동영상의 특정 지점으로 이동할 수 있습니다.

또한 이벤트 리스너를 등록하여 플레이어에서 동영상 로드 또는 플레이어 상태 변경 같은 특정 이벤트와 관련된 콜백을 가져올 수 있습니다. 마지막으로 API는 방향 변경 및 전체 화면 재생으로 전환을 지원하는 도우미 기능도 갖고 있습니다.

기본 원리

API 클라이언트 라이브러리는 Android 플랫폼용 YouTube 앱의 일부로 배포된 서비스와 상호작용합니다. 클라이언트 라이브러리는 공간을 적게 차지하므로 구축 과정에서 ProGuard를 사용하는 경우 앱의 파일 크기에 불리한 영향을 주지 않습니다.

API가 계속해서 개발되고 있으므로 API 클라이언트 라이브러리의 새 버전으로 업그레이드하면 새로 도입된 API 기능을 이용할 수 있습니다. 하지만 새 기능이나 버그 수정이 필요 없는 경우 업그레이드하지 않아도 됩니다.

또한 Google Play Store를 통해 YouTube 앱을 제공하므로 API 서비스 업데이트가 이동통신사나 OEM 시스템 이미지 업데이트의 영향을 받지 않습니다. 일반적으로 Android 2.2(Froyo) 이상을 실행 중인 기기에 Google Play Store 앱이 설치된 경우 며칠 내에 업데이트를 받게 됩니다. 이에 따라 애플리케이션은 Android 운영 체제를 기반으로 하는 대부분의 기기에서 YouTube Android Player API를 사용할 수 있습니다.

참고: API를 사용하려면 사용자는 모바일 YouTube 앱 버전 4.2.16 이상을 실행해야 합니다.

시작하기

다음 문서는 개발 환경을 설정하고 YouTube Android Player API를 사용하는 데 도움이 됩니다.

  • 다운로드 페이지에서는 API 클라이언트 라이브러리 및 JavaDocs를 다운로드하기 위한 링크를 제공합니다.

  • 애플리케이션 등록에 대한 도움말에서는 Google API 콘솔에 앱을 등록하는 방법 및 API를 사용하기 위해 필요한 Android API 키를 얻는 방법을 설명합니다.

  • 설정 도움말에서는 Eclipse 또는 IntelliJ를 사용하여 API 프로젝트를 설정하는 방법을 설명합니다.

  • 샘플 애플리케이션 개요에서는 API 다운로드에 포함된 샘플 애플리케이션을 설명합니다.

  • JavaDoc 참조 문서에서는 API의 인터페이스, 클래스, 메소드, enum에 대한 자세한 정의를 제공합니다.