このパッケージには、YouTube Android Player API のすべてのインターフェースとクラスが含まれます。この API は、Android アプリケーションでの YouTube 動画の再生や動画のサムネイル表示を容易にします。
動画を再生するには 2 つの方法があります。1 つは、YouTubePlayerFragment または YouTubePlayerView を View 階層に配置して、YouTubePlayer を使用して View で動画再生をコントロールする方法です。これにより、エクスペリエンスを細かく管理できます。たとえば動画のサイズを決定したり、プレーヤーのイベントをリッスンして、再生をコントロールすることができます。
もう 1 つの方法は個別のアクティビティで動画の再生を開始する YouTubeStandalonePlayer を使用することです。こちらの方が簡単に使用できますが、動画再生の柔軟性とコントロール機能がやや低下します。StandalonePlayer は全画面表示とライトボックスの 2 つのモードをサポートします。ライトボックス モードでは、プレーヤーを起動するアクティビティがプレーヤーの背後に淡色で表示されます。
YouTube サムネイルを表示するには YouTubeThumbnailView を view 階層に配置し、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 で発生したエラーの理由を説明します。 |