Android應用開發入門（六十八）通過系統Gallery獲取圖片

前言

　　在Android應用中，經常有場景會需要使用到設備上存儲的圖片，而直接從路徑中獲取無疑是非常不便利的。所以一般推薦調用系統的Gallery應用，選擇圖片，然後使用它。本文將講解如何在Android中通過系統Gallery獲取圖片。

Gallery應用

　　Android原生內置了很多App，而Gallery為圖庫，用於操作設備上的圖片，它會在開機的時候主動掃描設備上存儲的圖片，並可以使用Gallery操作它們。既然要使用Gallery，那麼先看看它的AndroidManifest.xml清單文件。

<activity android:name="com.android.camera.ImageGallery" 
                android:label="@string/gallery_label" 
                android:configChanges="orientation|keyboardHidden" 
                android:icon="@drawable/ic_launcher_gallery"> 
            <intent-filter> 
                <action android:name="android.intent.action.MAIN" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.VIEW" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
                <data android:mimeType="vnd.android.cursor.dir/image" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.VIEW" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
                <data android:mimeType="vnd.android.cursor.dir/video" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.GET_CONTENT" /> 
                <category android:name="android.intent.category.OPENABLE" /> 
                <data android:mimeType="vnd.android.cursor.dir/image" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.GET_CONTENT" /> 
                <category android:name="android.intent.category.OPENABLE" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
                <data android:mimeType="image/*" /> 
                <data android:mimeType="video/*" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.PICK" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
                <data android:mimeType="image/*" /> 
                <data android:mimeType="video/*" /> 
            </intent-filter> 
            <intent-filter> 
                <action android:name="android.intent.action.PICK" /> 
                <category android:name="android.intent.category.DEFAULT" /> 
                <data android:mimeType="vnd.android.cursor.dir/image" /> 
            </intent-filter> 
        </activity> 

　　上面是Gallery的AndroidManifest.xml文件中的部分代碼，展示了ImageGallery，從眾多Intent-filter中可以看出，選取圖片應該使用"android.intent.action.PICK"，它有兩個miniType，"image/*"是用來獲取圖片的、"video/*"是用來獲取視頻的。Android中眾多Action的字符串其實被封裝在Intent類中，android.intent.action.PICK也不例外，它是Intent.ACTION_PICK。

　　既然知道了啟動Gallery的Action，那麼再看看ImageGallery.java的源碼，找找其中選中圖片後的返回值。

private void launchCropperOrFinish(IImage img) {  
        Bundle myExtras = getIntent().getExtras();  
 
        long size = MenuHelper.getImageFileSize(img);  
        if (size < 0) {  
            // Return if the image file is not available.  
            return;  
        }  
 
        if (size > mVideoSizeLimit) {  
            DialogInterface.OnClickListener buttonListener =  
                    new DialogInterface.OnClickListener() {  
                public void onClick(DialogInterface dialog, int which) {  
                    dialog.dismiss();  
                }  
            };  
            new AlertDialog.Builder(this)  
                    .setIcon(android.R.drawable.ic_dialog_info)  
                    .setTitle(R.string.file_info_title)  
                    .setMessage(R.string.video_exceed_mms_limit)  
                    .setNeutralButton(R.string.details_ok, buttonListener)  
                    .show();  
            return;  
        }  
 
        String cropValue = myExtras != null ? myExtras.getString("crop") : null;  
        if (cropValue != null) {  
            Bundle newExtras = new Bundle();  
            if (cropValue.equals("circle")) {  
                newExtras.putString("circleCrop", "true");  
            }  
 
            Intent cropIntent = new Intent();  
            cropIntent.setData(img.fullSizeImageUri());  
            cropIntent.setClass(this, CropImage.class);  
            cropIntent.putExtras(newExtras);  
 
            /* pass through any extras that were passed in */ 
            cropIntent.putExtras(myExtras);  
            startActivityForResult(cropIntent, CROP_MSG);  
        } else {  
            Intent result = new Intent(null, img.fullSizeImageUri());  
            if (myExtras != null && myExtras.getBoolean("return-data")) {  
                // The size of a transaction should be below 100K.  
                Bitmap bitmap = img.fullSizeBitmap(  
                        IImage.UNCONSTRAINED, 100 * 1024);  
                if (bitmap != null) {  
                    result.putExtra("data", bitmap);  
                }  
            }  
            setResult(RESULT_OK, result);  
            finish();  
        }  
    } 

　　以上的ImageGallery.java的部分源碼，從setResult()方法可以看出，它返回的Intent包含了選中圖片的Uri，它是一個content://開頭的內容提供者，並且如果傳遞過去的Intent的Extra中，包含一個name為"return-data"並且值為true的時候，還會往Extra中寫入name為"data"的圖片縮略圖。

Gallery獲取圖片Demo

　　既然已經知道了啟動Gallery的Action，和它如何返回選中的數據，那麼接下來通過一個簡單的Demo來演示一下如何從系統Gallery中獲取圖片，並把獲取到的圖片展示到界面的一個ImageView中。

package cn.bgxt.sysgallerydemo;  
 
import android.net.Uri;  
import android.os.Bundle;  
import android.util.Log;  
import android.view.View;  
import android.view.View.OnClickListener;  
import android.widget.Button;  
import android.widget.ImageView;  
import android.app.Activity;  
import android.content.Intent;  
 
public class MainActivity extends Activity {  
    private Button btn_getImage;  
    private ImageView iv_image;  
    private final static String TAG = "main";  
 
    @Override 
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
 
        btn_getImage = (Button) findViewById(R.id.btn_getImage);  
        iv_image = (ImageView) findViewById(R.id.iv_image);  
 
        btn_getImage.setOnClickListener(getImage);  
    }  
 
    private View.OnClickListener getImage = new OnClickListener() {  
 
        @Override 
        public void onClick(View v) {  
            // 設定action和miniType  
            Intent intent = new Intent();  
            intent.setAction(Intent.ACTION_PICK);  
            intent.setType("image/*");  
            // 以需要返回值的模式開啟一個Activity  
            startActivityForResult(intent, 0);  
        }  
    };  
 
    @Override 
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {  
        // 如果獲取成功，resultCode為-1  
        Log.i(TAG, "resultCode:" + resultCode);  
        if (requestCode == 0 && resultCode == -1) {  
            // 獲取原圖的Uri，它是一個內容提供者  
            Uri uri = data.getData();  
            iv_image.setImageURI(uri);  
        }  
        super.onActivityResult(requestCode, resultCode, data);  
    }  
} 

　效果展示：

　　源碼下載

總結

　　本文到這裡就基本上講解了如何在Android下調用系統Gallery獲取圖片，其實功能實現很簡單，主要是要注意Action和miniType不要寫錯了，並且返回值是一個Uri。雖然現在越來越多需要用到圖片的商業應用，都在自己開發獲取設備圖片的功能，但是使用系統自帶的Gallery來獲取不失為一種快速實現功能的解決辦法。為了方便起見，系統的Gallery源碼，也會一並打包放到源碼中，有需要的可以下載來看看。