photoPicker

来自于:开发者立即使用

概述

photoPicker 模块概述

本模块封装了原生选取相册中的相片、视频功能和相机功能,界面优美、流畅。可设置是否同时选取相册和视频,视频最大时间拍摄默认值为20s且最短拍摄时间为3秒。可设置只选取相片或视频。相片已经压缩,视频没有压缩,如有需要配合videoTool模块压缩。主意需要打开相册权限。选择预览图时,缩图也会一起选择。支持3DTouch预览照片和视频播放封面预览界面(iPhone 6s和iPhone6s Plus以上设备,在相册页面长按选择进入预览界面),3DTouch效果出现后再用力按才进入照片页面和视频播放页面。查看/选择LivePhoto(支持iPhone 6s和iPhone6s Plus以上设备),查看/选择GIF图片。如有问题,联系请QQ号328555416。

实例widget下载地址

模块使用攻略

模块接口

addPhoto

打开添加相册界面

addPhoto(params},callback(ret, err))

params

photoMaxNum:

  • 类型:数字类型
  • 描述:(可选项)最多可以选取多少相片。
  • 默认值:1

videoMaxNum

  • 类型:数字类型
  • 描述:(可选项)最多可以选取多少视频。
  • 默认值:1

rowCount

  • 类型:数字类型
  • 描述:(可选项)相册界面每一行显示的个数。
  • 默认值:4

selectTogether

  • 类型:布尔类型类型
  • 描述:(可选项)是否可以视频和相片同时选取。
  • 默认值:true

selectedType

  • 类型:数字类型
  • 描述:(可选项)相册显示的内容。
  • 默认值:2
  • 取值范围:
  • 0(只选择图片)
  • 1(只选择视频)
  • 2(图片和视频一起)

lookGifPhoto

  • 类型:布尔类型
  • 描述:true为GIF图片,false为静态图片。
  • 默认值:true

lookLivePhoto

  • 类型:布尔类型
  • 描述:true为LivePhoto图片,false为静态图片
  • 默认值:true

outerCamera

  • 类型:布尔类型
  • 描述:是否相机外置。
  • 默认值:false

time

  • 类型:数字类型
  • 描述:视频拍摄最大时间,单位为秒。注意最短视频拍摄时间为3秒,设置一定要时间大于3秒。
  • 默认值:20

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    selectArr        // 数组类型 选取相册集合
                     //type   (字符串类型;photo为相片,video为视频)
                     //name    (字符串类型;类型是photo图片名字,类型是video为视频名字)
                     //thumbPhotoPath    (符串类型;类型是photo有值,是缩图地址)
                     //previewPhotoPath   (符串类型;类型是photo有值,是预览图地址)
                     //imgPath (字符串类型;当类型是video时返回,视频预览图地址)
                     //videoTime (字符串类型;当类型是video时返回,视频长度,单位为秒)
                     //path (字符串类型;当类型是video时返回,视频地址)

}

err:

  • 类型:JSON 对象
  • 内部字段:
{
        //无返回值

}

示例代码

var photoPicker = api.require('photoPicker');
photoPicker.addPhoto({
        photoMaxNum : 5,
        videoMaxNum:2,
        rowCount:3,
        selectTogether:true,
        selectedType:2,
        lookGifPhoto:true,
        lookLivePhoto:true,
        outerCamera:false,
        time:8
    },function(ret, err){
        alert(JSON.stringify(ret));
});

可用性

iOS8及以上系统

delectPhoto

删除选取的相册的相册或视频

delectPhoto({params},callback(ret, err))

params

name:

  • 类型:字符串
  • 描述:从相册中选取内容的名字。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    selectArr        // 数组类型 选取相册集合
                    //type   (字符串类型;photo为相片,video为视频)
                    //name    (字符串类型;类型是photo图片名字,类型是video为视频名字)
                    //thumbPhotoPath    (符串类型;类型是photo有值,是缩图地址)
                    //previewPhotoPath   (符串类型;类型是photo且在预览界面打开时有值,是预览图地址)
                    //imgPath (字符串类型;当类型是video时返回,视频预览图地址)
                    //videoTime (字符串类型;当类型是video时返回,视频长度,单位为秒)
                    //path (字符串类型;当类型是video时返回,视频地址)

}

err:

  • 类型:JSON 对象
  • 内部字段:
{
//无返回值

}

示例代码

var photoPicker = api.require('photoPicker');
photoPicker.delectPhoto({
        name:''
    },function(ret, err){
        alert(JSON.stringify(ret));
});

可用性

iOS8及以上系统

selectInfo

获取选取相册或视频的名字和地址

selectInfo({params}, callback(ret, err))

params

name:

  • 类型:字符串
  • 描述:

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    selectArr        // 数组类型 选取相册集合
                    //type   (字符串类型;photo为相片,video为视频)
                    //name    (字符串类型;类型是photo图片名字,类型是video为视频名字)
                    //thumbPhotoPath    (符串类型;类型是photo有值,是缩图地址)
                    //previewPhotoPath   (符串类型;类型是photo且在预览界面打开时有值,是预览图地址)
                    //imgPath (字符串类型;当类型是video时返回,视频预览图地址)
                    //videoTime (字符串类型;当类型是video时返回,视频长度,单位为秒)
                    //path (字符串类型;当类型是video时返回,视频地址)



}

err:

  • 类型:JSON 对象
  • 内部字段:
{
            //无返回值
}

示例代码


var photoPicker = api.require('photoPicker');
photoPicker.selectInfo(function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS8及以上系统