概述

拍照或从手机相册中选择图片

chooseImage

添加水印，此接口仅添加一个水印

chooseImage(params, callback(ret))

params

count:

• 类型：数字类型
• 描述：(可选项）最多可以选择的图片张数
• 默认：9

sourceType：

• 类型：数组
• 描述：(可选项）选择图片的来源，album：从相册选择图片，camera：使用相机
• 默认：['album', 'camera']

watermark:

• 类型：json对象
• 描述：(可选项)照片添加水印，只有拍照功能下生效
• 内部字段：

{
    text: '',     //字符串类型；水印的文字内容
    color: '#fff',//（可选项）字符串类型；水印的文字颜色；默认：'#FFFFFF'
    position:0,  //（可选项）数字类型；水印的位置，0-正下方;1-正上方;2-正左方;3-正右方;4-左上方;5-左下方;6-右上方;7-右下方;默认：0
        font:0,  //（可选项）数字类型；水印的文字大小,0-正常;1-大;2-小;默认：0
        alpha:0,  //（可选项）数字类型；水印的文字的透明度，0-1之间的;默认：0.5
：
}

returnThumbnail:

• 类型：布尔类型
• 描述：(可选项)是否需要返回缩略图
• 默认：false

callback(ret)

ret:

• 类型：JSON对象
• 描述：选择内容
• 内部字段：

{
    localIds:[{ //选择内容列表
      fileName:'',    //字符串类型；文件名称
        filePath:'',    //字符串类型；文件路径
        thumbPath:'',    //字符串类型；缩略图路径，returnThumbnail为true返回
      fileSize:666,    //数字类型；文件大小

    }]
}

示例代码

var mtlPhotoPicker = api.require('mtlPhotoPicker');
mtlPhotoPicker.chooseImage({
    count:9,
    watermark:{
        text:'我是水印',
        position:0,
        font:1,
        color:'#FF00FF',
        alpha:1
    }
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统、android系统

可提供的1.0.0及更高版本

chooseVideo

选取视频

chooseVideo(params, callback(ret))

params

maxDuration:

• 类型：数字类型
• 描述：(可选项）最长视频时间。最长60秒，默认15秒
• 默认：15

sourceType：

• 类型：数组
• 描述：(可选项）选择图片的来源，album：从相册选择图片，camera：使用相机
• 默认：['album', 'camera']

callback(ret)

ret:

• 类型：JSON对象
• 描述：正确返回
• 内部字段：

{
  filePath:'',    //字符串类型；视频临时文件路径
  duration:3,    //数字类型；视频时间长度,单位(秒)
  size:666,    //数字类型；视频数据大小,单位(字节)
  height:800,    //数字类型；视频高度
  width:800    //数字类型；视频宽度
}

示例代码

var mtlPhotoPicker = api.require('mtlPhotoPicker');
mtlPhotoPicker.chooseVideo({
   maxDuration:30
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统、android系统

可提供的1.0.0及更高版本

previewImage

图片预览

previewImage(params, callback(ret))

params

current:

• 类型：字符串类型
• 描述：(可选项）当前显示图片的 url

urls:

• 类型：数组
• 描述：需要预览的图片 url 列表

callback(ret,err)

ret:

• 类型：JSON对象
• 描述：正确返回
• 内部字段：

{
  status:,    //布尔类型；是否打开成功
}

err:

• 类型：JSON对象
• 描述：错误返回
• 内部字段：

{
  msg:''                //字符串类型；错误信息
}

示例代码

var mtlPhotoPicker = api.require('mtlPhotoPicker');
mtlPhotoPicker.previewImage({
  current: "https://wx2.sinaimg.cn/mw690/70396e5agy1g0leayhrhoj211418gq9q.jpg",
  urls: [
    "https://wx3.sinaimg.cn/mw690/70396e5agy1g0leax4owvj211418gk2j.jpg",
    "https://wx4.sinaimg.cn/mw690/70396e5agy1g0leay2ymtj211418gk11.jpg",
    "https://wx2.sinaimg.cn/mw690/70396e5agy1g0leayhrhoj211418gq9q.jpg",
    "https://wx3.sinaimg.cn/mw690/70396e5agy1g0leazeikxj211418gqdc.jpg"
  ],
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统、android系统

可提供的1.0.0及更高版本