文档开发者中心
我的

<如何开发快应用 10>API 图形

1 多媒体
1.1 接口声明
{"name": "system.media"}

1.2 导入模块
import media from ´@system.media´ 或 var media = require("@system.media")

1.3 media.takePhoto(OBJECT)
       拍摄照片。
参数
参数类型必填说明
cancelFunction否取消回调。
successFunction否成功回调,返回值如表1-1所示。
failFunction否失败回调,错误码如表1-2所示。
completeFunction否执行结束后的回调。

       表1-1 success返回值
参数名类型说明
uriString选取的文件路径。

       表1-2 fail返回错误码
错误码说明
201用户拒绝,获取相机权限失败。

示例
media.takePhoto({
  success:function(data){console.log("handling success: " + data.uri);}
})


1.4 media.takeVideo(OBJECT)
       拍摄视频。
参数
参数类型必填说明
cancelFunction否取消回调。
successFunction否成功回调,参数为 {uri: ´file:///video.avi´},返回值如表1-3所示。
failFunction否失败回调,错误码如表1-4所示。
completeFunction否执行结束后的回调。

       表1-3 success返回值
参数名类型说明
uriString选取的文件路径。

       表1-4 fail返回错误码
错误码说明
201用户拒绝,获取相机权限失败。

示例
media.takeVideo({
  success:function(data){console.log("handling success: " + data.uri);},
  fail: function(data, code) {
    console.log("handling fail, code=" + code);
  }
})


1.5 media.pickImage(OBJECT)
       选择图片。
参数
参数类型必填说明
cancelFunction否取消回调。
successFunction否成功回调,返回值如表1-5所示。
failFunction否失败回调。
completeFunction否执行结束后的回调。

       表1-5 success返回值
参数名类型说明
uriString选取的文件路径。

示例
media.pickImage({
    success:function(data){console.log("handling success: " + data.uri);}
})


1.6 media.pickVideo(OBJECT)
       选择视频。
参数
参数类型必填说明
cancelFunction否取消回调。
successFunction否成功回调,返回值如表1-6所示。
failFunction否失败回调。
completeFunction否执行结束后的回调。

       表1-6 success返回值
参数名类型说明
uriString选取的文件路径。

示例
media.pickVideo({
  success:function(data){console.log("handling success: " + data.uri);},
  fail: function(data, code) {
    console.log("handling fail, code=" + code);
  }
})


2 图片处理
2.1 接口声明
{"name": "system.image"}

2.2 导入模块
import image from ´@system.image´ 或 var media = require("@system.image")

2.3 image.compressImage(OBJECT)
       压缩指定路径的图片。
参数
参数类型默认值必填说明
uriString是源文件的uri,如果是应用内资源路径, 不允许是相对路径。
qualityNumber否图片的压缩质量,0-100之间。
ratioNumber否尺寸压缩倍数,大于0,值越大,图片尺寸越小,假如quality和ratio同时填写的场景下会先进尺寸压缩,后进行质量压缩。
formatStringJPEG否压缩格式,支持三种格式:JPEG,PNG,WEBP。
successFunction否成功回调,返回值如表2-1所示。
failFunction否失败回调,返回值如表2-2所示。
completeFunction否执行结束后的回调。

       表2-1 success返回值
参数名类型必填说明
uriString是压缩成功后的文件路径uri,会保存在应用的cache目录中。

       表2-2 fail返回错误码
错误码说明
202参数错误。
300I/O错误。
301文件路径不存在。

示例
image.compressImage({
    uri: “tmp://abc.jpg”,
        quality:80,
        radio: 2,
        format: ”JPEG”,
success: function(data) {
        console.log(data.uri)
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})


2.4 image.getImageInfo(OBJECT)
       获取图片的信息。
参数
参数类型默认值必填说明
uriString是源文件的uri,如果是应用内资源路径,不允许是相对路径。
successFunction否成功回调,返回值如表2-3所示。
failFunction否失败回调,返回值如表2-4所示。
completeFunction否执行结束后的回调。

       表2-3 success返回值
参数名类型必填说明
uriString是压缩成功后的文件路径uri,会保存在应用的cache目录中。
widthNumber是图片的宽度,单位为px。
heightNumber是图片的高度,单位为px。
sizeNumber是图片的大小,单位为Byte。

       表2-4 fail返回错误码
错误码说明
202参数错误。
300I/O错误。
301文件路径不存在。

示例
image.getImageInfo({
    uri: “tmp://abc.jpg”,
success: function(data) {
        console.log(data.uri + data.width + data.height + data.size)
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})


2.5 image.editImage(OBJECT)
       编辑图片,系统提供基础基于矩形框的裁剪图片UI组件,返回裁剪后保存的图片路径。
参数
参数类型默认值必填说明
uriString是源文件的uri,仅支持本地图片路径,如果是应用内资源路径,不允许是相对路径。
successFunction否成功回调,返回值如表2-5所示。
failFunction否失败回调,返回值如表2-6所示。
cancelFunction否用户取消图片编辑。
completeFunction否执行结束后的回调。

       表2-5 success返回值
参数名类型必填说明
uriString是裁剪后图片的文件路径uri。

       表2-6 fail返回错误码
错误码说明
202参数错误。
300I/O错误。
301文件路径不存在。

示例
image.editImage({
    uri: “tmp://abc.jpg”,
success: function(data.uri) {
        console.log(data.uri)
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})


2.6 image.applyOperations(OBJECT)
       对图片按顺序执行编辑操作。
       在顺序执行编辑操作列表中的操作时,上一步操作生成的结果会作为下一步操作的输入,坐标系也是以上一步操作生成的结果的左上角为坐标原点重新确定的。
参数
参数类型必填说明
uriString是源文件的uri,仅支持本地图片路径,假如是应用内资源路径,不允许是相对路径。
operationsObjectArray否编辑操作列表,按照出现的先后顺序执行。如果不提供,则不对图片进行编辑操作,但是保存参数依然有效。
qualityInteger否图片的压缩质量,0-100之间,默认是75。
formatString否图片保存格式,支持JPEG,PNG,WEBP三种格式。默认使用JPEG格式。
successFunction否成功回调,返回裁切后的图片地址,返回值如表2-7所示。
failFunction否失败回调,返回值如表2-8所示。
completeFunction否执行结束后的回调。

       表2-7 success返回值
参数名类型必填说明
uriString是裁剪后图片的文件路径uri,会保存到应用的cache分区中。

       表2-8 fail返回错误码
错误码说明
202参数错误。
300I/O错误。
301文件路径不存在。

       支持的编辑操作如下:
       ● 图片裁剪
参数类型必填说明
actionString是必须是crop。
xNumber否裁剪的起始点的x坐标,默认是0。
yNumber否裁剪的起始点的y坐标,默认是0。
widthNumber是裁剪的图片宽度。
heightNumber是裁剪的图片高度。

       ● 图片缩放
参数类型必填说明
actionString是必须是scale。
scaleXNumber否宽度的缩放比率,缩放后宽度会变成原图的scaleX倍。默认是1。
scaleYNumber否高度的缩放比率,缩放后高度会变成原图的scaleY倍。默认是1。

       ● 图片旋转
参数类型必填说明
actionString是必须是rotate。
degreeNumber是旋转的角度。

示例
image.applyOperations({
  uri: ´internal://cache/123.png´,
  operations: [
    {
      action: ´scale´,
      scaleX: 0.5,
      scaleY: 0.5
    },
    {
      action: ´crop´,
      width: 200,
      height: 200
    },
    {
      action: ´rotate´,
      degree: 90,
    }
  ],
  quality: 90,
  format: ´webp´,
  success: function(data) {
    console.log("handling success: " + data.uri);
  },
  fail: function(data, code) {
    console.log("handling fail, code=" + code);
  }
})


点赞
收藏
回复
分享
举报
浏览1147 发布于2018-06-05 02:31未知归属地
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。