概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド

com.docomostar.media.avcontent
クラス Content

Object
  上位を拡張 com.docomostar.media.avcontent.ManagedData
      上位を拡張 com.docomostar.media.avcontent.Content
直系の既知のサブクラス:
MusicContent
public abstract class Content
extends ManagedData
 [iアプリオプションAPI]

音楽プレイヤーで再生可能なコンテンツを定義します。

このオブジェクトでは、音楽プレイヤーで再生可能なコンテンツが共通して保持する属性を取得することができます。 このオブジェクトで定義される再生制限情報属性は詳細データとして扱われ、 それ以外の属性は基本データとして扱われます。(なお、再生制限情報の有無属性は基本データとして扱われます)
属性の種別については ManagedData のクラス説明を参照してください。

このクラスでは キャッシュされた情報を解放する機能を提供します。 このクラスおよびサブクラスの属性が不要になってメモリを節約したい場合には、unload() を呼び出してください。 このメソッドが呼び出されると、ManagedData クラスで定義された属性を除いて、 キャッシュされていた全ての属性が参照されなくなります。 unload() が呼び出されると、そのコンテンツが保持しているクラスのインスタンスは全て無効となります。 有効なインスタンスが必要な場合は、再度インスタンスを取得するメソッドを呼び出してください。

キャッシュされている属性でなくデータベースに保持されている属性を取得したい場合は、 unload() を呼び出してキャッシュをクリアした後に、属性の取得メソッドを呼んでください。

導入されたバージョン:
Star-1.5

フィールドの概要
static int PERMISSION_ALL
          内部メモリと外部メモリ間の移動可否の 1 つで、移動可能であることを表します(=1)。
static int PERMISSION_NONE
          内部メモリと外部メモリ間の移動可否の 1 つで、移動不可であることを表します(=0)。
static int PERMISSION_PLATFORM
          内部メモリと外部メモリ間の移動可否の 1 つで、同一機種間のみ移動可能であることを表します(=2)。
static int RINGTONE_TYPE_FULL
          着信音設定種別の 1 つで、まるごと着信音設定を表します(=0)。
static int TYPE_FULLMUSIC
          ファイル種別の 1 つでフル楽曲(アラカルトコンテンツ)を表します(=0)。
static int TYPE_FULLMUSIC_SUBSCRIPTION
          ファイル種別の 1 つでフル楽曲(サブスクリプションコンテンツ)を表します(=1)。
static int TYPE_MP3
          ファイル種別の 1 つで MPEG Audio Layer-3 を表します(=3)。
static int TYPE_SDAUDIO
          ファイル種別の 1 つで SD-Audio を表します(=4)。
static int TYPE_WMA
          ファイル種別の 1 つで WindowsMediaAudio を表します(=2)。
 
メソッドの概要
 boolean canSetRingtone(int type)
           着信音設定の可否を取得します。
 AudioCodecInfo getAudioCodecInfo()
           オーディオコーデック情報を取得します。
 int getExportPermission()
           本体メモリから外部メモリへコンテンツを移動できるかどうかを取得します。
 String getFileName()
           ファイル名を取得します。
 long getFileSizeOnMemory()
           ファイルサイズを取得します。
 int getImportPermission()
           外部メモリから本体メモリへコンテンツを移動できるかどうかを取得します。
 String getOrigin()
           データ取得元を取得します。
 PlayableInfo getPlayableInfo()
           再生制限情報を取得します。
 java.util.Date getSavedDate()
           ファイル保存日時を取得します。
 int getTotalTime()
           総再生時間を取得します。
 int getType()
           ファイル種別を取得します。
 boolean hasPlayableInfo()
           再生制限情報の有無を取得します。
 boolean isFileRestricted()
           ファイル制限の有無を取得します。
 void unload()
           キャッシュされている属性を解放します。
 
クラス com.docomostar.media.avcontent.ManagedData から継承されたメソッド
getTitleName
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

TYPE_FULLMUSIC

public static final int TYPE_FULLMUSIC
ファイル種別の 1 つでフル楽曲(アラカルトコンテンツ)を表します(=0)。

関連項目:
getType(), 定数フィールド値

TYPE_FULLMUSIC_SUBSCRIPTION

public static final int TYPE_FULLMUSIC_SUBSCRIPTION
ファイル種別の 1 つでフル楽曲(サブスクリプションコンテンツ)を表します(=1)。

関連項目:
getType(), 定数フィールド値

TYPE_WMA

public static final int TYPE_WMA
ファイル種別の 1 つで WindowsMediaAudio を表します(=2)。

関連項目:
getType(), 定数フィールド値

TYPE_MP3

public static final int TYPE_MP3
ファイル種別の 1 つで MPEG Audio Layer-3 を表します(=3)。

関連項目:
getType(), 定数フィールド値

TYPE_SDAUDIO

public static final int TYPE_SDAUDIO
ファイル種別の 1 つで SD-Audio を表します(=4)。

関連項目:
getType(), 定数フィールド値

PERMISSION_NONE

public static final int PERMISSION_NONE
内部メモリと外部メモリ間の移動可否の 1 つで、移動不可であることを表します(=0)。

関連項目:
定数フィールド値

PERMISSION_ALL

public static final int PERMISSION_ALL
内部メモリと外部メモリ間の移動可否の 1 つで、移動可能であることを表します(=1)。

関連項目:
定数フィールド値

PERMISSION_PLATFORM

public static final int PERMISSION_PLATFORM
内部メモリと外部メモリ間の移動可否の 1 つで、同一機種間のみ移動可能であることを表します(=2)。

関連項目:
定数フィールド値

RINGTONE_TYPE_FULL

public static final int RINGTONE_TYPE_FULL
着信音設定種別の 1 つで、まるごと着信音設定を表します(=0)。

関連項目:
定数フィールド値
メソッドの詳細

getType

public int getType()

ファイル種別を取得します。

以下のいずれかが返されます。

戻り値:
ファイル種別を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getFileName

public String getFileName()

ファイル名を取得します。

戻り値:
ファイル名を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getTotalTime

public int getTotalTime()

総再生時間を取得します。

値が設定されていない場合は、 -1 を返します。

戻り値:
総再生時間をミリ秒単位で返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getOrigin

public String getOrigin()

データ取得元を取得します。

戻り値:
データ取得元を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getSavedDate

public java.util.Date getSavedDate()

ファイル保存日時を取得します。

このメソッドは、ファイル内の保存日時(タイムゾーン情報なし)をローカルタイムゾーンの時刻と解釈して Date オブジェクトを生成します。

戻り値:
ファイル保存日時を返します。「分」未満の位は「0.000秒」となっています。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getFileSizeOnMemory

public long getFileSizeOnMemory()

ファイルサイズを取得します。

このメソッドを利用して取得されるファイルサイズは、 ファイルの実際の容量ではなく、ファイルの保存に利用しているメモリサイズとなります。

戻り値:
ファイルサイズをバイト単位で返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getAudioCodecInfo

public AudioCodecInfo getAudioCodecInfo()

オーディオコーデック情報を取得します。

このメソッドを呼び出した際に属性がキャッシュされていなければ、新しいインスタンスを生成して返します。 属性がキャッシュ済みの場合は、このメソッドを複数回呼び出しても常に同じインスタンスを返します。

戻り値:
オーディオコーデック情報を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

canSetRingtone

public boolean canSetRingtone(int type)

着信音設定の可否を取得します。

引数 type で指定した種別の着信音設定可否を取得できます。 引数 type には RINGTONE_TYPE_FULL のみ指定可能です。 それ以外の値を指定した場合、例外が発生します。

属性に値が設定されていない場合は、 false を返します。

パラメータ:
type - 着信音設定の種別を指定します。
戻り値:
着信音設定の可否を返します。着信音に設定できる場合は true、設定できない場合は false を返します。
関連項目:
RINGTONE_TYPE_FULL
例外:
IllegalArgumentException -
引数 type に不正な値が指定された場合に発生します。
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

isFileRestricted

public boolean isFileRestricted()

ファイル制限の有無を取得します。

戻り値:
ファイル制限の有無を返します。ファイル制限がある場合は true、ない場合は false を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getExportPermission

public int getExportPermission()

本体メモリから外部メモリへコンテンツを移動できるかどうかを取得します。

以下のいずれかが返されます。

コンテンツが外部メモリに存在する状態でこのメソッドが呼ばれた場合、 常に -1 が返されます。

戻り値:
本体メモリから外部メモリへのコンテンツの移動可否を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getImportPermission

public int getImportPermission()

外部メモリから本体メモリへコンテンツを移動できるかどうかを取得します。

以下のいずれかが返されます。

コンテンツが本体メモリに存在する状態でこのメソッドが呼ばれた場合、 常に -1 が返されます。

戻り値:
外部メモリから本体メモリへのコンテンツの移動可否を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

hasPlayableInfo

public boolean hasPlayableInfo()

再生制限情報の有無を取得します。

コンテンツに再生制限情報が設定されている場合は true 、 設定されていない場合は false を返します。

このメソッドの戻り値が true の場合、 設定されている再生制限情報の内容によっては、 コンテンツの再生に失敗することがあります。 再生制限情報の属性を持つコンテンツの振る舞いについては、Player.play() を参照してください。

戻り値:
再生制限情報の有無を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

getPlayableInfo

public PlayableInfo getPlayableInfo()

再生制限情報を取得します。

このメソッドを呼び出した際に属性がキャッシュされていなければ、新しいインスタンスを生成して返します。 属性がキャッシュ済みの場合は、このメソッドを複数回呼び出しても常に同じインスタンスを返します。

値が設定されていない場合は、 null を返します。 ファイル種別が TYPE_WMA のコンテンツでこのメソッドが呼ばれた場合、 再生制限情報の有無に関わらず、常に null が返されます。

戻り値:
再生制限情報を返します。
例外:
MediaException -
(UNDEFINED)
何らかの理由で取得に失敗した場合に発生します。

unload

public void unload()

キャッシュされている属性を解放します。

既に解放済みの場合は何も行いません。 領域の解放についての詳細は、クラス説明を参照して下さい。

概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。