com.google.android.youtube.player

このパッケージには、YouTube Android Player API のすべてのインターフェースとクラスが含まれます。この API は、Android アプリケーションでの YouTube 動画の再生や動画のサムネイル表示を容易にします。

動画を再生するには 2 つの方法があります。1 つは、YouTubePlayerFragment または YouTubePlayerViewView 階層に配置して、YouTubePlayer を使用して View で動画再生をコントロールする方法です。これにより、エクスペリエンスを細かく管理できます。たとえば動画のサイズを決定したり、プレーヤーのイベントをリッスンして、再生をコントロールすることができます。

もう 1 つの方法は個別のアクティビティで動画の再生を開始する YouTubeStandalonePlayer を使用することです。こちらの方が簡単に使用できますが、動画再生の柔軟性とコントロール機能がやや低下します。StandalonePlayer は全画面表示とライトボックスの 2 つのモードをサポートします。ライトボックス モードでは、プレーヤーを起動するアクティビティがプレーヤーの背後に淡色で表示されます。

YouTube サムネイルを表示するには YouTubeThumbnailViewview 階層に配置し、YouTubeThumbnailLoader を使用して単一の動画サムネイルまたは再生リスト全体を読み込みます。

API には、特定のパーツの使用方法を示すサンプルのセットが付属しています。これらのサンプルは、配布される zip ファイルの sample ディレクトリにあります。

インターフェース

YouTubePlayer YouTubePlayer は、YouTube 動画の読み込み、再生、制御を実行するメソッドを提供します。
YouTubePlayer.OnFullscreenListener ユーザーによる全画面ボタンのクリックまたは setFullscreen(boolean) の呼び出しによってプレーヤーの全画面表示がオンまたはオフに切り替えられた場合に呼び出されるコールバックのインターフェース定義です。
YouTubePlayer.OnInitializedListener プレーヤーの初期化に成功または失敗した場合に呼び出されるコールバックのインターフェース定義です。
YouTubePlayer.PlaybackEventListener 動画再生イベントが発生した場合に呼び出されるコールバックのインターフェース定義です。
YouTubePlayer.PlayerStateChangeListener ハイレベルなプレーヤーの状態が変化した場合に呼び出されるコールバックのインターフェース定義です。
YouTubePlayer.PlaylistEventListener 再生リストに関連するイベントが発生した場合に呼び出されるコールバックのインターフェース定義です。
YouTubePlayer.Provider このインターフェースを実装するクラスが、YouTubePlayer インスタンスを提供できます。
YouTubeThumbnailLoader YouTubeThumbnailLoader は、YouTubeThumbnailView に YouTube サムネイルを読み込むメソッドを提供します。
YouTubeThumbnailLoader.OnThumbnailLoadedListener サムネイルが読み込まれたときに呼び出されるリスナーのインターフェース定義です。
YouTubeThumbnailView.OnInitializedListener サムネイル表示の初期化が成功または失敗したときに呼び出されるコールバックの定義を含むインターフェースです。

クラス

YouTubeApiServiceUtil YouTube Player API サービスが該当の端末で使用可能であり、かつ最新であることを確認するためのユーティリティ クラスです。
YouTubeBaseActivity それ自体の UI に直接 YouTubePlayerView ビューを組み込む必要があるすべてのアクティビティは、このアクティビティを拡張する必要があります。
YouTubeIntents メインの YouTube アプリケーション内で特定のアクティビティにナビゲートするインテントを作成する静的メソッドの集まりです。
YouTubePlayerFragment YouTubePlayerView を含むフラグメント。
YouTubePlayerSupportFragment YouTubePlayerFragment のサポート フラグメント バージョン。
YouTubePlayerView YouTube 動画を表示するビュー。
YouTubeStandalonePlayer このクラスは、単体のプレーヤー アクティビティで YouTube 動画を再生するインテントを作成します。
YouTubeThumbnailView 特定の YouTube 動画または YouTube 再生リストのサムネイルを表示するために使用できるビューです。

列挙型

YouTubeInitializationResult YouTube API Service の初期化の結果を提供します。
YouTubePlayer.ErrorReason YouTubePlayer で発生したエラーの理由を説明します。
YouTubePlayer.PlayerStyle プレーヤーで使用できる各種スタイルです。
YouTubeThumbnailLoader.ErrorReason YouTubeThumbnailView で発生したエラーの理由を説明します。