com.j_phone.io
インタフェース PhoneConnection

すべてのスーパーインタフェース:
javax.microedition.io.Connection

public interface PhoneConnection
extends javax.microedition.io.Connection

通話機能を実現するためのインタフェースです。

javax.microedition.io.Connector.open()に"phoneto:"スキームを指定して呼び出すと、 PhoneConnectionインタフェースを実装したコネクションオブジェクトを取得することができます。 このコネクションオブジェクトを使用して、Javaアプリケーションから指定した電話番号に対して電話をかけることができます。

電話をかけるには、Connector.open()の引数nameに"phoneto:"に続けて発信先の電話番号を指定します。 Javaアプリケーションは取得したオブジェクトのconnect()メソッドを呼び出すことにより通話の開始を要求します。 connect()はネイティブシステムに対して音声発信を要求し、通話が終了するまですべてのJavaスレッドをブロックします。 この間、Javaアプリケーションは一時停止状態となります。 通話が終了するとconnect()から復帰して、Javaアプリケーションは再開されます。

Javaアプリケーションは、getOffLineCause()メソッドによって通話が終了した理由を取得できます。

PhoneConnectionオブジェクトは、使い終わったらclose()メソッドで閉じます。

以下にコード例を示します。

 PhoneConnection call = null;
 
 try {
     call = (PhoneConnection)Connector.open("phoneto:0123456789");
                                            // 通話先を指定してコネクションオブジェクト取得
     call.connect();                        // 通話発信動作の開始
     int reason = call.getOffLineCause();   // 終話理由の取得
 } catch (Exception e) {
     ...
 } finally {
     if (call != null) {
         try { call.close(); } catch (Exception e) {}
     }
 }
 

導入されたバージョン:
JSCL 1.2

フィールドの概要
static int BEFORE_CALLING
          通話の終了理由で通話の準備に失敗したことを示します。
static int CANCEL_BY_MYSELF
          通話の終了理由でユーザーが通話をキャンセルしたことを示します。
static int ERROR
          通話の終了理由でその他のエラーを示します。
static int FORMAT_ERROR
          通話の終了理由で電話番号フォーマットのエラーだったことを示します。
static int LINE_ENGAGED
          通話の終了理由で相手、または自回線が使用中(通話中)だったことを示します。
static int NORMAL
          通話の終了理由で正常終了を示します。
static int OFF_LINE
          通話の終了理由でオフラインモードを示します。
static int OUT_OF_SERVICE
          通話の終了理由で発信時に圏外だったことを示します。
 
メソッドの概要
 void connect()
          通話発信を開始します。
 int getOffLineCause()
          通話が終了した理由を取得します。
 
インタフェース javax.microedition.io.Connection から継承したメソッド
close
 

フィールドの詳細

BEFORE_CALLING

public static final int BEFORE_CALLING
通話の終了理由で通話の準備に失敗したことを示します。

NORMAL

public static final int NORMAL
通話の終了理由で正常終了を示します。

CANCEL_BY_MYSELF

public static final int CANCEL_BY_MYSELF
通話の終了理由でユーザーが通話をキャンセルしたことを示します。

LINE_ENGAGED

public static final int LINE_ENGAGED
通話の終了理由で相手、または自回線が使用中(通話中)だったことを示します。

OFF_LINE

public static final int OFF_LINE
通話の終了理由でオフラインモードを示します。

OUT_OF_SERVICE

public static final int OUT_OF_SERVICE
通話の終了理由で発信時に圏外だったことを示します。

FORMAT_ERROR

public static final int FORMAT_ERROR
通話の終了理由で電話番号フォーマットのエラーだったことを示します。

ERROR

public static final int ERROR
通話の終了理由でその他のエラーを示します。
メソッドの詳細

connect

public void connect()
             throws java.io.IOException
通話発信を開始します。 このメソッドは通話処理が終了するまですべてのJavaスレッドをブロックします。

getOffLineCause

public int getOffLineCause()
                    throws java.io.IOException
通話が終了した理由を取得します。

戻り値:
通話の終了理由として以下のどれかの値を返す
例外:
java.io.IOException - 入出力エラーの場合に発生する