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

com.nttdocomo.ui
クラス PhoneSystem

Object
  |
  +--com.nttdocomo.ui.PhoneSystem
public class PhoneSystem
extends Object

携帯電話のデバイスを定義します。 電話システムクラスは、 プラットフォームのネイティブリソースにアクセスする手段を提供するクラスです。
[DoJa-2.0]
標準サウンドを鳴らすことができます。
[DoJa-3.0]
トラステッドiアプリケーションでは、 音声発着信時等に表示される画像や再生されるサウンドを設定することができます。

フィールドの概要
static int ATTR_BACKLIGHT_OFF
          バックライトの属性の一つで、オフすることを表します (=0)。
static int ATTR_BACKLIGHT_ON
          バックライトの属性の一つで、オンすることを表します (=1)。
static int ATTR_BATTERY_CHARGING
           電池残量の属性の一つで、充電中であることを表します(=2)。
static int ATTR_BATTERY_FULL
           電池残量の属性の一つで、充電中でなく、ピクト表示がFULLであることを表します(=1)。
static int ATTR_BATTERY_PARTIAL
           電池残量の属性の一つで、充電中でなく、ピクト表示がFULL以外であることを表します(=0)。
static int ATTR_FOLDING_CLOSE [iアプリオプションAPI]
           折りたたみ状態の属性の一つで、端末が折りたたまれているか、フリップが閉じていることを表します (=0)。
static int ATTR_FOLDING_OPEN [iアプリオプションAPI]
           折りたたみ状態の属性の一つで、端末が折りたたまれていないか、フリップが開いていることを表します (=1)。
static int ATTR_MAIL_AT_CENTER
           メール受信状態の属性の一つで、未読メールがセンターに保管されていることを表します (=2)。
static int ATTR_MAIL_NONE
           メール受信状態の属性の一つで、未読メールがないことを表します (=0)。
static int ATTR_MAIL_RECEIVED
           メール受信状態の属性の一つで、未読メールがあることを表します (=1)。
static int ATTR_MANNER_OFF
           マナーモードの属性の一つで、オフであることを表します(=0)。
static int ATTR_MANNER_ON
           マナーモードの属性の一つで、オンであることを表します(=1)。
static int ATTR_MESSAGE_AT_CENTER
           メッセージ受信状態の属性の一つで、未読メッセージがセンターに保管されていることを表します (=2)。
static int ATTR_MESSAGE_NONE
           メッセージ受信状態の属性の一つで、未読メッセージがないことを表します (=0)。
static int ATTR_MESSAGE_RECEIVED
           メッセージ受信状態の属性の一つで、未読メッセージがあることを表します (=1)。
static int ATTR_SCREEN_INVISIBLE [iアプリオプションAPI]
           画面がユーザに見えるかどうかの属性の一つで、 画面が見えない状態であることを表します(=0)。
static int ATTR_SCREEN_VISIBLE [iアプリオプションAPI]
           画面がユーザに見えるかどうかの属性の一つで、 画面が見える状態であることを表します(=1)。
static int ATTR_SERVICEAREA_INSIDE
           圏内・圏外情報の属性の一つで、ピクト表示が圏内であることを表します(=1)。
static int ATTR_SERVICEAREA_OUTSIDE
           圏内・圏外情報の属性の一つで、ピクト表示が行われていないまたは圏外であることを表します(=0)。
static int ATTR_VIBRATOR_OFF
           バイブレータの属性の一つで、オフすることを表します(=0)。
static int ATTR_VIBRATOR_ON
           バイブレータの属性の一つで、オンすることを表します (=1)。
static int DEV_BACKLIGHT
          バックライトを表します (=0)。
static int DEV_BATTERY
           電池残量を表します (=5)。
static int DEV_FOLDING [iアプリオプションAPI]
           折りたたみ状態を表します (=2)。
static int DEV_KEYPAD [iアプリオプションAPI]
           キーパッドを表します(=8)。
static int DEV_MAILBOX
           メール受信状態を表します (=3)。
static int DEV_MANNER
           マナーモードを表します (=7)。
static int DEV_MESSAGEBOX
           メッセージ（メッセージフリー、メッセージリクエスト）の受信状態を表します (=4)。
static int DEV_SCREEN_VISIBLE [iアプリオプションAPI]
           画面がユーザに見える状態かどうかを表します(=9)。
static int DEV_SERVICEAREA
           圏内・圏外情報を表します (=6)。
static int DEV_VIBRATOR
           バイブレータを表します (=1)。
static int MAX_OPTION_ATTR
           オプションのネイティブリソース属性の最大値です(=255)。
static int MAX_VENDOR_ATTR
          ベンダ定義のネイティブリソース属性の最大値です(=127)。
static int MIN_OPTION_ATTR
           オプションのネイティブリソース属性の最小値です(=128)。
static int MIN_VENDOR_ATTR
          ベンダ定義のネイティブリソース属性の最小値です(=64)。
static int SOUND_ALARM
           ユーザにスケジュールなどのイベントを通知するタイプの標準サウンドを表します (=3)。
static int SOUND_CONFIRM
           ユーザの操作に対して処理を受け付けたことを通知するタイプの標準サウンドを表します (=4)。
static int SOUND_ERROR
           ユーザにエラーを通知するタイプの標準サウンドを表します (=2)。
static int SOUND_INFO
           ユーザに情報を通知するタイプの標準サウンドを表します (=0)。
static int SOUND_WARNING
           ユーザに警告を通知するタイプの標準サウンドを表します (=1)。
static int THEME_AV_CALL_IN
           TV電話着信を表すテーマ設定タイプです(=5)。
static int THEME_CALL_IN
           音声着信を表すテーマ設定タイプです(=2)。
static int THEME_CALL_OUT
           音声発信を表すテーマ設定タイプです(=1)。
static int THEME_MESSAGE_RECEIVE
           メールおよびショートメール・SMS、 メッセージ(R、F)着信を表すテーマ設定タイプです(=4)。
static int THEME_MESSAGE_SEND
           メールおよびショートメール・SMS発信を表すテーマ設定タイプです(=3)。
static int THEME_STANDBY
           待ち受け画面を表すテーマ設定タイプです(=0)。
 
メソッドの概要
static int getAttribute(int attr)
           ネイティブリソースの属性を取得します。
static boolean isAvailable(int attr)
           ネイティブのリソースが制御可能かどうか調べます。
static void playSound(int type)
           標準サウンドを鳴らします。
static void setAttribute(int attr, int value)
          ネイティブリソースの制御を行います。
static void setImageTheme(int target, int id)
           音声発着信時等に表示される画像を設定します。
static void setSoundTheme(int target, int id)
           音声着信時等に再生されるサウンドを設定します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

DEV_BACKLIGHT

public static final int DEV_BACKLIGHT
バックライトを表します (=0)。
属性の制御と取得が可能です。

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

ATTR_BACKLIGHT_OFF

public static final int ATTR_BACKLIGHT_OFF
バックライトの属性の一つで、オフすることを表します (=0)。

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

ATTR_BACKLIGHT_ON

public static final int ATTR_BACKLIGHT_ON
バックライトの属性の一つで、オンすることを表します (=1)。

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

DEV_VIBRATOR

public static final int DEV_VIBRATOR
バイブレータを表します (=1)。
属性の制御と取得が可能です。

[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_VIBRATOR_OFF

public static final int ATTR_VIBRATOR_OFF
バイブレータの属性の一つで、オフすることを表します(=0)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_VIBRATOR_ON

public static final int ATTR_VIBRATOR_ON
バイブレータの属性の一つで、オンすることを表します (=1)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

DEV_FOLDING

public static final int DEV_FOLDING [iアプリオプションAPI]
折りたたみ状態を表します (=2)。 端末が折りたたみ型またはフリップ型の場合のみ意味を持ちます。 ストレートタイプの場合、属性値は常に-1を返します。
属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_FOLDING_CLOSE

public static final int ATTR_FOLDING_CLOSE [iアプリオプションAPI]
折りたたみ状態の属性の一つで、端末が折りたたまれているか、フリップが閉じていることを表します (=0)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_FOLDING_OPEN

public static final int ATTR_FOLDING_OPEN [iアプリオプションAPI]
折りたたみ状態の属性の一つで、端末が折りたたまれていないか、フリップが開いていることを表します (=1)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

DEV_MAILBOX

public static final int DEV_MAILBOX
メール受信状態を表します (=3)。 端末のメールマークの表示と連動しています。
属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MAIL_NONE

public static final int ATTR_MAIL_NONE
メール受信状態の属性の一つで、未読メールがないことを表します (=0)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MAIL_RECEIVED

public static final int ATTR_MAIL_RECEIVED
メール受信状態の属性の一つで、未読メールがあることを表します (=1)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MAIL_AT_CENTER

public static final int ATTR_MAIL_AT_CENTER
メール受信状態の属性の一つで、未読メールがセンターに保管されていることを表します (=2)。

[DoJa-3.0] センターに保管されているものがメッセージかメールか区別できない場合、 メッセージ、メールのいずれかが保管されていればこの値を返します。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

DEV_MESSAGEBOX

public static final int DEV_MESSAGEBOX
メッセージ（メッセージフリー、メッセージリクエスト）の受信状態を表します (=4)。 端末のメッセージマークの表示と連動しています。
属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MESSAGE_NONE

public static final int ATTR_MESSAGE_NONE
メッセージ受信状態の属性の一つで、未読メッセージがないことを表します (=0)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MESSAGE_RECEIVED

public static final int ATTR_MESSAGE_RECEIVED
メッセージ受信状態の属性の一つで、未読メッセージがあることを表します (=1)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

ATTR_MESSAGE_AT_CENTER

public static final int ATTR_MESSAGE_AT_CENTER
メッセージ受信状態の属性の一つで、未読メッセージがセンターに保管されていることを表します (=2)。

[DoJa-3.0] センターに保管されているものがメッセージかメールか区別できない場合、 メッセージ、メールのいずれかが保管されていればこの値を返します。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

DEV_BATTERY

public static final int DEV_BATTERY
電池残量を表します (=5)。

属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_BATTERY_PARTIAL

public static final int ATTR_BATTERY_PARTIAL
電池残量の属性の一つで、充電中でなく、ピクト表示がFULL以外であることを表します(=0)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_BATTERY_FULL

public static final int ATTR_BATTERY_FULL
電池残量の属性の一つで、充電中でなく、ピクト表示がFULLであることを表します(=1)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_BATTERY_CHARGING

public static final int ATTR_BATTERY_CHARGING
電池残量の属性の一つで、充電中であることを表します(=2)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

DEV_SERVICEAREA

public static final int DEV_SERVICEAREA
圏内・圏外情報を表します (=6)。

属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_SERVICEAREA_OUTSIDE

public static final int ATTR_SERVICEAREA_OUTSIDE
圏内・圏外情報の属性の一つで、ピクト表示が行われていないまたは圏外であることを表します(=0)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_SERVICEAREA_INSIDE

public static final int ATTR_SERVICEAREA_INSIDE
圏内・圏外情報の属性の一つで、ピクト表示が圏内であることを表します(=1)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

DEV_MANNER

public static final int DEV_MANNER
マナーモードを表します (=7)。

属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_MANNER_OFF

public static final int ATTR_MANNER_OFF
マナーモードの属性の一つで、オフであることを表します(=0)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

ATTR_MANNER_ON

public static final int ATTR_MANNER_ON
マナーモードの属性の一つで、オンであることを表します(=1)。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

DEV_KEYPAD

public static final int DEV_KEYPAD [iアプリオプションAPI]

キーパッドを表します(=8)。 低レベル API において、キーのグループごとにキーを有効とするかどうかを制御します。 ユーザが有効なグループのキーを操作した場合はキーイベントが発生し、 また、キーパッド状態を取得することが可能です。 一方、無効なグループのキーを操作した場合はキーイベントも発生しませんし、 キーパッド状態を取得することもできません。 デフォルトではグループ 0 のキーのみが有効となっています。

キーの有効化は、iアプリが起動してから最初に Display.setCurrent(Frame) を呼び出すまでに行わなければなりません。 それ以降にキーを有効化しようとしても無視されます。 また、一度有効化すると無効化することはできません。

属性値としてキーのグループ番号を指定して setAttribute(int, int) メソッドを呼び出すと、 そのグループのキーが有効になります。 例えば PhoneSystem.setAttribute(DEV_KEYPAD, 1) とすると、 グループ 1 のキーが有効になります。

属性の制御のみ可能で、取得することはできません。

導入されたバージョン:
DoJa-3.0 (505iS)
関連項目:
Canvas.getKeypadState(int), 定数フィールド値

DEV_SCREEN_VISIBLE

public static final int DEV_SCREEN_VISIBLE [iアプリオプションAPI]
画面がユーザに見える状態かどうかを表します(=9)。 ストレートタイプの端末では、 常に ATTR_SCREEN_VISIBLE を返します。 折りたたみ型の端末では、端末の状態に応じて ATTR_SCREEN_INVISIBLE、ATTR_SCREEN_VISIBLE のいずれかを返します。
属性の取得のみ可能で、制御することはできません。

導入されたバージョン:
DoJa-3.0 (505iS)
関連項目:
DEV_FOLDING, 定数フィールド値

ATTR_SCREEN_INVISIBLE

public static final int ATTR_SCREEN_INVISIBLE [iアプリオプションAPI]
画面がユーザに見えるかどうかの属性の一つで、 画面が見えない状態であることを表します(=0)。

導入されたバージョン:
DoJa-3.0 (505iS)
関連項目:
定数フィールド値

ATTR_SCREEN_VISIBLE

public static final int ATTR_SCREEN_VISIBLE [iアプリオプションAPI]
画面がユーザに見えるかどうかの属性の一つで、 画面が見える状態であることを表します(=1)。

導入されたバージョン:
DoJa-3.0 (505iS)
関連項目:
定数フィールド値

MIN_VENDOR_ATTR

public static final int MIN_VENDOR_ATTR
ベンダ定義のネイティブリソース属性の最小値です(=64)。

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

MAX_VENDOR_ATTR

public static final int MAX_VENDOR_ATTR
ベンダ定義のネイティブリソース属性の最大値です(=127)。

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

MIN_OPTION_ATTR

public static final int MIN_OPTION_ATTR
オプションのネイティブリソース属性の最小値です(=128)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

MAX_OPTION_ATTR

public static final int MAX_OPTION_ATTR
オプションのネイティブリソース属性の最大値です(=255)。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

SOUND_INFO

public static final int SOUND_INFO
ユーザに情報を通知するタイプの標準サウンドを表します (=0)。 playSound(int) メソッドの引数として使用されます。
[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

SOUND_WARNING

public static final int SOUND_WARNING
ユーザに警告を通知するタイプの標準サウンドを表します (=1)。 playSound(int) メソッドの引数として使用されます。
[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

SOUND_ERROR

public static final int SOUND_ERROR
ユーザにエラーを通知するタイプの標準サウンドを表します (=2)。 playSound(int) メソッドの引数として使用されます。
[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

SOUND_ALARM

public static final int SOUND_ALARM
ユーザにスケジュールなどのイベントを通知するタイプの標準サウンドを表します (=3)。 playSound(int) メソッドの引数として使用されます。
[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

SOUND_CONFIRM

public static final int SOUND_CONFIRM
ユーザの操作に対して処理を受け付けたことを通知するタイプの標準サウンドを表します (=4)。 playSound(int) メソッドの引数として使用されます。
[DoJa-2.0] 端末によってはサポートされない場合があります。

導入されたバージョン:
DoJa-2.0
関連項目:
定数フィールド値

THEME_STANDBY

public static final int THEME_STANDBY
待ち受け画面を表すテーマ設定タイプです(=0)。
setImageTheme メソッドのtarget引数として使用されます。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

THEME_CALL_OUT

public static final int THEME_CALL_OUT
音声発信を表すテーマ設定タイプです(=1)。
setImageTheme メソッドのtarget引数として使用されます。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

THEME_CALL_IN

public static final int THEME_CALL_IN
音声着信を表すテーマ設定タイプです(=2)。
setImageTheme、 setSoundTheme メソッドのtarget引数として使用されます。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

THEME_MESSAGE_SEND

public static final int THEME_MESSAGE_SEND
メールおよびショートメール・SMS発信を表すテーマ設定タイプです(=3)。
setImageTheme メソッドのtarget引数として使用されます。

ショートメールは PDC 端末でのみ、SMS は FOMA 端末でのみ使用できます。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

THEME_MESSAGE_RECEIVE

public static final int THEME_MESSAGE_RECEIVE
メールおよびショートメール・SMS、 メッセージ(R、F)着信を表すテーマ設定タイプです(=4)。
setImageTheme、 setSoundTheme メソッドのtarget引数として使用されます。

ショートメールは PDC 端末でのみ、SMS は FOMA 端末でのみ使用できます。

導入されたバージョン:
DoJa-3.0
関連項目:
定数フィールド値

THEME_AV_CALL_IN

public static final int THEME_AV_CALL_IN
TV電話着信を表すテーマ設定タイプです(=5)。
setSoundTheme メソッドのtarget引数として使用されます。

FOMA 端末でのみ使用できます。

導入されたバージョン:
DoJa-3.5
関連項目:
定数フィールド値
メソッドの詳細

setAttribute

public static final void setAttribute(int attr,
                                      int value)
ネイティブリソースの制御を行います。 端末の設定によってリソースの制御が制限されている場合はその制限に従います。 存在しないリソース、制御可能でないリソースの種類が指定された場合は何も行わずに無視されます。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
value - ネイティブリソースに設定する属性値を指定します。
例外:
IllegalArgumentException - [DoJa-2.0] 引数 attr で指定された有効なリソースに対して、引数 value に不正な属性値が指定された場合に発生します。

getAttribute

public static final int getAttribute(int attr)
ネイティブリソースの属性を取得します。 存在しないリソースの種類が指定された場合は -1 を返します。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
戻り値:
ネイティブリソースの属性値を返します。
例外:
IllegalStateException - [DoJa-3.0] ADFにGetSysInfoキーの指定がないと SecurityExceptionが発生する属性を指定して、 ダウンロード即起動アプリから呼び出された場合に発生します。
SecurityException - [DoJa-2.0] ADFにGetSysInfoキーの指定がないアプリケーションがメール、 メッセージのピクト情報を取得しようとした場合に発生します。
[DoJa-3.0] ADFにGetSysInfoキーの指定がないアプリケーションが メール、メッセージ、圏内/圏外情報、電池残量、 マナーモード設定のピクト情報を取得しようとした場合に発生します。 iアプリ個別のユーザ設定により許可されない場合を含みます。
導入されたバージョン:
DoJa-2.0

isAvailable

public static final boolean isAvailable(int attr)
ネイティブのリソースが制御可能かどうか調べます。 このメソッドが true を返した場合は、そのリソースを setAttribute(int, int) メソッドで制御することが可能です。 端末がそのリソースの制御をサポートしていない場合や、 端末の設定によってそのリソースの制御が制限されている場合は false を返します。 待ち受け実行の時、活性化状態・非活性化状態によってリソースの制御が 制限されている場合は false を返します。 状態を取得するだけで制御することができない属性に対して呼び出された場合は常に false を返します。 存在しないリソースの種類が指定された場合は false を返します。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
戻り値:
ネイティブリソースが制御可能な場合は true を、 そうでなければ false を返します。
導入されたバージョン:
DoJa-2.0

playSound

public static final void playSound(int type)
標準サウンドを鳴らします。
[DoJa-2.0] 端末が標準サウンドをサポートしていない場合は何もしません。

パラメータ:
type - 標準サウンドの種類を指定します。 SOUND_INFO、SOUND_WARNING、SOUND_ERROR、 SOUND_ALARM、SOUND_CONFIRM のいずれかです。
例外:
IllegalArgumentException - 引数 type に不正な値が指定された場合に発生します。
IllegalStateException - [DoJa-2.1] 通話中に呼び出された場合に発生します。
導入されたバージョン:
DoJa-2.0

setImageTheme

public static void setImageTheme(int target,
                                 int id)
                          throws StoreException
音声発着信時等に表示される画像を設定します。 アプリケーションが終了後もこの設定は有効です。 また、アプリケーション削除後もこの設定は有効です。
設定する画像のIDは、 ImageStoreクラスの addEntryメソッド、 getIdメソッド により取得できます。

パーミッションとしてテーマ設定が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。

パラメータ:
target - 設定する画像の対象を指定します。 THEME_STANDBY、 THEME_CALL_OUT、 THEME_CALL_IN、 THEME_MESSAGE_SEND、 THEME_MESSAGE_RECEIVE のいずれかです。
id - ネイティブの画像保存領域中の画像のIDを指定します。
例外:
IllegalStateException - このメソッドを呼び出す度にユーザ確認が必要であると設定されているにもかかわらず、 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException - 引数 target の値が不正な場合に発生します。
SecurityException - パーミッションとしてテーマ設定が許可されているが指定されているが、 iアプリ個別のユーザ設定により許可されていない場合に発生します。 実行時のユーザ確認により使用が許可されなかった場合を含みます。
SecurityException - ネイティブ独自のセキュリティ設定により、 指定された画像へのアクセスが許可されない場合に発生します。
StoreException - 指定されたIDの画像が存在しない場合に発生します(NOT_FOUND)。
UIException - [DoJa-3.5] 指定された対象では指定されたIDの画像のフォーマットをサポートしていない場合に発生します (UNSUPPORTED_FORMAT)。
UIException - 指定されたIDの画像のサイズが、縦もしくは横のいずれかで 設定可能な画像のサイズよりも大きい場合に発生します (UNSUPPORTED_FORMAT)。 設定可能な画像のサイズよりも小さい場合には例外は発生せず、 機種依存の方法で表示されます。
導入されたバージョン:
DoJa-3.0

setSoundTheme

public static void setSoundTheme(int target,
                                 int id)
                          throws StoreException
音声着信時等に再生されるサウンドを設定します。 通常着信音およびメッセージ受信音 （メール、メッセージリクエスト、メッセージフリーの各受信音） を更新できます。 番号不通知着信音、公衆電話着信音、転送着信音、 番号指定着信音は変更できません。 アプリケーションが終了後もこの設定は有効です。 また、アプリケーション削除後もこの設定は有効です。
[DoJa-3.5]
FOMA 端末では TV 電話着信音も更新できます。

着信メロディに使用するサウンドデータのIDは、 SoundStore.addEntry メソッドにより取得できます。

パーミッションとしてテーマ設定が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。

パラメータ:
target - 設定するサウンドの対象を指定します。 THEME_CALL_IN、 THEME_MESSAGE_RECEIVE のいずれかです。
id - ネイティブの着信メロディ領域に保存されている 着信メロディのIDを指定します。
例外:
IllegalStateException - このメソッドを呼び出す度にユーザ確認が必要であると設定されているにもかかわらず、 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException - 引数 target の値が不正な場合に発生します。
SecurityException - パーミッションとしてテーマ設定が許可されているが、 iアプリ個別のユーザ設定により許可されていない場合に発生します。 実行時のユーザ確認により使用が許可されなかった場合を含みます。
SecurityException - ネイティブ独自のセキュリティ設定により、 指定されたサウンドへのアクセスが許可されない場合に発生します。
StoreException - 指定されたIDのサウンドが存在しない場合に発生します(NOT_FOUND)。
UIException - [DoJa-3.5] 指定された対象では指定されたIDのサウンドのフォーマットをサポートしていない場合に発生します (UNSUPPORTED_FORMAT)。
導入されたバージョン:
DoJa-3.0
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DoCoMo,Inc.

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

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

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