nativeObj
nativeObj管理系统原生对象。
对象:
- Bitmap: 原生图片对象
- BitmapSaveOptions: JSON对象,保存图片的参数
回调方法:
- BitmapSaveSuccessCallback: 图片保存操作成功回调接口
- NativeObjSuccessCallback: 操作成功回调函数接口
- NativeObjErrorCallback: 操作错误回调函数接口
权限:
permissions
"NativeObj": {
"description": "系统原生对象"
}
Bitmap
原生图片对象
说明:
原生图片对象会占用较大的内存资源,在使用时需谨慎管理,当图片不再使用时应该及时调用clear方法进行销毁。
构造:
- Bitmap(id): 创建Bitmap对象
属性:
- id: Bitmap对象的标识
方法:
- getItems: 静态方法,获取所有Bitmap图片对象
- getBitmapById: 静态方法,获取指定标识的Bitmap图片对象
- clear: 销毁Bitmap图片
- load: 加载Bitmap图片
- loadBase64Data: 加载Base64编码格式图片到Bitmap对象
- save: 保存图片
- toBase64Data: 获取图片的Base64编码数据
BitmapSaveOptions
JSON对象,保存图片的参数
属性:
- overwrite: (Boolean
类型
)覆盖保存图片文件
仅在保存的图片路径文件存在时有效: true表示覆盖存在的文件; false表示不覆盖,如果文件存在,则返回失败。 默认值为false。
- format: (String
类型
)保存图片的格式
支持"jpg"、"png",如果未指定则默认使用指定的保存路径后缀对应的文件格式,如果后缀文件格式无效则使用jpg格式。
- quality: (Number
类型
)保存图片的质量
取值范围为1-100,1表示使用最低的图片质量(保存后的图片文件最小)、100表示使用最高的图片质量(保存后的图片文件最大); 默认值为50。
BitmapSaveSuccessCallback
图片保存操作成功回调接口
void onSuccess( Event event ){
// Code here
var target = event.target; // 保存后的图片url路径,以"file://"开头
var size = event.size; // 保存后图片的大小,单位为字节(Byte)
var width = event.width; // 保存后图片的实际宽度,单位为px
var height = event.height; // 保存后图片的实际高度,单位为px
}
参数:
- event:
(
Event
)
可选 保存后的图片信息
可通过event.target(String类型)获取保存后的图片url路径,以"file://"开头,可直接在html页面中通过src属性引用,如Android平台"file:///storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/a.jpg",iOS平台"file:///var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png"; 可通过event.size(Number类型)获取保存后图片的大小,单位为字节(Byte); 可通过event.width(Number类型)获取保存后的图片的实际宽度,单位为px; 可通过event.height(Number类型)获取保存后的图片的实际高度,单位为px。
返回值:
void : 无NativeObjSuccessCallback
操作成功回调函数接口
void onSuccess(){
// Code here
}
参数:
无
返回值:
void : 无NativeObjErrorCallback
操作错误回调函数接口
function void onError( Exception error ) {
// Error.
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
参数:
- error:
(
Exception
)
必选 用户选择操作失败信息
可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。