imageCache

圖片緩存

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

params

url：

• 類型：字符串
• 默認值：無
• 描述：圖片遠程地址

encode：

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

policy：

• 類型：字符串
• 默認值：default
• 描述：（可選項）緩存策略
• 取值范圍：

default                        //默認為 cache_else_network
cache_else_network             //若服務器上沒有更新，則使用緩存
no_cache                       //不使用緩存，始終從服務器獲取
cache_only                     //當緩存存在時，只從緩存中讀取

thumbnail：

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

tag：

• 類型：字符串
• 默認值：無
• 描述：（可選項）標識信息，將在回調中返回

callback(ret, err)

ret：

• 類型：JSON 對象
• 內部字段：

{
    status:true,          //是否成功，布爾類型
    url:''                //圖片本地存儲路徑，若下載失敗，則返回傳入的url，字符串類型
    tag:''                //標識信息，字符串類型
}

示例代碼

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及更高版本