mtlPhotoPicker

立即使用

概述

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

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及更高版本