第三方应用开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
第三方应用开发
客户端API
JS-SDK
图像
选择图片
选择图片
最后更新:2025/04/16

目录

  • ww.chooseImage([params])
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • 旧版jweixin调用
  • 示例代码
  • ww.chooseImage([params])

    兼容性:企业微信 iOS、Android,微信

    功能描述

    拍照或从手机相册中选图。

    ww.chooseImage({
      count: 1,
      sizeType: ['original', 'compressed'],
      sourceType: ['album', 'camera'],
      defaultCameraMode: 'batch',
      isSaveToAlbum: true
    })

    参数说明

    params: Object

    属性类型默认值必填说明最低版本
    countnumber

    9

    选择图片数量

    sizeTypestring[]

    选择原图还是压缩后的图片

    合法值说明
    original

    原图

    compressed

    压缩后的图片

    sourceTypestring[]

    选择图片来源

    合法值说明
    album

    相册

    camera

    相机,企业微信 2.3 及以后版本支持相机连拍

    defaultCameraModestring

    进入拍照界面的默认模式,用户进入拍照界面仍然可自由切换模式

    企业微信 2.4.20

    合法值说明最低版本
    normal

    单拍

    batch

    连拍

    企业微信 2.3.0

    front

    前置摄像头单拍

    企业微信 3.0.26

    batch_front

    前置摄像头连拍

    企业微信 3.0.26

    isSaveToAlbumboolean

    true

    拍照时是否保存到系统相册

    企业微信 2.7.5

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    localIdsstring[]

    选定照片的本地 ID 列表

    使用说明

    • 在 Android 中 localId 可以作为 img 标签的 src 属性

    • 在 iOS 中需要通过 getLocalImgData 获取图片 base64 数据再用于显示

    旧版jweixin调用

    示例代码

    wx.chooseImage({
        count: 1, // 默认9
        sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有
        sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有
        defaultCameraMode: "batch", //表示进入拍照界面的默认模式,目前有normal与batch两种选择,normal表示普通单拍模式,batch表示连拍模式,不传该参数则为normal模式。从3.0.26版本开始支持front和batch_front两种值,其中front表示默认为前置摄像头单拍模式,batch_front表示默认为前置摄像头连拍模式。(注:用户进入拍照界面仍然可自由切换两种模式)
    	isSaveToAlbum: 1, //整型值,0表示拍照时不保存到系统相册,1表示自动保存,默认值是1
        success: function (res) {
            var localIds = res.localIds; // 返回选定照片的本地ID列表,
                    // andriod中localId可以作为img标签的src属性显示图片;
                    // iOS应当使用 getLocalImgData 获取图片base64数据,从而用于img标签的显示(在img标签内使用 wx.chooseImage 的 localid 显示可能会不成功)
        }
    });
    上一篇保持屏幕常亮
    下一篇预览图片
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们