photoPicker

来自于：开发者立即使用

addPhoto delectPhoto selectInfo

概述

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 对象
  • 内部字段：
  1. {
  2.     selectArr        // 数组类型 选取相册集合
  3.                      //type   （字符串类型；photo为相片，video为视频）
  4.                      //name    (字符串类型；类型是photo图片名字，类型是video为视频名字)
  5.                      //thumbPhotoPath    (符串类型；类型是photo有值，是缩图地址)
  6.                      //previewPhotoPath   (符串类型；类型是photo有值，是预览图地址)
  7.                      //imgPath (字符串类型；当类型是video时返回，视频预览图地址)
  8.                      //videoTime (字符串类型；当类型是video时返回，视频长度，单位为秒)
  9.                      //path (字符串类型；当类型是video时返回，视频地址)
  11. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.         //无返回值
  4. }

示例代码

  1. var photoPicker = api.require('photoPicker');
  2. photoPicker.addPhoto({
  3.         photoMaxNum : 5,
  4.         videoMaxNum:2,
  5.         rowCount:3,
  6.         selectTogether:true,
  7.         selectedType:2,
  8.         lookGifPhoto:true,
  9.         lookLivePhoto:true,
  10.         outerCamera:false,
  11.         time:8
  12.     },function(ret, err){
  13.         alert(JSON.stringify(ret));
  14. });

可用性

iOS8及以上系统

delectPhoto

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

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

params

name：

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

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.     selectArr        // 数组类型 选取相册集合
  4.                     //type   （字符串类型；photo为相片，video为视频）
  5.                     //name    (字符串类型；类型是photo图片名字，类型是video为视频名字)
  6.                     //thumbPhotoPath    (符串类型；类型是photo有值，是缩图地址)
  7.                     //previewPhotoPath   (符串类型；类型是photo且在预览界面打开时有值，是预览图地址)
  8.                     //imgPath (字符串类型；当类型是video时返回，视频预览图地址)
  9.                     //videoTime (字符串类型；当类型是video时返回，视频长度，单位为秒)
  10.                     //path (字符串类型；当类型是video时返回，视频地址)
  12. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2. //无返回值
  4. }

示例代码

  1. var photoPicker = api.require('photoPicker');
  2. photoPicker.delectPhoto({
  3.         name:''
  4.     },function(ret, err){
  5.         alert(JSON.stringify(ret));
  6. });

可用性

iOS8及以上系统

selectInfo

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

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

params

name：

  • 类型：字符串
  • 描述：

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.     selectArr        // 数组类型 选取相册集合
  4.                     //type   （字符串类型；photo为相片，video为视频）
  5.                     //name    (字符串类型；类型是photo图片名字，类型是video为视频名字)
  6.                     //thumbPhotoPath    (符串类型；类型是photo有值，是缩图地址)
  7.                     //previewPhotoPath   (符串类型；类型是photo且在预览界面打开时有值，是预览图地址)
  8.                     //imgPath (字符串类型；当类型是video时返回，视频预览图地址)
  9.                     //videoTime (字符串类型；当类型是video时返回，视频长度，单位为秒)
  10.                     //path (字符串类型；当类型是video时返回，视频地址)
  14. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.             //无返回值
  3. }

示例代码

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

可用性

iOS8及以上系统