com.docomostar.device
クラス Camera

Object
  上位を拡張 com.docomostar.device.Camera

public class Camera
extends Object

携帯電話のネイティブのカメラ機能を呼び出して、 静止画/動画を撮影する機能にアクセスする手段を提供します。

静止画を撮影するためには、takePicture()メソッドを呼び出します。 呼び出し前に指定した画像サイズ、画質、連写モード、フレーム画像、接写モードを反映して、 静止画を撮影するモードでカメラ機能を立ち上げます。

動画を撮影するためには、takeMovie()メソッドを呼び出します。 呼び出し前に指定した画像サイズ、画質、マイク音量、接写モードを反映して、 動画を撮影するモードでカメラ機能を立ち上げます。

カメラ機能を立ち上げたら、 撮影時にユーザ操作により静止画と動画の撮影モードを切り替えることはできません。 また、カメラ機能を立ち上げる前に指定した画像サイズ、画質、連写モード、 フレーム画像、マイク音量の設定についても、 ユーザ操作により変更することはできません。

なお、これらの設定はStar アプリからの撮影時のみに有効です。

ユーザの操作によりカメラ機能が終了すると、 takePicture/takeMovieメソッドから復帰します。 ユーザがカメラ機能で撮影を行い、撮影画像を保存した場合は、 カメラオブジェクト内にその撮影画像が保持されます。 ユーザが撮影を行わなかったり、あるいは撮影画像を保存しなかった場合は、 カメラオブジェクト内に撮影画像は保持されません。

カメラ機能は、コード認識機能と同じカメラデバイスを使用します。 そのため、同じカメラIDを持つCamera オブジェクトとCodeReaderオブジェクトは互いに状態に影響を与えます。 カメラ機能を用いて撮影を行った後にコード認識を行った場合は、 Cameraオブジェクトから撮影画像を取り出せる保証はありません。 同様に、コード認識を行った後にカメラ機能を用いて撮影を行った場合は、 CodeReaderオブジェクトからコード認識の結果を取り出せる保証はありません。

Star アプリからのフォーカス切り替えをサポートしているかどうかは機種依存です。 Star アプリからのフォーカス切り替えをサポートする場合、 ネイティブ起動中にユーザ操作により、 Star アプリで設定したフォーカスを変更することができます。 なお、Star アプリからネイティブ起動する場合、Camera オブジェクト内のフォーカス設定がネイティブに渡されますが、 ネイティブ起動中に行われたフォーカス設定は、Camera オブジェクト内には保持されません。

導入されたバージョン:
Star-1.0

フィールドの概要
static int ATTR_CONTINUOUS_SHOT_OFF [iアプリオプションAPI]
          連写モード属性の一つで連写モードが無効であることを表します(=0)。
static int ATTR_CONTINUOUS_SHOT_ON [iアプリオプションAPI]
          連写モード属性の一つで連写モードが有効であることを表します(=1)。
static int ATTR_FRAME_OFF
          フレーム画像付きの静止画撮影の可否属性の一つで撮影不可であることを表します(=0)。
static int ATTR_FRAME_ON
          フレーム画像付きの静止画撮影の可否属性の一つで撮影可能であることを表します(=1)。
static int ATTR_QUALITY_HIGH [iアプリオプションAPI]
          画質属性の一つで品質優先を表します(=0)。
static int ATTR_QUALITY_LOW [iアプリオプションAPI]
          画質属性の一つで録画時間または画像データのサイズ優先を表します(=2)。
static int ATTR_QUALITY_STANDARD
          画質属性の一つで標準を表します(=1)。
static int ATTR_VOLUME_MAX [iアプリオプションAPI]
          マイク入力の音量調整の属性の一つで最大音量を表します(=127)。
static int ATTR_VOLUME_MIN [iアプリオプションAPI]
          マイク入力の音量調整の属性の一つで最小音量(ミュート状態)を表します(=0)。
static int DEV_CONTINUOUS_IMAGES
          連写モードの連写可能な最大コマ数を表します(=3)。
static int DEV_CONTINUOUS_SHOT [iアプリオプションAPI]
          連写モードを表します(=0)。
static int DEV_FRAME_SHOT
          フレーム画像付きの静止画撮影の可否を表します(=4)。
static int DEV_QUALITY [iアプリオプションAPI]
          画質を表します(=1)。
static int DEV_SOUND [iアプリオプションAPI]
          マイク入力の音量調整を表します(=2)。
static int FOCUS_AUTO_MODE [iアプリオプションAPI]
          フォーカスの種類の一つで、オートフォーカスモードであることを表します(=2)。
static int FOCUS_CONTINUOUS_AUTO_MODE [iアプリオプションAPI]
          フォーカスの種類の一つで、コンティニュアスオートフォーカスモードであることを表します(=3)。
static int FOCUS_HARDWARE_SWITCH [iアプリオプションAPI]
          フォーカスの種類の一つで、フォーカス切り替えがハードウェアによる機構であることを表します(=-1)。
static int FOCUS_MACRO_MODE [iアプリオプションAPI]
          フォーカスの種類の一つで、接写モードであることを表します(=1)。
static int FOCUS_NORMAL_MODE [iアプリオプションAPI]
          フォーカスの種類の一つで、通常モードであることを表します(=0)。
 
コンストラクタの概要
protected Camera()
          アプリケーションが直接このコンストラクタを呼び出して オブジェクトを生成することはできません。
 
メソッドの概要
 void disposeImages()
          カメラオブジェクト内のすべての撮影画像を破棄します。
 int getAttribute(int attr)
          カメラの属性値を取得します。
 int[] getAvailableFocusModes()
          端末で設定できるフォーカスの種類のリストを取得します。
 int[][] getAvailableFrameSizes()
          静止画撮影時に使用可能なフレーム画像のサイズを取得します。
 int[][] getAvailableMovieSizes()
          撮影可能な動画の画像サイズを取得します。
 int[][] getAvailablePictureSizes()
          撮影可能な静止画の画像サイズを取得します。
static Camera getCamera(int id)
          カメラオブジェクトを取得します。
 int getFocusMode()
          フォーカスの設定状態を取得します。
 MediaResource getImage(int index)
          カメラオブジェクト内の、 指定されたインデックスにある撮影画像を メディアリソースオブジェクトとして取得します。
 long getImageLength(int index)
          カメラオブジェクト内の、 指定されたインデックスにある撮影画像のデータサイズを取得します。
 java.io.InputStream getInputStream(int index)
           カメラオブジェクト内の、 指定されたインデックスにある撮影画像を読み出すための 入力ストリームを取得します。
 long getMaxMovieLength()
          カメラ機能にて動画撮影する場合に、撮影可能な最大データサイズを取得します。
 int getNumberOfImages()
          カメラオブジェクト内に保持されている撮影画像数を取得します。
 boolean isAvailable(int attr)
          カメラの属性が設定可能かどうかを調べます。
 void setAttribute(int attr, int value)
          カメラの属性を設定します。
 void setFocusMode(int mode) [iアプリオプションAPI]
          フォーカスを設定します。
 void setFrameImage(MediaImage image)
          カメラ撮影時にフレーム画像として使用する画像を設定します。
 void setImageSize(int width, int height)
          撮影画像のサイズを設定します。
 void takeMovie() [iアプリオプションAPI]
          カメラ機能を動画撮影モードで呼び出します。
 void takePicture()
          カメラ機能を静止画撮影モードで呼び出します。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

DEV_CONTINUOUS_SHOT

public static final int DEV_CONTINUOUS_SHOT [iアプリオプションAPI]
連写モードを表します(=0)。

属性の設定と取得が可能です。

連写モードでの連写可能コマ数は機種依存ですが、 DEV_CONTINUOUS_IMAGES属性により、 最大連写可能コマ数を取得できます。

連写不可能な画像サイズやフレーム画像の設定時に連写モードを有効にしようとした場合、 Cameraオブジェクトの属性としては連写モードは有効になります。 しかし、DEV_CONTINUOUS_IMAGES属性の値は1であり、 takePicture()メソッドを呼び出しても連写はできません。

関連項目:
定数フィールド値

ATTR_CONTINUOUS_SHOT_OFF

public static final int ATTR_CONTINUOUS_SHOT_OFF [iアプリオプションAPI]
連写モード属性の一つで連写モードが無効であることを表します(=0)。
連写モード属性のデフォルト値です。

関連項目:
定数フィールド値

ATTR_CONTINUOUS_SHOT_ON

public static final int ATTR_CONTINUOUS_SHOT_ON [iアプリオプションAPI]
連写モード属性の一つで連写モードが有効であることを表します(=1)。

関連項目:
定数フィールド値

DEV_QUALITY

public static final int DEV_QUALITY [iアプリオプションAPI]
画質を表します(=1)。

属性の設定と取得が可能です。

関連項目:
定数フィールド値

ATTR_QUALITY_HIGH

public static final int ATTR_QUALITY_HIGH [iアプリオプションAPI]
画質属性の一つで品質優先を表します(=0)。

関連項目:
定数フィールド値

ATTR_QUALITY_STANDARD

public static final int ATTR_QUALITY_STANDARD
画質属性の一つで標準を表します(=1)。
画質属性のデフォルト値です。

関連項目:
定数フィールド値

ATTR_QUALITY_LOW

public static final int ATTR_QUALITY_LOW [iアプリオプションAPI]
画質属性の一つで録画時間または画像データのサイズ優先を表します(=2)。

関連項目:
定数フィールド値

DEV_SOUND

public static final int DEV_SOUND [iアプリオプションAPI]
マイク入力の音量調整を表します(=2)。

属性の設定と取得が可能です。

属性値にはATTR_VOLUME_MIN(=0)〜ATTR_VOLUME_MAX(=127)を指定 します。デフォルト値は100です。

関連項目:
定数フィールド値

ATTR_VOLUME_MIN

public static final int ATTR_VOLUME_MIN [iアプリオプションAPI]
マイク入力の音量調整の属性の一つで最小音量(ミュート状態)を表します(=0)。 TINUOUS_SHOT_ON
public static final int ATTR_CONTINUOUS_SHOT_ON [i繧「繝励Μ繧ェ繝励す繝ァ繝ウAPI]
騾」蜀吶Δ繝シ繝牙ア樊