tencent cloud

文档反馈

最后更新时间:2024-07-12 19:13:21

    chooseImage

    该 API 使用方法为 wx.chooseImage(Object object)
    功能说明:从本地相册选择图片或使用相机拍照。
    参数及说明:Object object。
    属性
    类型
    合法值及说明
    默认值
    必填
    说明
    count
    number
    -
    9
    多可以选择的图片张数
    sizeType
    Array.<string>
    original:原图
    compressed:压缩图
    ['original', 'compressed']
    所选的图片的尺寸
    sourceType
    Array.<string>
    album:从相册选图
    camera:使用相机
    ['album', 'camera']
    选择图片的来源
    success
    function
    -
    -
    接口调用成功的回调函数
    fail
    function
    -
    -
    接口调用失败的回调函数
    complete
    function
    -
    -
    接口调用结束的回调函数(调用成功、失败都会执行)
    object.success 回调函数参数:Object res。
    属性
    类型
    说明
    tempFilePaths
    Array.<string>
    图片的本地临时文件路径列表 (本地路径)
    tempFiles
    Array.<Object>
    图片的本地临时文件列表
    res.tempFiles 的结构
    属性
    类型
    说明
    path
    string
    本地临时文件路径
    size
    number
    本地临时文件大小,单位 B
    示例代码:
    wx.chooseImage({
    count: 1,
    sizeType: ['original', 'compressed'],
    sourceType: ['album', 'camera'],
    success (res) {
    // tempFilePath可以作为 img 标签的 src 属性显示图片
    const tempFilePaths = res.tempFilePaths
    }
    })

    compressImage

    该 API 使用方法为 wx.compressImage(Object object)
    功能说明:压缩图片接口,可选压缩质量。
    参数及说明:Object object。
    属性
    类型
    默认值
    必填
    说明
    src
    string
    -
    图片路径,图片的路径,支持本地路径、代码包路径
    quality
    number
    80
    压缩质量,范围0~100,数值越小,质量越低,压缩率越高(仅对 jpg 有效)
    compressedWidth
    number
    -
    压缩后图片的宽度,单位为px,若不填写则默认以 compressedHeight 为准等比缩放
    compressedHeight
    number
    -
    压缩后图片的高度,单位为px,若不填写则默认以compressedWidth为准等比缩放
    success
    function
    -
    接口调用成功的回调函数
    fail
    function
    -
    接口调用失败的回调函数
    complete
    function
    -
    接口调用结束的回调函数(调用成功、失败都会执行)
    object.success 回调函数参数:Object res。
    属性
    类型
    说明
    tempFilePath
    string
    压缩后图片的临时文件路径 (本地路径)
    示例代码:
    wx.compressImage({
    src: '', // 图片路径
    quality: 80 // 压缩质量
    })

    getImageInfo

    该 API 使用方法为 wx.getImageInfo(Object object)
    功能说明:获取图片信息。网络图片需先配置 download 域名才能生效。
    参数及说明:Object object。
    属性
    类型
    默认值
    必填
    说明
    src
    string
    -
    图片的路径,可以是相对路径、临时文件路径、存储文件路径、网络图片路径
    success
    function
    -
    接口调用成功的回调函数
    fail
    function
    -
    接口调用失败的回调函数
    complete
    function
    -
    接口调用结束的回调函数(调用成功、失败都会执行)
    object.success 回调函数参数:Object res。
    属性
    类型
    说明
    width
    number
    图片原始宽度,单位 px。不考虑旋转
    height
    number
    图片原始高度,单位 px。不考虑旋转
    path
    string
    图片的本地路径
    orientation
    string
    type
    string
    图片格式
    res.orientation 的合法值
    说明
    up
    默认方向(手机横持拍照),对应 Exif 中的 1,或无 orientation 信息
    up-mirrored
    同 up,但镜像翻转,对应 Exif 中的2
    down
    旋转180度,对应 Exif 中的3
    down-mirrored
    同 down,但镜像翻转,对应 Exif 中的4
    left-mirrored
    同 left,但镜像翻转,对应 Exif 中的5
    right
    顺时针旋转90度,对应 Exif 中的6
    right-mirrored
    同 right,但镜像翻转,对应 Exif 中的7
    left
    逆时针旋转90度,对应 Exif 中的8
    res.type 的合法值
    合法值
    说明
    unknown
    未知格式
    jpeg
    jpeg压缩格式
    png
    png压缩格式
    gif
    gif压缩格式
    tiff
    tiff压缩格式
    示例代码:
    wx.getImageInfo({
    src: 'images/a.jpg',
    success(res) {
    console.log(res.width)
    console.log(res.height)
    },
    })
    
    wx.chooseImage({
    success(res) {
    wx.getImageInfo({
    src: res.tempFilePaths[0],
    success(res) {
    console.log(res.width)
    console.log(res.height)
    },
    })
    },
    })

    previewImage

    该 API 使用方法为 wx.previewImage(Object object)
    功能说明:在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
    参数及说明:Object object。
    属性
    类型
    默认值
    必填
    说明
    urls
    Array.<string>
    -
    需要预览的图片链接列表。 支持云文件 ID
    current
    string
    urls 的第一张
    当前显示图片的链接
    success
    function
    -
    接口调用成功的回调函数
    fail
    function
    -
    接口调用失败的回调函数
    complete
    function
    -
    接口调用结束的回调函数(调用成功、失败都会执行)
    示例代码:
    wx.previewImage({
    current: '', // 当前显示图片的http链接
    urls: [], // 需要预览的图片http链接列表
    })

    previewMedia

    该 API 使用方法为 wx.previewMedia(Object object)
    功能说明:预览图片和视频。
    参数及说明:Object object。
    属性
    类型
    默认值
    必填
    说明
    sources
    Array.<Object>
    
    需要预览的资源列表
    current
    number
    0
    当前显示的资源序号
    success
    function
    
    接口调用成功的回调函数
    fail
    function
    
    接口调用失败的回调函数
    complete
    function
    
    接口调用结束的回调函数(调用成功、失败都会执行)

    saveImageToPhotosAlbum

    该 API 使用方法为 wx.saveImageToPhotosAlbum(Object object)
    说明:
    调用前需要“用户授权” scope.writePhotosAlbum。
    功能说明:保存图片到系统相册。
    参数及说明:Object object。
    属性
    类型
    默认值
    必填
    说明
    filePath
    string
    -
    图片文件路径,可以是临时文件路径或永久文件路径 (本地路径),不支持网络图片路径
    success
    function
    -
    接口调用成功的回调函数
    fail
    function
    -
    接口调用失败的回调函数
    complete
    function
    -
    接口调用结束的回调函数(调用成功、失败都会执行)
    示例代码:
    wx.saveImageToPhotosAlbum({
    success(res) {},
    })
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持