getPicture

通過(guò)調(diào)用系統(tǒng)默認(rèn)相機(jī)或者圖庫(kù)應(yīng)用，獲取圖片以及視頻媒體文件。

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

params

sourceType：

• 類型：字符串
• 默認(rèn)值：library
• 描述：（可選項(xiàng)）圖片源類型，從相冊(cè)、圖片庫(kù)或相機(jī)獲取圖片
• 取值范圍

library         //圖片庫(kù)
camera          //相機(jī)
album           //相冊(cè)

encodingType：

• 類型：字符串
• 默認(rèn)值：png
• 描述：（可選項(xiàng)）返回圖片類型，jpg或png
• 取值范圍

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

mediaValue：

• 類型：字符串
• 默認(rèn)值：pic
• 描述：（可選項(xiàng)）媒體類型，圖片或視頻
• 取值范圍

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

destinationType：

• 類型：字符串
• 默認(rèn)值：url
• 描述：（可選項(xiàng)）返回?cái)?shù)據(jù)類型，指定返回圖片地址或圖片經(jīng)過(guò)base64編碼后的字符串
• 取值范圍

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

direction：

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

allowEdit：

• 類型：布爾
• 默認(rèn)值：false
• 描述：（可選項(xiàng)）是否可以選擇圖片后進(jìn)行編輯，支持iOS及部分安卓手機(jī)

preview：

• 類型：布爾
• 默認(rèn)值：false
• 描述：（可選項(xiàng)）是否選擇圖片后進(jìn)行預(yù)覽，只支持iOS。

quality：

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

videoQuality：

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

targetWidth：

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

targetHeight：

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

saveToPhotoAlbum：

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

groupName：

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

callback(ret, err)

ret：

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

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

err：

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

{
    msg:""    //錯(cuò)誤描述
}

示例代碼

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

補(bǔ)充說(shuō)明

獲取圖片

可用性

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

可提供的1.0.0及更高版本