YouTubePlayerFragment

public class
YouTubePlayerFragment
extends Fragment
implements YouTubePlayer.Provider

java.lang.Object
↳	android.app.Fragment
	↳	com.google.android.youtube.player.YouTubePlayerFragment

概要

YouTubePlayerView を含むフラグメントです。ユーザーのアクティビティで YouTubePlayerView を直接使用した場合のように、ライブラリから提供されるアクティビティを拡張する必要がないので、YouTube 動画の再生では、このフラグメントの使用を推奨します。

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

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

このフラグメントに関連付けられた YouTubePlayer は、onDestroyView() メソッドが呼び出されると必ず解放されます。したがって、setRetainInstance(boolean) の設定により、アクティビティの再作成中もフラグメントのインスタンスが保持されているとしても、このフラグメントに関連付けられたアクティビティが再作成されたときには必ず initialize(String, YouTubePlayer.OnInitializedListener) を再度呼び出さなければなりません。

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

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

ターゲットがフラグメントをサポートしていないプラットフォームである場合は、代わりに YouTubePlayerSupportFragment を使用してください。

まとめ

継承される定数
interface android.content.ComponentCallbacks2 から int TRIM_MEMORY_BACKGROUND int TRIM_MEMORY_COMPLETE int TRIM_MEMORY_MODERATE int TRIM_MEMORY_RUNNING_CRITICAL int TRIM_MEMORY_RUNNING_LOW int TRIM_MEMORY_RUNNING_MODERATE int TRIM_MEMORY_UI_HIDDEN

public コンストラクタ
	YouTubePlayerFragment() YouTube フラグメントを作成します。

public メソッド
void	initialize(String developerKey, YouTubePlayer.OnInitializedListener listener) 動画の再生とその制御に使用される YouTubePlayer を初期化します。
static YouTubePlayerFragment	newInstance() YouTube フラグメントを作成します。

継承されるメソッド
class android.app.Fragment から void dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3) final boolean equals(Object arg0) final Activity getActivity() final Bundle getArguments() final FragmentManager getFragmentManager() final int getId() LoaderManager getLoaderManager() final Resources getResources() final boolean getRetainInstance() final String getString(int arg0) final String getString(int arg0, Object... arg1) final String getTag() final Fragment getTargetFragment() final int getTargetRequestCode() final CharSequence getText(int arg0) boolean getUserVisibleHint() View getView() final int hashCode() static Fragment instantiate(Context arg0, String arg1) static Fragment instantiate(Context arg0, String arg1, Bundle arg2) final boolean isAdded() final boolean isDetached() final boolean isHidden() final boolean isInLayout() final boolean isRemoving() final boolean isResumed() final boolean isVisible() void onActivityCreated(Bundle arg0) void onActivityResult(int arg0, int arg1, Intent arg2) void onAttach(Activity arg0) void onConfigurationChanged(Configuration arg0) boolean onContextItemSelected(MenuItem arg0) void onCreate(Bundle arg0) Animator onCreateAnimator(int arg0, boolean arg1, int arg2) void onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2) void onCreateOptionsMenu(Menu arg0, MenuInflater arg1) View onCreateView(LayoutInflater arg0, ViewGroup arg1, Bundle arg2) void onDestroy() void onDestroyOptionsMenu() void onDestroyView() void onDetach() void onHiddenChanged(boolean arg0) void onInflate(AttributeSet arg0, Bundle arg1) void onInflate(Activity arg0, AttributeSet arg1, Bundle arg2) void onLowMemory() boolean onOptionsItemSelected(MenuItem arg0) void onOptionsMenuClosed(Menu arg0) void onPause() void onPrepareOptionsMenu(Menu arg0) void onResume() void onSaveInstanceState(Bundle arg0) void onStart() void onStop() void onTrimMemory(int arg0) void onViewCreated(View arg0, Bundle arg1) void registerForContextMenu(View arg0) void setArguments(Bundle arg0) void setHasOptionsMenu(boolean arg0) void setInitialSavedState(Fragment.SavedState arg0) void setMenuVisibility(boolean arg0) void setRetainInstance(boolean arg0) void setTargetFragment(Fragment arg0, int arg1) void setUserVisibleHint(boolean arg0) void startActivity(Intent arg0) void startActivity(Intent arg0, Bundle arg1) void startActivityForResult(Intent arg0, int arg1) void startActivityForResult(Intent arg0, int arg1, Bundle arg2) String toString() void unregisterForContextMenu(View arg0)
class java.lang.Object から Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
interface android.content.ComponentCallbacks から abstract void onConfigurationChanged(Configuration arg0) abstract void onLowMemory()
interface android.content.ComponentCallbacks2 から abstract void onTrimMemory(int arg0)
interface android.view.View.OnCreateContextMenuListener から abstract void onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)
interface com.google.android.youtube.player.YouTubePlayer.Provider から abstract void initialize(String developerKey, YouTubePlayer.OnInitializedListener listener) 動画の再生と動画再生の制御に使用される YouTubePlayer を初期化します。

public コンストラクタ

public YouTubePlayerFragment ()

YouTube フラグメントを作成します。このコンストラクタは、インフレータで使用する場合のみ public です。プログラム的に YouTubePlayerFragment を作成するには、newInstance() を使用します。

public メソッド

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

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

パラメータ

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

public static YouTubePlayerFragment newInstance ()

YouTube フラグメントを作成します。