getPicture

通過調(diào)用系統(tǒng)默認相機或者圖庫應用，獲取圖片以及視頻媒體文件。

getPicture({params}, callback(ret, err))

params

sourceType：

• 類型：字符串
• 默認值：library
• 描述：（可選項）圖片源類型，從相冊、圖片庫或相機獲取圖片
• 取值范圍

library         //圖片庫
camera          //相機
album           //相冊

encodingType：

• 類型：字符串
• 默認值：png
• 描述：（可選項）返回圖片類型，jpg或png
• 取值范圍

jpg      //指定圖片格式為jpg
png      //指定圖片格式為png

mediaValue：

• 類型：字符串
• 默認值：pic
• 描述：（可選項）媒體類型，圖片或視頻
• 取值范圍

pic        //圖片
video      //視頻
all        //圖片和視頻，Android不支持

destinationType：

• 類型：字符串
• 默認值：url
• 描述：（可選項）返回數(shù)據(jù)類型，指定返回圖片地址或圖片經(jīng)過base64編碼后的字符串
• 取值范圍

base64      //指定返回數(shù)據(jù)為base64編碼后內(nèi)容
url         //指定返回數(shù)據(jù)為選取的圖片地址

direction：

• 類型：字符串
• 默認值：rear
• 描述：（可選項）選擇前置或后置攝像頭，取值范圍（front、rear），只支持iOS

allowEdit：

• 類型：布爾
• 默認值：false
• 描述：（可選項）是否可以選擇圖片后進行編輯，支持iOS及部分安卓手機

preview：

• 類型：布爾
• 默認值：false
• 描述：（可選項）是否選擇圖片后進行預覽，只支持iOS。

quality：

• 類型：數(shù)字
• 默認值：50
• 描述：（可選項）圖片質(zhì)量，只針對jpg格式圖片（0-100整數(shù)）

videoQuality：

• 類型：字符串
• 默認值：medium
• 描述：（可選項）視頻質(zhì)量，調(diào)用相機錄制視頻時該參數(shù)生效。取值范圍(low、medium、high)，質(zhì)量越高，錄制的視頻文件占用存儲空間越大。

targetWidth：

• 類型：數(shù)字
• 默認值：原圖寬度
• 描述：（可選項）壓縮后的圖片寬度，圖片會按比例適配此寬度

targetHeight：

• 類型：數(shù)字
• 默認值：原圖高度
• 描述：（可選項）壓縮后的圖片高度，圖片會按比例適配此高度

saveToPhotoAlbum：

• 類型：布爾
• 默認值：false
• 描述：（可選項）拍照或錄制視頻后是否保存到系統(tǒng)相冊目錄。注意此處僅是文件系統(tǒng)層面的操作，使用諸如“圖庫”App仍然有可能查看到。

groupName：

• 類型：字符串
• 默認值：無
• 描述：（可選項）保存圖片到自定義分組相冊目錄，相冊不存在則會進行創(chuàng)建。
• 可用性：可提供的1.2.74及更高版本

callback(ret, err)

ret：

• 類型：JSON 對象
• 內(nèi)部字段：

{
    data:"",                //圖片路徑
    base64Data:"",          //base64數(shù)據(jù)，destinationType為base64時返回
    duration:0              //視頻時長（數(shù)字類型）
}

err：

• 類型：JSON 對象
• 內(nèi)部字段：

{
    msg:""    //錯誤描述
}

示例代碼

api.getPicture({
    sourceType: 'camera',
    encodingType: 'jpg',
    mediaValue: 'pic',
    destinationType: 'url',
    allowEdit: true,
    quality: 50,
    targetWidth: 100,
    targetHeight: 100,
    saveToPhotoAlbum: false
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg:JSON.stringify(ret)
        });
    } else {
        api.alert({
            msg:JSON.stringify(err)
        });
    }
});

補充說明

獲取圖片

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本