1. 图片

本页介绍了和图片相关的JS-API方法，开发者可以根据应用的需求进行相应的配置。本页方法会不定期更新以满足更多应用个性化的开发需求。如果您有什么需求，欢迎在云之家开发者交流社区留言反馈，我们会根据您的需求进行优化。

1.1. 获取图片

功能说明：获取图片说的是调起云之家app的”获取图片”页，目前有2种方式:选择图片文件,或直接拍照。

调用代码:

qing.call('selectPic', {
    'type':'camera', 
    'success': function(result){
        alert("结果："+JSON.stringify(result));
    }
});

参数说明:

回调说明:

{
    success: true or false 是否成功(string)
    error: 错误信息(string)
    errorCode: 错误码(int)
    data: {
        fileExt:文件后缀(string)
        fileData:文件数据的base64字符串(string)
   }
}

data中字段说明:

1.2. 预览图片

调用代码:

//0.9.16及以上版本支持
qing.call('previewImage', {
    'current':'url',
    'urls':['url1','url2'],
    'success': function(result){}
});

参数说明:

回调说明:无

1.3. 保存图片到相册

qing.call('savePic', {
    'url':'xxxx'
    'success': function(result){
        // success: true or false 是否成功(String)
        // error: 错误信息(String)}
        // errorCode：错误码（String）
    }
});

1.4. 拍照或从手机相册中选图接口

qing.call('chooseImage', {
    'type':'camera', //类型，“camera”代表“相机”，“photo”代表“相册”，不传表示从相机、相册中选择；多选此参数无用，只能从相册选择
    'needCut': ‘false’ //是否需要裁剪处理，默认 false 
    'isMulti': false    //是否多选，当为true时，needCut参数无效
    'maxSelectCount': 9  //当isMulti为true时需要传的参数 最大选择图片数，int，默认9
    'showOrigin': false   //是否显示原图，默认为true
    'success': function(result){
        // localId: xxx   // string 返回选定照片的本地ID列表，localId可以作为img标签的src属性显示图片
        // localIds: [ 'xxx', 'xxx' ]   // array 多选时，只会通过这个参数返回选定照片的本地ID列表
    }
});

备注：支持在webview内预览本地图片<img src="yzjLocalResource://img?id=xxxxxxx">

1.5. 上传图片接口

qing.call('uploadImage', {
    localId: '', // 需要上传的图片的本地ID，由chooseImage接口获得
    isShowProgressTips: 1, // 默认为1，显示进度提示
    success: function(result){
        // success: true or false 是否成功(String)
        // error: 错误信息(String)}
        // data:{
        //     serverId:xxxx  //服务端文件id
        //     localId:xxx //需要上传的图片的本地ID
        // }
    }
});

备注：上传图片有效期3天，可用多媒体接口下载图片到自己的服务器，https://yunzhijia.com//openfile/download/media/{serverId} {serverId} 为服务端文件id

1.6. 下载图片接口

qing.call('downloadImage', {
    serverId:xxxx, // 需要下载的图片的服务器端ID，由uploadImage接口获得
    isShowProgressTips: 1, // 默认为1，显示进度提示
    success: function(result){
        // success: true or false 是否成功(String)
        // error: 错误信息(String)}
        // data:{
        //     localId: xxxx
        // }
    }
});

1.7. 获取本地图片接口（仅iOS）

qing.call('getLocalImgData', {
    localId: '', // 需要上传的图片的本地ID，由chooseImage接口获得
    success: function(result){
        // success: true or false 是否成功(String)
        // error: 错误信息(String)}
        // data:{
        //     localData:"" // localData是图片的base64数据，可以用img标签显示
        // }
    }
});

备注：此接口仅在 iOS WKWebview 下提供，用于兼容 iOS WKWebview 不支持 localId 直接显示图片的问题。