多媒体

接口声明

{"name": "system.media"}

uni.media.takePhoto(OBJECT)

拍摄照片。

参数

参数名 类型 必填 说明
cancel Function 否 取消回调
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success 返回值

参数名 类型 说明
uri String 选取的文件路径

fail 返回错误码

错误码 说明
201 用户拒绝，获取相机权限失败。

示例

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

uni.media.takeVideo(OBJECT)

拍摄视频。

参数

参数名 类型 必填 说明
cancel Function 否 取消回调
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success 返回值

参数名 类型 说明
uri String 选取的文件路径

fail 返回错误码

错误码 说明
201 用户拒绝，获取相机权限失败。

示例

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

uni.media.pickImage(OBJECT)

选择图片。

参数

参数名 类型 必填 说明
cancel Function 否 取消回调
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success返回值

参数名 类型 说明
uri String 选取的文件路径

示例

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

uni.media.pickVideo(OBJECT)

选择视频。

参数

参数名 类型 必填 说明
cancel Function 否 取消回调
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success返回值

参数名 类型 说明
uri String 选取的文件路径

示例

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

uni.media.compressImage(OBJECT)

压缩指定路径的图片。

参数

参数名 类型 默认值 必填 说明
srcUri String 是 源文件的uri
quality Number 否 图片的压缩质量，0-100之间
radio Number 否 尺寸压缩倍数，值越大，图片尺寸越小
format String JPEG 否 压缩格式，支持三种格式：JPEG，PNG，WEBP
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success 返回值

参数名 类型 说明
dstUri String 压缩成功后的文件路径uri

fail 返回码

错误码 说明
202 参数错误
300 I/O错误
301 文件路径不存在

示例

uni.media.compressImage({
  srcUri: "tmp://abc.jpg",
  quality: 80,
  radio: 2,
  format: "JPEG",
  success: function(data) {
    console.log(data.dstUri);
  },
  fail: function(data, code) {
    console.log("handling fail, code=" + code);
  }
});

uni.media.getImageInfo(OBJECT)

获取图片的信息。

参数

参数名 类型 必填 说明
uri String 是 源文件的uri
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success 返回值

参数名 类型 说明
uri String 图片的文件路径uri
width Number 图片的宽度，单位为px
height Number 图片的高度，单位为px
size Number 图片的大小，单位为Byte

fail 返回码

错误码 说明
202 参数错误
300 I/O错误
301 文件路径不存在

示例

uni.media.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);
  }
});

uni.media.editImage(OBJECT)

编辑图片，系统提供基础基于矩形框的裁剪图片UI组件，返回裁剪后保存的图片路径。

参数

参数名 类型 必填 说明
srcUri String 是 源文件的uri，仅支持本地图片路径
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调

success 返回值

参数名 类型 说明
dstUri String 裁剪后图片的文件路径uri

fail 返回码

错误码 说明
202 参数错误
300 I/O错误
301 文件路径不存在

示例

uni.media.cropImage({
  srcUri: "tmp://abc.jpg",
  success: function(data) {
    console.log(data.dstUri);
  },
  fail: function(data, code) {
    console.log("handling fail, code=" + code);
  }
});

uni.media.cropImage (OBJECT)

根据输入的参数，在本地裁切图片。

参数

参数名 类型 必填 说明
success Function 否 成功回调
fail Function 否 失败回调
uri String 是 图片本地地址。
cropData Object 是 裁切参数：{ x: 0, y: 0, width: 240, height: 180, rotate: 0, scale: { x: 1, y: 1 }}

success 返回值

参数名 类型 说明
uri String 裁切后的图片地址。

fail 返回码

错误码 说明
202 参数错误
300 I/O错误
301 文件路径不存在

示例

uni.media.cropImage({
  success: function(ret) {
    console.log(ret);
  },
  uri: "[image location]",
  cropData: {
    x: 0,
    y: 0,
    width: 240,
    height: 180,
    rotate: 0,
    scale: {
      x: 1,
      y: 1
    }
  }
});

results matching ""

    No results matching ""