Android輕松拍攝照片

編寫:kesenhoo - 原文:http://developer.android.com/training/camera/photobasics.html

這節(jié)課將講解如何使用已有的相機(jī)應(yīng)用拍攝照片。

假設(shè)我們正在實(shí)現(xiàn)一個(gè)基于人群的氣象服務(wù)，通過應(yīng)用客戶端拍下的天氣圖片匯聚在一起，可以組成全球氣象圖。整合圖片只是應(yīng)用的一小部分，我們想要通過最簡(jiǎn)單的方式獲取圖片，而不是重新設(shè)計(jì)并實(shí)現(xiàn)一個(gè)具有相機(jī)功能的組件。幸運(yùn)的是，通常來說，大多數(shù)Android設(shè)備都已經(jīng)安裝了至少一款相機(jī)程序。在這節(jié)課中，我們會(huì)學(xué)習(xí)如何利用已有的相機(jī)應(yīng)用拍攝照片。

請(qǐng)求使用相機(jī)權(quán)限

如果拍照是應(yīng)用的必要功能，那么應(yīng)該令它在Google Play中僅對(duì)有相機(jī)的設(shè)備可見。為了讓用戶知道我們的應(yīng)用需要依賴相機(jī)，在Manifest清單文件中添加<uses-feature>標(biāo)簽:

 <manifest ... >
    <uses-feature android:name="android.hardware.camera"
                  android:required="true" />
    ...
</manifest>

如果我們的應(yīng)用使用相機(jī)，但相機(jī)并不是應(yīng)用的正常運(yùn)行所必不可少的組件，可以將android:required設(shè)置為"false"。這樣的話，Google Play 也會(huì)允許沒有相機(jī)的設(shè)備下載該應(yīng)用。當(dāng)然我們有必要在使用相機(jī)之前通過調(diào)用hasSystemFeature(PackageManager.FEATURE_CAMERA)方法來檢查設(shè)備上是否有相機(jī)。如果沒有，我們應(yīng)該禁用和相機(jī)相關(guān)的功能！

使用相機(jī)應(yīng)用程序進(jìn)行拍照

利用一個(gè)描述了執(zhí)行目的Intent對(duì)象，Android可以將某些執(zhí)行任務(wù)委托給其他應(yīng)用。整個(gè)過程包含三部分： Intent 本身，一個(gè)函數(shù)調(diào)用來啟動(dòng)外部的 Activity，當(dāng)焦點(diǎn)返回到我們的Activity時(shí)，處理返回圖像數(shù)據(jù)的代碼。

下面的函數(shù)通過發(fā)送一個(gè)Intent來捕獲照片：

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    }
}

注意在調(diào)用startActivityForResult()方法之前，先調(diào)用resolveActivity()，這個(gè)方法會(huì)返回能處理該Intent的第一個(gè)Activity（譯注：即檢查有沒有能處理這個(gè)Intent的Activity）。執(zhí)行這個(gè)檢查非常重要，因?yàn)槿绻谡{(diào)用startActivityForResult()時(shí)，沒有應(yīng)用能處理你的Intent，應(yīng)用將會(huì)崩潰。所以只要返回結(jié)果不為null，使用該Intent就是安全的。

獲取縮略圖

拍攝照片并不是應(yīng)用的最終目的，我們還想要從相機(jī)應(yīng)用那里取回拍攝的照片，并對(duì)它執(zhí)行某些操作。

Android的相機(jī)應(yīng)用會(huì)把拍好的照片編碼為縮小的Bitmap，使用extra value的方式添加到返回的Intent當(dāng)中，并傳送給onActivityResult()，對(duì)應(yīng)的Key為"data"。下面的代碼展示的是如何獲取這一圖片并顯示在ImageView上。

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
        Bundle extras = data.getExtras();
        Bitmap imageBitmap = (Bitmap) extras.get("data");
        mImageView.setImageBitmap(imageBitmap);
    }
}

Note: 這張從"data"中取出的縮略圖適用于作為圖標(biāo)，但其他作用會(huì)比較有限。而處理一張全尺寸圖片需要做更多的工作。

保存全尺寸照片

如果我們提供了一個(gè)File對(duì)象給Android的相機(jī)程序，它會(huì)保存這張全尺寸照片到給定的路徑下。另外，我們必須提供存儲(chǔ)圖片所需要的含有后綴名形式的文件名。

一般而言，用戶使用設(shè)備相機(jī)所拍攝的任何照片都應(yīng)該被存放在設(shè)備的公共外部存儲(chǔ)中，這樣它們就能被所有的應(yīng)用訪問。將DIRECTORY_PICTURES作為參數(shù)，傳遞給getExternalStoragePublicDirectory()方法，可以返回適用于存儲(chǔ)公共圖片的目錄。由于該方法提供的目錄被所有應(yīng)用共享，因此對(duì)該目錄進(jìn)行讀寫操作分別需要READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE權(quán)限。另外，因?yàn)閷憴?quán)限隱含了讀權(quán)限，所以如果需要外部存儲(chǔ)的寫權(quán)限，那么僅僅需要請(qǐng)求一項(xiàng)權(quán)限就可以了：

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

然而，如果希望照片對(duì)我們的應(yīng)用而言是私有的，那么可以使用getExternalFilesDir()提供的目錄。在Android 4.3及以下版本的系統(tǒng)中，寫這個(gè)目錄需要WRITE_EXTERNAL_STORAGE權(quán)限。從Android 4.4開始，該目錄將無法被其他應(yīng)用訪問，所以該權(quán)限就不再需要了，你可以通過添加maxSdkVersion屬性，聲明只在低版本的Android設(shè)備上請(qǐng)求這個(gè)權(quán)限。

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

Note: 所有存儲(chǔ)在getExternalFilesDir()提供的目錄中的文件會(huì)在用戶卸載你的app后被刪除。

一旦選定了存儲(chǔ)文件的目錄，我們還需要設(shè)計(jì)一個(gè)保證文件名不會(huì)沖突的命名規(guī)則。當(dāng)然我們還可以將路徑存儲(chǔ)在一個(gè)成員變量里以備在將來使用。下面的例子使用日期時(shí)間戳作為新照片的文件名：

String mCurrentPhotoPath;

private File createImageFile() throws IOException {
    // Create an image file name
    String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
    String imageFileName = "JPEG_" + timeStamp + "_";
    File storageDir = Environment.getExternalStoragePublicDirectory(
            Environment.DIRECTORY_PICTURES);
    File image = File.createTempFile(
        imageFileName,  /* prefix */
        ".jpg",         /* suffix */
        storageDir      /* directory */
    );

    // Save a file: path for use with ACTION_VIEW intents
    mCurrentPhotoPath = "file:" + image.getAbsolutePath();
    return image;
}

有了上面的方法，我們就可以給新照片創(chuàng)建文件對(duì)象了，現(xiàn)在我們可以像這樣創(chuàng)建并觸發(fā)一個(gè)Intent：

static final int REQUEST_TAKE_PHOTO = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    // Ensure that there's a camera activity to handle the intent
    if (takePictureIntent.resolveActivity(getPackageManager()) != null) {
        // Create the File where the photo should go
        File photoFile = null;
        try {
            photoFile = createImageFile();
        } catch (IOException ex) {
            // Error occurred while creating the File
            ...
        }
        // Continue only if the File was successfully created
        if (photoFile != null) {
            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT,
                    Uri.fromFile(photoFile));
            startActivityForResult(takePictureIntent, REQUEST_TAKE_PHOTO);
        }
    }
}

將照片添加到相冊(cè)中

由于我們通過Intent創(chuàng)建了一張照片，因此圖片的存儲(chǔ)位置我們是知道的。對(duì)其他人來說，也許查看我們的照片最簡(jiǎn)單的方式是通過系統(tǒng)的Media Provider。

Note: 如果將圖片存儲(chǔ)在getExternalFilesDir()提供的目錄中，Media Scanner將無法訪問到我們的文件，因?yàn)樗鼈冸`屬于應(yīng)用的私有數(shù)據(jù)。

下面的例子演示了如何觸發(fā)系統(tǒng)的Media Scanner，將我們的照片添加到Media Provider的數(shù)據(jù)庫(kù)中，這樣就可以使得Android相冊(cè)程序與其他程序能夠讀取到這些照片。

private void galleryAddPic() {
    Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    File f = new File(mCurrentPhotoPath);
    Uri contentUri = Uri.fromFile(f);
    mediaScanIntent.setData(contentUri);
    this.sendBroadcast(mediaScanIntent);
}

解碼一幅縮放圖片

在有限的內(nèi)存下，管理許多全尺寸的圖片會(huì)很棘手。如果發(fā)現(xiàn)應(yīng)用在展示了少量圖片后消耗了所有內(nèi)存，我們可以通過縮放圖片到目標(biāo)視圖尺寸，之后再載入到內(nèi)存中的方法，來顯著降低內(nèi)存的使用，下面的例子演示了這個(gè)技術(shù)：

private void setPic() {
    // Get the dimensions of the View
    int targetW = mImageView.getWidth();
    int targetH = mImageView.getHeight();

    // Get the dimensions of the bitmap
    BitmapFactory.Options bmOptions = new BitmapFactory.Options();
    bmOptions.inJustDecodeBounds = true;
    BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    int photoW = bmOptions.outWidth;
    int photoH = bmOptions.outHeight;

    // Determine how much to scale down the image
    int scaleFactor = Math.min(photoW/targetW, photoH/targetH);

    // Decode the image file into a Bitmap sized to fill the View
    bmOptions.inJustDecodeBounds = false;
    bmOptions.inSampleSize = scaleFactor;
    bmOptions.inPurgeable = true;

    Bitmap bitmap = BitmapFactory.decodeFile(mCurrentPhotoPath, bmOptions);
    mImageView.setImageBitmap(bitmap);
}