com.nttdocomo.util
クラス Phone

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

public class Phone

extends java.lang.Object

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

導入されたバージョン:

DoJa-2.0

フィールドの概要

static java.lang.String	TERMINAL_ID 携帯電話の個体識別番号を示す文字列です。
static java.lang.String	USER_ID UIMの個体識別番号を示す文字列です。

メソッドの概要

static void	call(java.lang.String phoneNumber) 音声発信機能またはTV電話発信機能を呼び出します。
static java.lang.String	getProperty(java.lang.String key) 指定されたキーに該当するプロパティ値を取得します。

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

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

フィールドの詳細

TERMINAL_ID

public static final java.lang.String TERMINAL_ID

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

導入されたバージョン:

DoJa-2.1

USER_ID

public static final java.lang.String USER_ID

UIMの個体識別番号を示す文字列です。(= "user-id")

導入されたバージョン:

DoJa-2.1

メソッドの詳細

call

public static final void call(java.lang.String phoneNumber)

音声発信機能またはTV電話発信機能を呼び出します。 このメソッドが呼ばれると現在実行中のJavaアプリケーションはサスペンドされ、 ユーザ確認のダイアログが表示されます。 ユーザが発信を許可した場合は、このメソッドから戻ることなく音声発信機能/TV電話発信機能を呼出します。 電話をかけている間のアプリケーション動作は、 基本的に音声着信時のサスペンド/レジュームと同じです。

パラメータ:

phoneNumber - 宛て先を表す文字列を指定します。 音声発信機能を呼び出す場合は直接電話番号を指定し、TV電話発信機能を呼び出す場合は文字列 "tel-av:" に続けて電話番号を指定します。 電話番号には、数字('0'〜'9')と'#'と'*'と、その他 CTI で使用可能な文字(','(1秒待ち)と'/'(キー入力待ち))を使うことができます。 また、'-' は無視します。

例外:

NullPointerException - 引数 phoneNumber に null が渡された場合に発生します。

IllegalArgumentException - 引数 phoneNumber に不正な文字列が指定された場合、引数 phoneNumber に実装がサポートしている以上の長さの電話番号が指定された場合に発生します。

IllegalStateException - 待ち受け実行の非活性化状態で呼び出された場合に発生します。
[DoJa-2.1] また、通話中に呼び出された場合にも発生します。

SecurityException - ADFにUseTelephoneキーの指定がないアプリケーションから呼び出された場合に発生します。

getProperty

public static final java.lang.String getProperty(java.lang.String key)

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

パラメータ:

key - プロパティを指定する文字列を指定します。

例外:

SecurityException - ADFのGetUtnキーのパラメータに terminalid の指定がないアプリケーションが引数に"terminal-id"を指定して呼び出した場合や、useridの指定がないアプリケーションが引数に"user-id"を指定して呼び出した場合に発生します。

IllegalArgumentException - 引数に空文字を指定して呼び出した場合に発生します。

NullPointerException - 引数にnullを指定して呼び出した場合に発生します。

導入されたバージョン:

DoJa-2.1