com.docomostar.system
クラス Phone

Object
  com.docomostar.system.Phone

public final class Phone
extends Object

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

本クラスにおける「ネイティブの通話機能」とは以下の通話機能のことを表します。

• 音声発信機能
• テレビ電話発信機能
• [Star-1.1 まで] PTT呼発信機能

導入されたバージョン:

Star-1.0

フィールドの概要

static String

TEL_AV 推奨されていません。 TEL_AV の指定は意味を持ちません。

メソッドの概要

static void	call(String phoneNumber) ネイティブの通話機能を呼び出します。
static void	call(String telType, XString phoneNumber) 推奨されていません。 引数 telType の指定は意味を持たないため call(XString) を利用して下さい。
static void	call(XString phoneNumber) ネイティブの通話機能を呼び出します。

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

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

フィールドの詳細

TEL_AV

public static final String TEL_AV

推奨されていません。 TEL_AV の指定は意味を持ちません。

テレビ電話発信を示す文字列です(= "tel-av:")。
call(String, XString) メソッドでテレビ電話発信を行う際に第1引数に指定します。

関連項目:

定数フィールド値

メソッドの詳細

call

public static final void call(String phoneNumber)

ネイティブの通話機能を呼び出します。 このメソッドが呼ばれると現在実行中の Star アプリはサスペンドされ、 ユーザ確認のダイアログが表示されます。 ユーザが発信を許可した場合は、 Star アプリをサスペンドしたまま ネイティブの通話機能を呼び出します。 ネイティブの通話機能では、 ユーザが発信種別を選択後、 発信します。 ネイティブの通話機能の終了後、 アプリケーションはレジュームします。 なお、発信種別については以下の中から選択します。

• 音声
• テレビ電話
• [Star-1.1 まで] PTT 呼

引数 phoneNumber には直接電話番号を指定します。 "tel-av:" に続けて電話番号を指定できますが、 その場合でもテレビ電話発信にはならず、 発信種別は、常にネイティブでユーザが選択した発信種別となります。 引数 phoneNumber に使用可能な文字は以下の通りです。

分類	文字	意味
電話番号	'0' 〜 '9'・'#'・'*'	-
International Code	'+'	International Code
CTI で使用可能な文字	','	1秒待ち
	'/'	キー入力待ち
	'p'	キー入力待ち('/' と同じ意味として利用可能)
区切り文字	'('	無視されます
	')'
	'-'
	'.'
	' ' (空白)

パラメータ:

phoneNumber - 発信先を表す文字列を指定します。

例外:

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

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

IllegalArgumentException -
引数 phoneNumber に不正な文字列が指定された場合に発生します。

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

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

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 ネイティブの通話機能による発信が許可されない場合に発生します。 ダイアル発信制限が設定されている場合も含みます。

IllegalStateException -
音声・テレビ電話通話中に呼び出された場合に発生します。

IllegalStateException -
[Star-1.1 まで] PTT呼通信中に呼び出された場合に発生します。

call

public static final void call(XString phoneNumber)

ネイティブの通話機能を呼び出します。

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

パラメータ:

phoneNumber - 電話番号を表すXStringの文字列を指定します。

例外:

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

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

IllegalArgumentException -
引数 phoneNumber に不正な文字列が指定された場合に発生します。

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

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

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により ネイティブの通話機能による発信 が許可されない場合に発生します。 ダイアル発信制限が設定されている場合も含みます。

IllegalStateException -
音声・テレビ電話通話中に呼び出された場合に発生します。

IllegalStateException -
[Star-1.1 まで] PTT呼通信中に呼び出された場合に発生します。

call

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

推奨されていません。 引数 telType の指定は意味を持たないため call(XString) を利用して下さい。

ネイティブの通話機能を呼び出します。

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

パラメータ:

telType - テレビ電話発信であることを表す文字列 "tel-av:" を指定します。

phoneNumber - 電話番号を表すXStringの文字列を指定します。

例外:

IllegalStateException -
ミニアプリ実行時の Focused または Unfocused 状態で呼び出された場合に発生します。

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

IllegalArgumentException -
引数 telType に "tel-av:" 以外の文字列が指定された場合に発生します。

IllegalArgumentException -
引数 phoneNumber に不正な文字列が指定された場合に発生します。

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

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

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により ネイティブの通話機能による発信 が許可されない場合に発生します。 ダイアル発信制限が設定されている場合も含みます。

IllegalStateException -
音声・テレビ電話通話中に呼び出された場合に発生します。

IllegalStateException -
[Star-1.1 まで] PTT呼通信中に呼び出された場合に発生します。