com.docomostar.media
クラス MediaManager

Object
  com.docomostar.media.MediaManager

public final class MediaManager
extends Object

メディアリソースデータの管理オブジェクトを定義します。
リソースの取得と利用時の振舞は以下のようになります。

• MediaManager.getImage メソッドまたは、 MediaManager.getSound メソッド、MediaManager.getAvatarData メソッド 、MediaManager.getMovieメソッドでリソースオブジェクトを 取得します。引数のロケーション指定については、最低限のチェック ( 形式のチェック、アクセス禁止 URL のチェックなど ) が行われます。リソースオブジェクトは指定されたロケーションを保持します。
  ストリームやバイト配列を指定した場合は、 null チェックと引数の保存のみを行います。 これはストリームやバイト配列への参照の保存であって、 コンテンツの保存は行いません。
• MediaResource.use メソッドを発行すると、ロケーション またはストリーム、バイト配列 からリソースをロードし内部表現形式に変換します。 このとき、 ConnectionException または MediaException が発生する可能性があります。
• use メソッド発行後、リソースオブジェクトは利用可能になります。
• use メソッドを実行すると、 ロケーションから得られる入力ストリーム、指定された入力ストリーム、 またはバイト配列から、 メディアリソースのサイズ分のデータが読み込まれます。
• MediaResource.unuse メソッドを発行すると、 内部表現形式が破棄され、その表現の保持に必要なリソース （メモリなど)が解放されます。
• 内部表現形式に変換する必要のないデータについては、 内部表現形式への変換、破棄は行いません。
• ストリームを指定して MediaResource オブジェクトを取得し、 MediaResource.use メソッドを unuse メソッドを挟んで複数回呼び出した場合、 一つ目のメディアリソースに対応したオブジェクトのみ取得可能です。 2 回目の use メソッドでは、新たなストリームの読み込みは行わず、 一つ目のメディアリソースが再度利用可能状態になります。 これは、入力ストリームから複数のメディアリソースのデータが連続して得られる場合でも、 同様です。
• MediaResource.dispose メソッドが発行されると、リソースオブジェクトが内部で使用しているリソース ( メモリなど ) が破棄されます。このメソッドが発行されたあとは、 use メソッド、 unuse メソッドの発行はできません。

MediaResource.use() メソッド、 MediaResource.unuse() メソッド呼び出しによる、 メモリ確保・解放に関する振る舞いをモデル化するために、 以下の 2 つの領域を定義します。

オリジナルデータ領域:

内部表現形式に変換される前のデータイメージを保存しておく領域です。 例えば、 GIF 画像の場合は、 GIF フォーマットのデータそのものを保存しておく領域がこれにあたります。

内部データ領域:

メディアリソースに対して use メソッドを呼び出すと、 内部表現形式への変換を行いますが、 その変換後のデータの一部 ( または全て ) を保存しておく領域です。

use() 、 unuse() 時のメモリ確保・解放に関する振る舞いは、 getImage() 、 getSound() 、 getAvatarData()、getMovie() メソッドの引数に、何を指定するかによって、下記のように異なります。 ただし、データによっては内部表現形式に変換する必要のないものがあります。 そのようなデータについては「オリジナルデータ領域」のみが存在するものとし、 下記の説明の「オリジナルデータ領域」に関する説明のみ有効とします。

URL 指定により取得したメディアリソース:

1回目の use 時:

• 新しく「オリジナルデータ領域」を確保する。 URLで指定されたロケーションよりデータを読み込み、 そのデータを「オリジナルデータ領域」に保存する。
• 新しく「内部データ領域」を確保する。 「オリジナルデータ領域」内のデータを内部形式に変換して 「内部データ領域」に保持する。

unuse 時:

「内部データ領域」のみを解放する。

2回目以降の use 時:

新しく「内部データ領域」を確保する。 URLで指定されたロケーションからのデータ読み込みは行わず、 「オリジナルデータ領域」 内のデータを内部形式に変換して「内部データ領域」に保持する。

バイト配列指定により取得したメディアリソース:

1回目の use 時:

• 新しく「オリジナルデータ領域」を確保する。 参照しているバイト配列の内容を 「オリジナルデータ領域」へコピーし、保存する。
• 新しく「内部データ領域」を確保する。 「オリジナルデータ領域」内のデータを内部形式に変換して 「内部データ領域」に保持する

unuse 時:

「内部データ領域」のみを解放する。

2 回目以降の use 時:

新しく「内部データ領域」を確保する。 「オリジナルデータ領域」 内のデータを内部形式に変換して「内部データ領域」に保持する。

ストリーム指定により取得したメディアリソース:

1 回目の use 時:

• 新しく「オリジナルデータ領域」を確保する。 データ1つ分をストリームより読み込み、 そのデータを「オリジナルデータ領域」に保存する。
• 新しく「内部データ領域」を確保する。 「オリジナルデータ領域」内のデータを内部形式に 変換して「内部データ領域」に保持する。

unuse 時:

「内部データ領域」を解放する。

2 回目以降の use 時:

新しく「内部データ領域」を確保する。 「オリジナルデータ領域」内のデータを内部形式に変換して 「内部データ領域」に保持する。

導入されたバージョン:

Star-1.0

関連項目:

MediaResource, MediaImage, MediaSound, MediaPresenter, AudioPresenter, VisualPresenter, NativeMoviePlayer, MediaMovie

メソッドの概要

static MediaImage	createMediaImage(int width, int height) 画像の幅・高さを指定して、 空のメディアイメージを生成します。
static MediaImage	createMediaImage(int width, int height, boolean reusable) 画像の幅・高さ、PNG 画像に対する内部データ領域の再利用可否を指定して、 空のメディアイメージを生成します。
static MediaSound	createMediaSound(int bytes) サウンドのデータサイズ [bytes] を指定して、 空のメディアサウンドを生成します。
static AvatarData	getAvatarData(byte[] data) [iアプリオプションAPI] バイト配列を指定してアバターデータオブジェクトを取り出します。
static AvatarData	getAvatarData(java.io.InputStream in) [iアプリオプションAPI] ストリームを指定してアバターデータオブジェクトを取り出します。
static AvatarData	getAvatarData(String location) [iアプリオプションAPI] 場所を指定してアバターデータオブジェクトを取り出します。
static MediaImage	getImage(byte[] data) バイト配列を指定してメディアイメージオブジェクトを取り出します。
static MediaImage	getImage(java.io.InputStream in) ストリームを指定してメディアイメージオブジェクトを取り出します。
static MediaImage	getImage(String location) 場所を指定してメディアイメージオブジェクトを取り出します。
static MediaMovie	getMovie(byte[] data) バイト配列を指定してメディアムービーオブジェクトを取り出します。
static MediaMovie	getMovie(java.io.InputStream in) ストリームを指定してメディアムービーオブジェクトを取り出します。
static MediaMovie	getMovie(String location) 場所を指定してメディアムービーオブジェクトを取り出します。
static MediaSound	getSound(byte[] data) バイト配列を指定してメディアサウンドオブジェクトを取り出します。
static MediaSound	getSound(java.io.InputStream in) ストリームを指定してメディアサウンドオブジェクトを取り出します。
static MediaSound	getSound(String location) 場所を指定してメディアサウンドオブジェクトを取り出します。
static void	use(MediaImage[] images, boolean useOnce) 指定されたイメージを、 まとめて利用可能にします。
static void	use(MediaSound[] sounds, boolean useOnce) 指定されたサウンドを、 まとめて利用可能にします。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getImage

public static final MediaImage getImage(String location)

場所を指定してメディアイメージオブジェクトを取り出します。 location 指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

パラメータ:

location - 場所を指定します。

戻り値:

メディアイメージオブジェクトを返します。

例外:

NullPointerException -
引数 location が null の場合に発生します。

IllegalArgumentException -
引数 location に指定された文字列が "comm:" 、 "obex:" 、 "socket:" 、 "datagram:" で開始する場合に発生します。

IllegalArgumentException -
引数 location に不正な場所が指定された場合に発生します。

SecurityException -
セキュリティ上の制約に触れた場合に発生します。

MediaException -
(NO_RESOURCES)
システムリソースの不足などでオブジェクトが生成できなかった場合に発生します。

getSound

public static final MediaSound getSound(String location)

場所を指定してメディアサウンドオブジェクトを取り出します。 location 指定のフォーマット形式が正しくない場合、 引数指定誤りになります。

パラメータ:

location - 場所を指定します。

戻り値:

メディアサウンドオブジェクトを返します。

例外:

IllegalStateException -
ミニアプリ実行時に呼び出された場合に発生します。

NullPointerException -
引数 location が null の場合に発生します。

IllegalArgumentException -
引数 location に指定された文字列が "comm:" 、 "obex:" 、 "socket:" 、 "datagram:" で開始する場合に発生します。

IllegalArgumentException -
引数 location に不正な場所が指定された場合に発生します。

SecurityException -
セキュリティ上の制約に触れた場合に発生します。

MediaException -
(NO_RESOURCES)
システムリソースの不足などでオブジェクトが生成できなかった場合に発生します。

getAvatarData

public static final AvatarData getAvatarData(String location) [iアプリオプションAPI]

場所を指定してアバターデータオブジェクトを取り出します。 location 指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

端末によっては、このメソッドをサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。

パラメータ:

location - 場所を指定します。

戻り値:

アバターデータオブジェクトを返します。

例外:

UnsupportedOperationException -
端末がこのメソッドをサポートしていない場合に発生します。

IllegalStateException -
ミニアプリ実行時に呼び出された場合に発生します。

NullPointerException -
引数 location が null の場合に発生します。

IllegalArgumentException -
引数 location に指定された文字列が "comm:" 、 "obex:" 、 "socket:" 、 "datagram:" で開始する場合に発生します。

IllegalArgumentException -
引数 location に不正な場所が指定された場合に発生します。

SecurityException -
セキュリティ上の制約に触れた場合に発生します。

MediaException -
(NO_RESOURCES)
システムリソースの不足などでオブジェクトが生成できなかった場合に発生します。

getMovie

public static final MediaMovie getMovie(String location)

場所を指定してメディアムービーオブジェクトを取り出します。

location 指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

パラメータ:

location - 場所を指定します。

戻り値:

メディアムービーオブジェクトを返します。

例外:

IllegalStateException -
ミニアプリ実行時に呼び出された場合に発生します。

NullPointerException -
引数 location が null の場合に発生します。

IllegalArgumentException -
引数 location に指定された文字列が "comm:" 、 "obex:" 、 "socket:" 、 "datagram:" で開始する場合に発生します。

IllegalArgumentException - /../../com/docomostar/media/AvatarData.html" title="com.docomostar.media 蜀