Camera

Camera

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

メソッド

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' として使用することが推奨されます。

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

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.7.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 };

オプション

Android に関する注意点

BlackBerry に関する注意点

Palm に関する注意点

iOS に関する注意点

Windows Phone 7 に関する注意点

Bada 1.2 に関する注意点