imageCache

图片缓存

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

params

url：

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

encode：

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

policy：

  • 类型：字符串
  • 默认值：default
  • 描述：（可选项）缓存策略
  • 取值范围：
  1. default                        //默认为 cache_else_network
  2. cache_else_network             //若服务器上没有更新，则使用缓存
  3. no_cache                       //不使用缓存，始终从服务器获取
  4. cache_only                     //当缓存存在时，只从缓存中读取

thumbnail：

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

tag：

  • 类型：字符串
  • 默认值：无
  • 描述：（可选项）标识信息，将在回调中返回

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status:true,          //是否成功，布尔类型
  3.     url:''                //图片本地存储路径，若下载失败，则返回传入的url，字符串类型
  4.     tag:''                //标识信息，字符串类型
  5. }

示例代码

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

可用性

iOS系统，Android系统

可提供的1.1.0及更高版本