imageCache

圖片緩存

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

params

url：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：圖片遠(yuǎn)程地址

encode：

• 類(lèi)型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）是否對(duì)url進(jìn)行編碼。默認(rèn)或傳true時(shí)，Android將始終對(duì)url編碼，而iOS只有在url不合法（如存在中文字符）的時(shí)候才進(jìn)行編碼。如果url中有特殊字符需要編碼的，建議先在js層進(jìn)行編碼，然后此參數(shù)傳false。

policy：

• 類(lèi)型：字符串
• 默認(rèn)值：default
• 描述：（可選項(xiàng)）緩存策略
• 取值范圍：

default                        //默認(rèn)為 cache_else_network
cache_else_network             //若服務(wù)器上沒(méi)有更新，則使用緩存
no_cache                       //不使用緩存，始終從服務(wù)器獲取
cache_only                     //當(dāng)緩存存在時(shí)，只從緩存中讀取

thumbnail：

• 類(lèi)型：布爾類(lèi)型
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）使用縮略圖，底層將根據(jù)當(dāng)前系統(tǒng)及設(shè)備性能，返回最優(yōu)的縮略圖，有利于提高應(yīng)用運(yùn)行及渲染效率

tag：

• 類(lèi)型：字符串
• 默認(rèn)值：無(wú)
• 描述：（可選項(xiàng)）標(biāo)識(shí)信息，將在回調(diào)中返回

callback(ret, err)

ret：

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

{
    status:true,          //是否成功，布爾類(lèi)型
    url:''                //圖片本地存儲(chǔ)路徑，若下載失敗，則返回傳入的url，字符串類(lèi)型
    tag:''                //標(biāo)識(shí)信息，字符串類(lèi)型
}

示例代碼

api.imageCache({
    url: 'http://a.hiphotos.baidu.com/image/w%3D400/sign=2abe1c77d4ca7bcb7d7bc62f8e086b3f/64380cd7912397ddf9f4bdb05a82b2b7d1a287f0.jpg'
}, function(ret, err) {
    var url = ret.url;
});

可用性

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

可提供的1.1.0及更高版本