YouTubePlayerView

public final class
YouTubePlayerView
extends ViewGroup
implements YouTubePlayer.Provider
java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ com.google.android.youtube.player.YouTubePlayerView

概要

YouTube 動画を表示するためのビューです。YouTubePlayerFragment を使用する代わりに、このビューを直接使用することができます。このビューを直接使用することを選択した場合は、アクティビティで YouTubeBaseActivity を拡張する必要があります。

まず最初に、このビューをビュー階層に配置し、initialize(String, OnInitializedListener) を呼び出して、このビューへの動画の読み込みに使用できる YouTubePlayer を作成します。

このビューは、onSaveInstanceState/onRestoreInstanceState フローの一部として、関連付けられている YouTubePlayer の状態を保存し、復元します。詳細については、YouTubePlayer のドキュメントを参照してください。

デバイスの方向によるアクティビティの設定変更が発生するたびに、このビューの表示を再作成することを回避するために、このような設定変更への対応は手動で行うことをお勧めします。ユーザーの利便性を最大にするには、アクティビティのレイアウトを変更して、全画面表示イベントに手動で対応する必要もあります。詳細については、FULLSCREEN_FLAG_CUSTOM_LAYOUTを参照してください。

動画再生中、このビューのサイズは少なくとも 200x110 dp 必要です。ビューをこれよりも小さくすると、動画の再生は自動的に停止します。また、動画の再生中に、このビューを他のビューと重ねることもできません。

このビューはパディングをサポートしていません。同じ効果を実現するには、このビューをもう 1 つの ViewGroup にラップするか、マージンを設定してください。

まとめ

継承される定数
継承されるフィールド
public コンストラクタ
YouTubePlayerView(Context context)
YouTubePlayerView を作成します。
YouTubePlayerView(Context context, AttributeSet attrs)
YouTubePlayerView を作成します。
YouTubePlayerView(Context context, AttributeSet attrs, int defStyle)
YouTubePlayerView を作成します。
public メソッド
void initialize(String developerKey, YouTubePlayer.OnInitializedListener onInitializedListener)
動画の再生と、その制御に使用できる YouTubePlayer を初期化します。
void setPadding(int left, int top, int right, int bottom)
このビューはパディングをサポートしていません。
継承されるメソッド

public コンストラクタ

public YouTubePlayerView (Context context)

YouTubePlayerView を作成します。YouTubeBaseActivity の内部にプログラム的に YouTubePlayerView を構築するには、このコンストラクタを使用します。

パラメータ
context このビューで使用すべきコンテキスト。これは YouTubeBaseActivity でなければなりません。

public YouTubePlayerView (Context context, AttributeSet attrs)

YouTubePlayerView を作成します。このコンストラクタは、ビューが XML からインフレートされているときに、0 により使用されます。このバージョンで使用されるスタイルはデフォルトの 0 です。

パラメータ
context このビューで使用すべきコンテキスト。これは YouTubeBaseActivity でなければなりません。
attrs ビューをインフレートしている XML タグの属性。

public YouTubePlayerView (Context context, AttributeSet attrs, int defStyle)

YouTubePlayerView を作成します。このコンストラクタは、ビューが XML からインフレートされているときに、LayoutInflater により使用されます。

パラメータ
context このビューで使用すべきコンテキスト。これは YouTubeBaseActivity でなければなりません。
attrs ビューをインフレートしている XML タグの属性。
defStyle このビューに適用されるデフォルト スタイル。

public メソッド

public void initialize (String developerKey, YouTubePlayer.OnInitializedListener onInitializedListener)

動画の再生とその制御に使用される YouTubePlayer を初期化します。初期化に成功、または失敗すると、listener のコールバックの 1 つが呼び出されます。

パラメータ
developerKey YouTube Data API v3 サービスの使用を可能にする有効な API キー。 新しいキーを生成するには、Google API コンソールにアクセスしてください。
onInitializedListener 初期化に成功、または失敗したときに呼び出されるコールバック。

public void setPadding (int left, int top, int right, int bottom)

パディングはこのビューではサポートされていません。このメソッドは no-op です。