com.nttdocomo.util
クラス Phone

Object
  |
  +--com.nttdocomo.util.Phone

public class Phone
extends Object

携帯電話のネイティブの通話機能にアクセスする手段を提供します。

[DoJa-2.1]
また、携帯電話および UIM の固体識別番号を取得する手段を提供します。

導入されたバージョン:
DoJa-2.0

フィールドの概要
static String TEL_AV
           TV 電話発信を示す文字列です(= "tel-av:")。
static String TERMINAL_ID
           携帯電話の個体識別番号を示す文字列です(= "terminal-id")。
static String USER_ID
           UIMの個体識別番号を示す文字列です(= "user-id")。
 
メソッドの概要
static void call(String phoneNumber)
           音声発信機能またはTV電話発信機能を呼び出します。
static void call(String telType, XString phoneNumber)
           TV 電話発信機能を呼び出します。
static void call(XString phoneNumber)
           音声発信機能を呼び出します。
static String getProperty(String key)
           指定されたキーに該当するプロパティ値を取得します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

TERMINAL_ID

public static final String TERMINAL_ID
携帯電話の個体識別番号を示す文字列です(= "terminal-id")。

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

USER_ID

public static final String USER_ID
UIMの個体識別番号を示す文字列です(= "user-id")。
FOMA 端末でのみ使用できます。 PDC 端末ではADFのGetUtnキーにuseridが指定されていても無視されるため、 getPropertyメソッドの引数に使用された場合、 SecurityExceptionをスローするのではなく、常にnullを返します。

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

TEL_AV

public static final String TEL_AV
TV 電話発信を示す文字列です(= "tel-av:")。
FOMA 端末でのみ使用できます。 call(String, XString) メソッドで TV 電話発信を行う際に第1引数に指定します。

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

call

public static final void call(String phoneNumber)

音声発信機能またはTV電話発信機能を呼び出します。 このメソッドが呼ばれると現在実行中のJavaアプリケーションはサスペンドされ、 ユーザ確認のダイアログが表示されます。 ユーザが発信を許可した場合は、Javaアプリケーションをサスペンドしたまま音声発信機能/TV電話発信機能を呼出します。 音声発信機能/TV電話発信機能の終了後、アプリケーションはレジュームします。

TV 電話発信機能は FOMA 端末でのみ使用できます。

パラメータ:
phoneNumber - 発信先を表す文字列を指定します。 音声発信機能を呼び出す場合は直接電話番号を指定し、 TV電話発信機能を呼び出す場合は文字列"tel-av:"に続けて電話番号を指定します。
電話番号には、数字('0'〜'9')と'#'と'*'と、その他 CTI で使用可能な文字(','(1秒待ち)と'/'(キー入力待ち))を使うことができます。 PDC 端末では '+' は無視しますが、 FOMA 端末では '+' は International Code として使うことができます。 また、'(', ')', '-', '.' は無視します。 FOMA 端末では ' ' (空白文字)も無視しますが、 PDC 端末では ' ' は不正な文字とみなされます。
例外:
IllegalStateException - 待ち受け実行の非活性化状態で呼び出された場合に発生します。
IllegalStateException - [DoJa-2.1] 通話中に呼び出された場合に発生します。
NullPointerException - 引数 phoneNumber に null が渡された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に不正な文字列が指定された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に端末がサポートしている以上の長さの電話番号が指定された場合に発生します。
SecurityException - ADFにUseTelephoneキーの指定がないアプリケーションから呼び出された場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により音声発信が許可されない場合に発生します。

call

public static final void call(XString phoneNumber)
音声発信機能を呼び出します。

引数に通常の文字列ではなくXStringを指定する以外、 call(String)メソッドと同じです。

パラメータ:
phoneNumber - 電話番号を表すXStringの文字列を指定します。
例外:
IllegalStateException - 待ち受け実行の非活性化状態で呼び出された場合に発生します。
IllegalStateException - [DoJa-2.1] 通話中に呼び出された場合に発生します。
NullPointerException - 引数 phoneNumber に null が渡された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に不正な文字列が指定された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に端末がサポートしている以上の長さの電話番号が指定された場合に発生します。
SecurityException - ADFにUseTelephoneキーの指定がないアプリケーションから呼び出された場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により音声発信が許可されない場合に発生します。
導入されたバージョン:
DoJa-3.0

call

public static final void call(String telType,
                              XString phoneNumber)

TV 電話発信機能を呼び出します。

第1引数に "tel-av:" を、第2引数に通常の文字列ではなくXStringで電話番号を指定する以外、 call(String)メソッドと同じです。

TV 電話発信機能は FOMA 端末でのみ使用できます。

パラメータ:
telType - TV 電話発信であることを表す文字列 "tel-av:" を指定します。
phoneNumber - 電話番号を表すXStringの文字列を指定します。
例外:
IllegalStateException - 待ち受け実行の非活性化状態で呼び出された場合に発生します。
IllegalStateException - [DoJa-2.1] 通話中に呼び出された場合に発生します。
NullPointerException - 引数 telType または phoneNumber に null が渡された場合に発生します。
IllegalArgumentException - 引数 telType に "tel-av:" 以外の文字列が指定された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に不正な文字列が指定された場合に発生します。
IllegalArgumentException - 引数 phoneNumber に端末がサポートしている以上の長さの電話番号が指定された場合に発生します。
SecurityException - ADFにUseTelephoneキーの指定がないアプリケーションから呼び出された場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により TV 電話発信が許可されない場合に発生します。
導入されたバージョン:
DoJa-3.5

getProperty

public static final String getProperty(String key)
指定されたキーに該当するプロパティ値を取得します。
取得できるプロパティのキーは、"terminal-id"と"user-id"の いずれかです。
無効なキーが指定された場合はnullを返します。

パラメータ:
key - プロパティを指定する文字列を指定します。
例外:
IllegalStateException - [DoJa-3.0] ADFのGetUtnキー設定により許可されていないとSecurityExceptionが 発生するプロパティのキーを指定して、 ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
NullPointerException - 引数にnullを指定して呼び出した場合に発生します。
IllegalArgumentException - 引数に空文字列を指定して呼び出した場合に発生します。
SecurityException - ADFのGetUtnキーのパラメータに terminalid の指定がないアプリケーションが引数に"terminal-id"を指定して呼び出した場合や、useridの指定がないアプリケーションが引数に"user-id"を指定して呼び出した場合に発生します。
導入されたバージョン:
DoJa-2.1


NTT DoCoMo,Inc.

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

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

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