Vodafone Java(tm) テクノロジプラットフォーム仕様

com.vodafone.media.barcode
インタフェース BarcodeControl

すべてのスーパーインタフェース:
javax.microedition.media.Control, javax.microedition.media.control.GUIControl

public interface BarcodeControl
extends javax.microedition.media.control.GUIControl

バーコードデータのキャプチャを制御します。バーコードデータのキャプチャをサポートする Player は、getControl メソッドと getControls メソッドを使って BarcodeControl を提供する必要があります。

Manager 実装が指定したメディアロケータの Player を返すことができない場合は、MediaException が発生します。

Player の状態

setType() メソッドは、この Control が属する PlayerREALIZED 状態のときだけ呼び出すことができます。capture() メソッドは、この Control が属する PlayerSTARTED 状態のときだけ呼び出すことができます。getData() メソッド、getType() メソッドからアクセス可能なバーコードデータはすべて、capture() メソッドが再度呼び出されるか、この Control を作成した PlayerCLOSED 状態になるまで使用可能です。

導入されたバージョン:
VSCL2.0

フィールドの概要
 
インタフェース javax.microedition.media.control.GUIControl から継承したフィールド
USE_GUI_PRIMITIVE
 
メソッドの概要
 void capture()
          バーコードエンジンからバーコードデータを読み取ります。
 byte[] getData()
          直前の capture の呼び出しで取得したバーコードのデータを返します。
 java.lang.String getType()
          直前の capture の呼び出しで取得したバーコードのタイプを返します。
 boolean isSupported(java.lang.String captureURL)
          指定した captureURL がサポートされているかどうかを確認します。
 void setType(java.lang.String barcodeType)
          認識対象の初期バーコードタイプを設定します。
 
インタフェース javax.microedition.media.control.GUIControl から継承したメソッド
initDisplayMode
 

メソッドの詳細

capture

public void capture()
             throws java.io.IOException
バーコードエンジンからバーコードデータを読み取ります。以前に取得したバーコードデータはすべて使用できなくなります。以下に、バーコードデータの読み取りを開始する capture の使用例を示します。


   Player p = Manager.createPlayer("capture://barcode?type=JAN");
   p.realize();
   BarcodeControl bc = (BarcodeControl)p.getControl(
     "com.vodafone.media.barcode.BarcodeControl");
   p.start();

   //ユーザーがキャプチャプロセスを開始
   bc.capture();
   byte[] data = bc.getData();
 

例外:
java.io.IOException - バーコードの読み取り中にエラーが発生した場合、あるいは認識が中断された場合
java.lang.IllegalStateException - このコントロールが属する Player が STARTED 状態でない場合

getData

public byte[] getData()
直前の capture の呼び出しで取得したバーコードのデータを返します。

戻り値:
実際の取得データのバイト配列 (新しい配列インスタンス)。 capture() が呼び出されていない、あるいは例外が発生した場合は null
関連項目:
capture()

getType

public java.lang.String getType()
直前の capture の呼び出しで取得したバーコードのタイプを返します。

戻り値:
バーコードタイプの文字列。capture() が呼び出されていないか例外が発生した場合は null
関連項目:
setType(java.lang.String), capture()

isSupported

public boolean isSupported(java.lang.String captureURL)
指定した captureURL がサポートされているかどうかを確認します。

パラメータ:
captureURL - メディアロケータ
戻り値:
ロケータがサポートされている場合は true、サポートされていない場合は false

setType

public void setType(java.lang.String barcodeType)
認識対象の初期バーコードタイプを設定します。このコントロールが作成されたときに指定された値は無効になります。

パラメータ:
barcodeType - 認定またはサポートされているバーコードタイプ。次の種類があります。UPCJANEANQRCodeDatamatrix など
例外:
java.lang.IllegalArgumentException - barcodeType が無効な場合。
java.lang.IllegalStateException - このコントロールが属する PlayerREALIZED 状態ではない場合
関連項目:
getType(), isSupported(java.lang.String)

Vodafone Java(tm) テクノロジプラットフォーム仕様

Vodafone Java テクノロジプラットフォーム仕様 バージョン 1.0.5
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。Copyright(c) 2004, Vodafone Group Copyright 2003-2004 Sun Microsystems All Rights Reserved.