YouTubeThumbnailLoader

public interface
YouTubeThumbnailLoader
com.google.android.youtube.player.YouTubeThumbnailLoader

概要

YouTubeThumbnailLoader は、YouTube のサムネイルを YouTubeThumbnailView に読み込むメソッドを提供します。このクラスのインスタンスは、YouTubeThumbnailViewinitialize を呼び出して取得します。

setVideo(String) および setPlaylist(String) メソッドが必要とする動画および再生リストの ID は、YouTube Data API によって提供されます。この API の詳細については、https://developers.google.com/youtube/v3/ をご覧ください。

まとめ

ネストされたクラス
enum YouTubeThumbnailLoader.ErrorReason YouTubeThumbnailView で発生したエラーの理由を説明します。
interface YouTubeThumbnailLoader.OnThumbnailLoadedListener サムネイルが読み込まれたときに呼び出されるリスナーのインターフェース定義です。
public メソッド
abstract void first()
再生リストの最初の動画のサムネイルを表示します。
abstract boolean hasNext()
現在読み込まれている再生リストに 1 つ後の動画があるかどうかを特定します。
abstract boolean hasPrevious()
現在読み込まれている再生リストに 1 つ前の動画があるかどうかを特定します。
abstract void next()
再生リストの 1 つ後の動画のサムネイルを表示します。
abstract void previous()
再生リストの 1 つ前の動画のサムネイルを表示します。
abstract void release()
この YouTubeThumbnailLoader によって使用されているシステム リソースを解放します。
abstract void setOnThumbnailLoadedListener(YouTubeThumbnailLoader.OnThumbnailLoadedListener listener)
YouTubeThumbnailLoader.OnThumbnailLoadedListener を設定します。これは、新しいサムネイルの読み込みが完了し、この YouTube サムネイル ビューで表示された場合は常に呼び出されます。
abstract void setPlaylist(String playlistId)
特定の YouTube 再生リスト ID のサムネイル画像を表示するように、このビューを設定します。
abstract void setPlaylist(String playlistId, int skipTo)
特定の YouTube 再生リスト ID のサムネイル画像を表示するように、このビューを設定します。初期状態では skipTo パラメータで指定された再生リスト インデックスの動画のサムネイルが表示されます。
abstract void setVideo(String videoId)
特定の YouTube 動画 ID のサムネイル画像を表示するように、このビューを設定します。

public メソッド

public abstract void first ()

再生リストの最初の動画のサムネイルを表示します。

public abstract boolean hasNext ()

現在読み込まれている再生リストに 1 つ後の動画があるかどうかを特定します。

返り値
  • 再生リストに 1 つ後の動画が存在する場合は true、そうでない場合は false を返します。

public abstract boolean hasPrevious ()

現在読み込まれている再生リストに 1 つ前の動画があるかどうかを特定します。

返り値
  • 再生リストに 1 つ前の動画が存在する場合は true、そうでない場合は false を返します。

public abstract void next ()

再生リストの 1 つ後の動画のサムネイルを表示します。

最初の呼び出しが完了(onThumbnailLoaded(YouTubeThumbnailView, String) によって示されます)する前に next() または previous() をもう一度呼び出すと、後で行った呼び出しが無視される場合があります。

スロー
NoSuchElementException 再生リストの最後でメソッドが呼び出された場合は、この例外がスローされます。

public abstract void previous ()

再生リストの 1 つ前の動画のサムネイルを表示します。

最初の呼び出しが完了(onThumbnailLoaded(YouTubeThumbnailView, String) によって示されます)する前に next() または previous() をもう一度呼び出すと、後で行った呼び出しが無視される場合があります。

スロー
NoSuchElementException 再生リストの最初でメソッドが呼び出された場合は、この例外がスローされます。

public abstract void release ()

この YouTubeThumbnailLoader によって使用されているシステム リソースを解放します。

このメソッドを呼び出した後は、その YouTubeThumbnailLoader を使用した操作を実行できなくなります。サムネイルを YouTubeThumbnailView に読み込むには、新しいインスタンスを作成する必要があります。

public abstract void setOnThumbnailLoadedListener (YouTubeThumbnailLoader.OnThumbnailLoadedListener listener)

YouTubeThumbnailLoader.OnThumbnailLoadedListener を設定します。これは、新しいサムネイルの読み込みが完了し、この YouTube サムネイル ビューで表示された場合は常に呼び出されます。

パラメータ
listener 登録するリスナーです。

public abstract void setPlaylist (String playlistId)

特定の YouTube 再生リスト ID のサムネイル画像を表示するように、このビューを設定します。初期状態では、再生リストの最初の動画のサムネイルが表示されます。

パラメータ
playlistId サムネイル画像の表示元となる再生リストの ID です。YouTube Data API から返されます。

public abstract void setPlaylist (String playlistId, int skipTo)

特定の YouTube 再生リスト ID のサムネイル画像を表示するように、このビューを設定します。初期状態では skipTo パラメータで指定された再生リスト インデックスの動画のサムネイルが表示されます。

パラメータ
playlistId サムネイル画像の表示元となる再生リストの ID です。YouTube Data API から返されます。
skipTo スキップ先となる再生リストの動画です。

public abstract void setVideo (String videoId)

特定の YouTube 動画 ID のサムネイル画像を表示するように、このビューを設定します。

パラメータ
videoId サムネイル画像の表示元となる再生リストの ID です。YouTube Data API から返されます。