Camera

Camera

camera オブジェクトは、デバイスのカメラアプリへの制御を提供します。

メソッド

パーミッション

Android

app/res/xml/plugins.xml

<plugin name="Camera" value="org.apache.cordova.CameraLauncher" />

app/AndroidManifest

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Bada

manifest.xml

<Privilege>
    <Name>CAMERA</Name>
</Privilege>
<Privilege>
    <Name>RECORDING</Name>
</Privilege>

BlackBerry WebWorks

www/plugins.xml

<plugin name="Camera" value="org.apache.cordova.camera.Camera" />

www/config.xml

<feature id="blackberry.media.camera" />

<rim:permissions>
    <rim:permit>use_camera</rim:permit>
</rim:permissions>

iOS

App/Supporting Files/Cordova.plist

<key>Plugins</key>
<dict>
    <key>Camera</key>
    <string>CDVCamera</string>
</dict>

webOS

パーミッションの設定は必要ありません。

Windows Phone

Properties/WPAppManifest.xml

<Capabilities>
    <Capability Name="ID_CAP_CAMERA" />
    <Capability Name="ID_CAP_ISV_CAMERA" />
    <Capability Name="ID_HW_FRONTCAMERA" />
</Capabilities>

参照: Application Manifest for Windows Phone

camera.getPicture

デバイスのカメラで写真を撮る、またはデバイスのアルバム内にある写真を検索します。 Base64 形式でエンコードされたフォトイメージを表す文字列、またはイメージファイルの URI が返されます。

navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );

概要

camera.getPicture 関数はユーザーが写真を撮れるように、デバイスが標準で備えるカメラアプリを起動します (もしデフォルト設定である Camera.sourceType = Camera.PictureSourceType.CAMERA の場合) 。写真の撮影が完了するとカメラアプリは終了し、アプリケーションに戻ります。

もし Camera.sourceType = Camera.PictureSourceType.PHOTOLIBRARY もしくは Camera.PictureSourceType.SAVEDPHOTOALBUM が指定された場合、写真選択ダイアログが表示され、アルバムから写真を選択できるようになります。

返り値は cameraSuccess 関数に送信されます。値は cameraOptions の設定に従い、以下のいずれかのフォーマットで送られます:

エンコードされたイメージや URI をもとに、以下のような処理の記述が可能です:

注意: iPhone 4 や Black Berry Touch 9800 などの最新デバイスで撮影したイメージの画質は良好で、フォトアルバムから取得する画像はたとえ quality パラメーターで画質を指定したとしても、縮小されません。 そのような画像を Base64 でエンコードすると、メモリーの問題が発生します。 よって、 FILE_URI を 'Camera.destinationType' として使用することが推奨されます。

サポートされているプラットフォーム

iOS に関する注意点

JavaScript の alert() をコールバック関数に含めると、問題が生じる可能性があります。 alert を setTimeout() でラップすることで、 alert が表示される前に iOS の image picker または popover が完全に閉じるようにします: setTimeout("alert('message');", 0);

Windows Phone 7 に関する注意点

Zune とデバイスが接続している間は、ネイティブカメラアプリケーションは起動せずに、エラーコールバックが呼び出されます。

使用例

写真を撮影し、 Base64 形式のイメージとして取得します。

navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
    destinationType: Camera.DestinationType.DATA_URL
 });

function onSuccess(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

function onFail(message) {
    alert('エラーが発生しました: ' + message);
}

撮影した写真の URI を取得します。

navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
    destinationType: Camera.DestinationType.FILE_URI });

function onSuccess(imageURI) {
    var image = document.getElementById('myImage');
    image.src = imageURI;
}

function onFail(message) {
    alert('エラーが発生しました: ' + message);
}

詳細な使用例 

<!DOCTYPE html>
<html>
  <head>
    <title>写真を撮ってみよう</title>

    <script type="text/javascript" charset="utf-8" src="cordova-1.9.0.js"></script>
    <script type="text/javascript" charset="utf-8">

    var pictureSource;   // 写真ソース
    var destinationType; // 戻り値のフォーマット

    // Cordova がデバイスと接続するまで待機
    //
    document.addEventListener("deviceready",onDeviceReady,false);

    // Cordova 準備完了
    //
    function onDeviceReady() {
        pictureSource=navigator.camera.PictureSourceType;
        destinationType=navigator.camera.DestinationType;
    }

    // 写真の撮影に成功した場合 (URI 形式)
    //
    function onPhotoDataSuccess(imageData) {
      // 下記のコメントを外すことで Base64 形式のデータをログに出力
      // console.log(imageData);

      // 画像ハンドルを取得
      //
      var smallImage = document.getElementById('smallImage');

      // 画像要素を表示
      //
      smallImage.style.display = 'block';

      // 取得した写真を表示
      // 画像のリサイズにインライン CSS を使用
      //
      smallImage.src = "data:image/jpeg;base64," + imageData;
    }

    // 写真の撮影に成功した場合 (URI  形式)
    //
    function onPhotoURISuccess(imageURI) {
      // 下記のコメントを外すことでファイル URI をログに出力
      // console.log(imageURI);

      // 画像ハンドルを取得
      //
      var largeImage = document.getElementById('largeImage');

      // 画像要素を表示
      //
      largeImage.style.display = 'block';

      // 取得した写真を表示
      // 画像のリサイズにインライン CSS を使
      //
      largeImage.src = imageURI;
    }

    // ボタンがクリックされた場合の処理
    //
    function capturePhoto() {
      // 編集が許可された写真を撮影し、 Base64 形式のイメージとして取得する場合
      navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 50,
        destinationType: destinationType.DATA_URL });
    }

    // ボタンがクリックされた場合の処理
    //
    function capturePhotoEdit() {
      // 編集が許可された写真を撮影し、 Base64 形式のイメージとして取得する場合
      navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true,
        destinationType: destinationType.DATA_URL });
    }

    // ボタンがクリックされた場合の処理
    //
    function getPhoto(source) {
      // 写真をファイル URI として取得する場合
      navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,
        destinationType: destinationType.FILE_URI,
        sourceType: source });
    }

    // エラー発生時の処理
    //
    function onFail(message) {
      alert('エラーが発生しました: ' + message);
    }

    </script>
  </head>
  <body>
    <button onclick="capturePhoto();">写真を撮影</button> <br>
    <button onclick="capturePhotoEdit();">写真を撮影して編集</button> <br>
    <button onclick="getPhoto(pictureSource.PHOTOLIBRARY);">フォトライブラリから取得</button><br>
    <button onclick="getPhoto(pictureSource.SAVEDPHOTOALBUM);">フォトアルバムから取得</button><br>
    <img style="display:none;width:60px;height:60px;" id="smallImage" src="" />
    <img style="display:none;" id="largeImage" src="" />
  </body>
</html>

cameraSuccess

撮影が成功したときに呼び出されるコールバック関数です。

function(imageData) {
    // 任意のコード
}

パラメーター

使用例 

// 画像を表示
//
function cameraCallback(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

cameraError

エラーが発生した場合に呼び出されるコールバック関数です。

function(message) {
    // エラーメッセージを表示
}

パラメーター

cameraOptions

カメラの設定をカスタマイズするのためのオプションパラメーターです。

{ quality : 75,
  destinationType : Camera.DestinationType.DATA_URL,
  sourceType : Camera.PictureSourceType.CAMERA,
  allowEdit : true,
  encodingType: Camera.EncodingType.JPEG,
  targetWidth: 100,
  targetHeight: 100,
  popoverOptions: CameraPopoverOptions,
  saveToPhotoAlbum: false };

オプション

Android に関する注意点

BlackBerry に関する注意点

WebOS に関する注意点

iOS に関する注意点

Windows Phone 7 に関する注意点

Bada 1.2 に関する注意点

CameraPopoverOptions

画像をライブラリーもしくはアルバムから選択する際の、 iPad でのポップオーバーの位置や矢印の向きを指定するためのパラメーターです。 iOS のみのオプションです。

{ x : 0,
  y :  32,
  width : 320,
  height : 480,
  arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
};

CameraPopoverOptions

ポップオーバーのサイズは矢印の方向や画面の向きによって調節され、変わる可能性があることについて注意してください。アンカー要素の位置を特定するとき、画面の向きの変化を考慮に入れることを忘れないで下さい。

使用例 

var popover = new CameraPopoverOptions(300,300,100,100,Camera.PopoverArrowDirection.ARROW_ANY);
var options = { quality: 50, destinationType: Camera.DestinationType.DATA_URL,sourceType: Camera.PictureSource.SAVEDPHOTOALBUM, popoverOptions : popover };

navigator.camera.getPicture(onSuccess, onFail, options);

function onSuccess(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

function onFail(message) {
    alert('Failed because: ' + message);
}