开发 API 多媒体 图片 ks.chooseImage
# ks.chooseImage
更新时间:2025-06-04 15:06:47
从本地相册选择图片,或使用相机拍摄图片。
# chooseImage(options: ChooseImageOptions): Promise<ChooseImageResult>
# 参数
| 参数 | 类型 | 必填 | 
|---|---|---|
| options | ChooseImageOptions | 是 | 
# ChooseImageOptions
属性
| 属性 | 类型 | 默认值 | 必填 | 说明 | 
|---|---|---|---|---|
| count | number | 9 | 否 | 最多可以选择的图片张数 | 
| sizeType | ('compressed' | 'original')[] | ['original', 'compressed'] | 否 | 所选图片的尺寸 | 
| sourceType | ('camera' | 'album')[] | 是 | 选择图片的来源 | |
| success | (result: ChooseImageResult) => void | 否 | 接口调用成功的回调函数 | |
| fail | (error: APIError) => void | 否 | 接口调用失败的回调函数 | |
| complete | (resultOrError: ChooseImageResult | APIError) => void | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 
sizeType
所选图片的尺寸
| 值 | 说明 | 
|---|---|
| 'compressed' | 压缩图 | 
| 'original' | 原图 | 
# 返回值
# Promise<ChooseImageResult>
ChooseImageResult
属性
| 属性 | 类型 | 说明 | 
|---|---|---|
| tempFilePaths | string[] | 所选图片的本地临时路径列表 | 
| tempFiles | ImageTempFileInfo[] | 所选图片的信息列表 | 
ImageTempFileInfo
属性
| 属性 | 类型 | 说明 | 
|---|---|---|
| path | string | 所选图片的本地临时路径 | 
| size | number | 所选图片的大小 (Byte) | 
# 示例代码
        上一篇:《CameraContext.setZoom》
    
 下一篇:《ks.compressImage》
仍有疑问? 前往社区提问