imageCache

图片缓存

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

params

url：

• 类型：字符串
• 默认值：无
• 描述：图片远程地址

encode：

• 类型：布尔
• 默认值：true
• 描述：（可选项）是否对url进行编码。默认或传true时，Android将始终对url编码，而iOS只有在url不合法（如存在中文字符）的时候才进行编码。如果url中有特殊字符需要编码的，建议先在js层进行编码，然后此参数传false。

policy：

• 类型：字符串
• 默认值：default
• 描述：（可选项）缓存策略
• 取值范围：

default                        //默认为 cache_else_network
cache_else_network             //若服务器上没有更新，则使用缓存
no_cache                       //不使用缓存，始终从服务器获取
cache_only                     //当缓存存在时，只从缓存中读取

thumbnail：

• 类型：布尔类型
• 默认值：true
• 描述：（可选项）使用缩略图，底层将根据当前系统及设备性能，返回最优的缩略图，有利于提高应用运行及渲染效率

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系统，Android系统

可提供的1.1.0及更高版本