mtlPhotoPicker

chooseImage

chooseVideo

previewImage

概述

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

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){
    api.alert({
            msg: 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){
    api.alert({
            msg: 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){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统、android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18