com.kddi.io
インタフェース BarcodeConnection　＜Phase3＞

すべてのスーパーインタフェース:

javax.microedition.io.Connection

public interface BarcodeConnection

extends javax.microedition.io.Connection

バーコードを解読するためのインタフェースです。 移動機に搭載されているカメラを使用してバーコードを撮影し、 解読する機能を提供します。

バーコードを撮影して解読するには、 "barcode:" スキームを Connector.openメソッドに指定して BarcodeConnection オブジェクトを取得します。 コネクションを取得した後は、closeメソッドでコネクションを閉じるまで、 capture メソッドにより複数回撮影できます。

関連項目:

BarcodeContent

フィールドの概要

static int	AUTO バーコード種別が自動認識であることを示します。
static int	JAN バーコード種別が JAN コードであることを示します。
static int	QR バーコード種別が QR コードであることを示します。

メソッドの概要

BarcodeContent	capture() カメラを起動してバーコードを撮影します。
int	getCodeType() 優先的に認識するコード種別を返します。
boolean	isSupportedCode(int type) バーコードのコード種別サポート状況を返します。
boolean	setCodeType(int type) 優先的に認識させたいコード種別を設定します。

インタフェース javax.microedition.io.Connection から継承したメソッド

close

フィールドの詳細

AUTO

public static final int AUTO

バーコード種別が自動認識であることを示します。

JAN

public static final int JAN

バーコード種別が JAN コードであることを示します。

QR

public static final int QR

バーコード種別が QR コードであることを示します。

メソッドの詳細

capture

public BarcodeContent capture()
                       throws java.io.IOException

カメラを起動してバーコードを撮影します。 解読したデータはメモリ上に保存されます。

バーコードの解読結果のデータを読み出すには、 戻り値である BarcodeContent インスタンスの getBytes メソッド または getString メソッドを呼び出します。

このメソッドが呼び出されている間、Java VM はブロックされます。 このメソッドを呼び出すときは、 タイマや別スレッドは使わないようにするなど使用法に注意してください。

戻り値:

撮影したデータを保持する BarcodeContent インスタンス
キャンセル時は null

例外:

IllegalStateException - close() のあとに呼び出された場合に発生する

java.io.IOException - 解読に失敗した場合に発生する

isSupportedCode

public boolean isSupportedCode(int type)

バーコードのコード種別サポート状況を返します。

パラメータ:

type - コード種別として以下のどれかを指定する。

• AUTO
• JAN
• QR

戻り値:

引数type で指定されたバーコードをネイティブシステムがサポートしている場合は true、サポートしていない場合は false

例外:

java.lang.IllegalArgumentException - 引数 type に不正な値が指定された場合に発生する

setCodeType

public boolean setCodeType(int type)

優先的に認識させたいコード種別を設定します。

パラメータ:

type - コード種別として以下のどれかを指定する。

• AUTO
• JAN
• QR

戻り値:

引数 type で指定された形式を設定した場合は true、サポートしていない場合は false

例外:

java.lang.IllegalArgumentException - 引数 type に不正な値が指定された場合に発生する

このメソッドにより設定した値は、BarcodeConnectionがクローズするまで有効です。

getCodeType

public int getCodeType()

優先的に認識するコード種別を返します。 setCodeType(int) によって 優先的に認識させたいコード種別が設定されていない場合は、 移動機のデフォルトの認識コード種別を返します。

戻り値:

優先的に認識するコード種別