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

com.docomostar.ui.avplayer
クラス Player

Object
  上位を拡張 com.docomostar.ui.avplayer.Player

public final class Player
extends Object
 [iアプリオプションAPI]

音楽プレイヤー機能を定義します。
音楽プレイヤーは音楽再生ソフトウェアを制御する機能を提供します。 具体的には、音楽再生ソフトウェアの起動/終了、属性の取得/設定、コンテンツの再生制御を行うことができます。

音楽再生ソフトウェアには以下の状態が存在します。

起動状態説明
利用不可能状態音楽再生ソフトウェアが起動していない状態
停止状態コンテンツの再生を停止している状態
一時停止状態コンテンツの再生を一時停止している状態
再生状態コンテンツを再生している状態
早送り状態コンテンツを早送りしている状態
巻き戻し状態コンテンツを巻き戻ししている状態

音楽再生ソフトウェアを起動/終了するには powerOn()、及び powerOff() メソッドを使用してください。 音楽再生ソフトウェアを起動すると、音楽再生ソフトウェアは停止状態、または一時停止状態となります。 音楽再生ソフトウェア（または Star アプリ)を終了すると、音楽再生ソフトウェアは利用不可能状態となります。
音楽再生ソフトウェアを起動中に suspend() メソッドの実行によって Star アプリがサスペンドした場合、 音楽再生ソフトウェアの状態は Suspended 状態に遷移する前の状態を維持します。

音楽再生ソフトウェアに対して属性を取得/設定するには getAttribute(int)、及び setAttribute(int, int) メソッドを使用してください。

レジューム情報

音楽プレイヤーの再生情報(プレイリスト・コンテンツインデックス・再生位置・音量・再生モードなど)はレジューム情報として扱われます。 このレジューム情報は Star アプリにおける音楽プレイヤーとネイティブのミュージックプレイヤーで共有されます。

レジューム情報は、音楽再生ソフトウェアが終了する契機で保存されます。 保存されたレジューム情報は、powerOn() により音楽再生ソフトウェアが起動された時点で読み込まれ、 play() を呼び出すことで前回の続きから再生を再開できます。

Star アプリで音楽再生ソフトウェア起動中に、マルチタスク機能や連携機能によって他機能が後発で起動された場合、 及び他のメソッドの実行によってサウンドリソース競合が発生した場合、 後発で起動された機能の種類に応じて以下のいずれかの振る舞いをします。

以下の条件を同時に満たした場合、音楽再生ソフトウェアの状態が利用不可能状態に遷移することがあります。

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

フィールドの概要
static int ATTR_PLAY_MODE_ALL_REPEAT
           再生モードの属性で、オールリピートモードを表します(=2)。
static int ATTR_PLAY_MODE_NORMAL
           再生モードの属性で、通常再生モードを表します(=0)。
static int ATTR_PLAY_MODE_SHUFFLE
           再生モードの属性で、シャッフルモードを表します(=3)。
static int ATTR_PLAY_MODE_SHUFFLE_REPEAT
           再生モードの属性で、シャッフルリピートモードを表します(=4)。
static int ATTR_PLAY_MODE_SINGLE
           再生モードの属性で、 1 曲終了モードを表します(=5)。
static int ATTR_PLAY_MODE_SINGLE_REPEAT
           再生モードの属性で、シングルリピートモードを表します(=1)。
static int DEV_PLAY_MODE
           音楽再生ソフトウェアの属性の 1 つで、再生モードを表します(=1)。
static int DEV_VOLUME
           音楽再生ソフトウェアの属性の 1 つでボリュームを表します(=0)。
static int STATUS_FAST_FORWARDING
          音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを早送りしている状態を表します(=3)。
static int STATUS_FAST_REWINDING
          音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを巻き戻ししている状態を表します(=4)。
static int STATUS_NOT_AVAILABLE
          音楽再生ソフトウェアにおける状態の 1 つで、音楽再生ソフトウェアが起動していない状態を表します(=-1)。
static int STATUS_PAUSED
          音楽再生ソフトウェアにおける状態の 1 つで、コンテンツの再生を一時停止している状態を表します(=2)。
static int STATUS_PLAYING
          音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを再生している状態を表します(=1)。
static int STATUS_STOPPED
          音楽再生ソフトウェアにおける状態の 1 つで、コンテンツの再生を停止している状態を表します(=0)。
 
メソッドの概要
 void fastForward()
           コンテンツを早送りします。
 void fastRewind()
           コンテンツを巻き戻しします。
 int getAttribute(int attr)
           音楽再生ソフトウェアから属性を取得します。
 int getContentIndex()
           カレントコンテンツのコンテンツインデックスを取得します。
 Content getCurrentContent()
           カレントコンテンツを取得します。
 Playlist getCurrentPlaylist()
           カレントプレイリストを取得します。
static Player getInstance()
           音楽プレイヤーオブジェクトを取得します。
 int getPosition()
           コンテンツの現在の再生位置を取得します。
 int getStatus()
           音楽再生ソフトウェアの状態を取得します。
 void pause()
           コンテンツの再生を一時停止します。
 void play()
           カレントコンテンツを再生します。
 void powerOff()
           音楽再生ソフトウェアを終了します。
 void powerOn()
           音楽再生ソフトウェアを起動します。
 void setAttribute(int attr, int value)
           音楽再生ソフトウェアに属性を設定します。
 void setContentIndex(int contentIndex)
           指定されたコンテンツインデックスのコンテンツをカレントコンテンツに変更します。
 void setPlaylist(Playlist playlist)
           プレイリストを設定します。
 void setPosition(int position)
           コンテンツの再生位置を設定します。
 void skipBackward()
           コンテンツ戻しをします。
 void skipForward()
           コンテンツ送りをします。
 void stop()
           コンテンツの再生を停止します。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

STATUS_NOT_AVAILABLE

public static final int STATUS_NOT_AVAILABLE
音楽再生ソフトウェアにおける状態の 1 つで、音楽再生ソフトウェアが起動していない状態を表します(=-1)。

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

STATUS_STOPPED

public static final int STATUS_STOPPED
音楽再生ソフトウェアにおける状態の 1 つで、コンテンツの再生を停止している状態を表します(=0)。

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

STATUS_PLAYING

public static final int STATUS_PLAYING
音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを再生している状態を表します(=1)。

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

STATUS_PAUSED

public static final int STATUS_PAUSED
音楽再生ソフトウェアにおける状態の 1 つで、コンテンツの再生を一時停止している状態を表します(=2)。

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

STATUS_FAST_FORWARDING

public static final int STATUS_FAST_FORWARDING
音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを早送りしている状態を表します(=3)。

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

STATUS_FAST_REWINDING

public static final int STATUS_FAST_REWINDING
音楽再生ソフトウェアにおける状態の 1 つで、コンテンツを巻き戻ししている状態を表します(=4)。

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

DEV_VOLUME

public static final int DEV_VOLUME

音楽再生ソフトウェアの属性の 1 つでボリュームを表します(=0)。

コンテンツ本来の音量に対する比率(0 〜 100)を指定します。 この値は、音楽再生ソフトウェアの最大音量に対する相対値として扱われます。

ボリュームはレジューム情報の保存・読込みの対象となり、音楽プレイヤー起動時のボリュームの初期値は、 レジューム情報から読み込んだ値となります。 音楽プレイヤーがレジューム情報を保持していない場合、ボリュームの初期値は機種依存です。

このボリュームの設定は、音楽再生ソフトウェアに対してのみ影響を及ぼします。 AudioPresenter.SET_VOLUME で設定するボリュームとは独立しており、互いに影響を与えることはありません。

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

DEV_PLAY_MODE

public static final int DEV_PLAY_MODE

音楽再生ソフトウェアの属性の 1 つで、再生モードを表します(=1)。

再生モードはレジューム情報の保存・読込みの対象となり、音楽プレイヤー起動時の再生モードの初期値は、 レジューム情報から読み込んだ値となります。 音楽プレイヤーがレジューム情報を保持していない場合、再生モードの初期値は通常再生モードです。

関連項目:
ATTR_PLAY_MODE_NORMAL, ATTR_PLAY_MODE_SINGLE_REPEAT, ATTR_PLAY_MODE_ALL_REPEAT, ATTR_PLAY_MODE_SHUFFLE, ATTR_PLAY_MODE_SHUFFLE_REPEAT, 螳壽焚繝輔ぅ繝ｼ繝ｫ繝牙