com.nttdocomo.system
クラス SoundStore

Object
  com.nttdocomo.system.SoundStore

public final class SoundStore

extends Object

携帯電話のネイティブのサウンドデータ管理機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブのサウンドデータの 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。

このクラスに定義されているクラスメソッドの使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則については com.nttdocomo.system パッケージの記述を参照して下さい。 ただし、エントリ取得機能 (selectEntry、getEntry) は提供されません。

エントリ登録メソッド (addEntry(MediaSound)) 呼び出しによって得られるエントリ ID を使って、 PhoneSystem.setSoundTheme(int, int) メソッドにより、端末の音声着信音などを設定することができます。

導入されたバージョン:

DoJa-3.0 (505i)

メソッドの概要

static int

addEntry(MediaSound sound) ユーザ操作によりサウンドデータを新規登録します。

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

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

メソッドの詳細

addEntry

public static int addEntry(MediaSound sound)
                    throws InterruptedOperationException

ユーザ操作によりサウンドデータを新規登録します。 引数に指定されたサウンドデータが保持している再配布可能かどうかの設定のままで登録されます。

パーミッションとしてテーマ設定が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。 上記以外の動作の詳細については、 com.nttdocomo.system パッケージに記述されている説明を参照して下さい。

[DoJa-4.0 (901i) 以降]
データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。

パラメータ:

sound - 登録するサウンドのメディアサウンドを指定します。

戻り値:

登録されたエントリのIDを返します。 ユーザが登録操作をキャンセルした場合、-1 を返します。

例外:

IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。

NullPointerException - 引数 sound に null が指定された場合に発生します。

UIException - 引数の sound にシステムが提供している以外のメディアサウンド (MediaSoundインタフェースを実装した未知のクラスのオブジェクト) が渡された場合に発生します(UNSUPPORTED_FORMAT)。

UIException - 指定されているメディアサウンドが use 状態でない場合に発生します (ILLEGAL_STATE)。

UIException - [DoJa-5.0 (903i) 以降] 指定されているメディアサウンドの利用が「一度きり」 である場合に発生します(ILLEGAL_STATE)。

SecurityException - [DoJa-3.0 (505i) のみ] パーミッションとしてテーマ設定が許可されているが、 iアプリ個別のユーザ設定により許可されない場合に発生します。
[DoJa-3.0 (505iS) 以降] 505iS ・FOMA 2003 年下期モデル以降の機種では、 このようなiアプリ個別のユーザ設定は存在しないため、 この例外が発生することはありません。

SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 サウンドデータを登録できない場合に発生します。

UIException - [DoJa-4.0 (901i) 以降] 指定されたサウンドのデータサイズが、 登録可能なデータサイズ(bytes)よりも大きい場合に発生します (UNSUPPORTED_FORMAT)。

InterruptedOperationException - 競合条件などにより、登録操作が異常終了した場合に発生します。