chooseImage
接口说明
chooseImage:options: 用于打开图片选择器,从系统相册或相机中选择图片。
调用方可以通过 SUDOPChooseImageOptions 配置可选择的图片数量、图片尺寸类型以及图片来源。SDK 会根据传入配置调起相册或相机,并在选择完成后通过回调返回结果。
常量声明
objectivec
static NSString * const kSUDOPImageSourceTypeAlbum = @"album";
static NSString * const kSUDOPImageSourceTypeCamera = @"camera";
static NSString * const kSUDOPImageSizeTypeOriginal = @"original";
static NSString * const kSUDOPImageSizeTypeCompressed = @"compressed";类型声明
objectivec
/**
Options for configuring image selection behavior.
*/
@interface SUDOPChooseImageOptions : NSObject
/**
The maximum number of images that can be selected.
@default 9
*/
@property(nonatomic, assign) NSInteger count;
/**
The size types of images to be selected.
Possible values: 'original' (original size), 'compressed' (compressed size)
*/
@property(nonatomic, strong) NSArray<NSString *> *sizeType;
/**
The sources for selecting images.
Possible values: 'album' (photo library), 'camera' (camera)
*/
@property(nonatomic, strong) NSArray<NSString *> *sourceType;
@end方法声明
objectivec
/**
Opens the image picker for selecting images from album or camera.
@param stateHandle The state handle object that manages the operation state and callbacks.
@param options The options configuration for image selection (count, sizeType, sourceType, etc.).
*/
- (void)chooseImage:(id<SUDOPStateHandle>)stateHandle
options:(SUDOPChooseImageOptions *)options;参数说明
SUDOPChooseImageOptions
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
count | NSInteger | 否 | 9 | 最多可以选择的图片数量。 |
sizeType | NSArray<NSString *> * | 否 | - | 图片尺寸类型。可选值:original 原图、compressed 压缩图。 |
sourceType | NSArray<NSString *> * | 否 | - | 图片来源。可选值:album 相册、camera 相机。 |
sizeType 可选值
| 常量 | 值 | 说明 |
|---|---|---|
kSUDOPImageSizeTypeOriginal | original | 原图。 |
kSUDOPImageSizeTypeCompressed | compressed | 压缩图。 |
sourceType 可选值
| 常量 | 值 | 说明 |
|---|---|---|
kSUDOPImageSourceTypeAlbum | album | 从系统相册选择图片。 |
kSUDOPImageSourceTypeCamera | camera | 使用相机拍摄图片。 |
方法参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
stateHandle | id<SUDOPStateHandle> | 是 | 状态句柄对象,用于管理当前操作状态及回调。 |
options | SUDOPChooseImageOptions * | 是 | 图片选择配置对象,包含选择数量、图片尺寸类型、图片来源等配置。 |
使用示例
objectivec
id<SUDOPStateHandle> stateHandle = self.stateHandle;
SUDOPChooseImageOptions *options = [[SUDOPChooseImageOptions alloc] init];
options.count = 9;
options.sizeType = @[kSUDOPImageSizeTypeOriginal, kSUDOPImageSizeTypeCompressed];
options.sourceType = @[kSUDOPImageSourceTypeAlbum, kSUDOPImageSourceTypeCamera];
[self chooseImage:stateHandle options:options];处理流程
- 业务侧创建
SUDOPChooseImageOptions对象。 - 根据业务需求设置最大选择数量
count。 - 根据业务需求设置图片尺寸类型
sizeType。 - 根据业务需求设置图片来源
sourceType。 - 调用
chooseImage:options:发起图片选择操作。 - SDK 根据配置调起系统相册或相机。
- 用户选择或拍摄图片后,SDK 通过回调或状态回调返回选择结果。
注意事项
stateHandle不应为空,否则 SDK 可能无法正确管理当前操作状态或回调。options不应为空。count表示最多可选择的图片数量,未设置时默认值为9。- 当
sourceType包含camera时,调用前需要确保 App 已具备相机权限,并在Info.plist中配置相机权限描述。 - 当
sourceType包含album时,调用前需要确保 App 已具备相册访问权限,并在Info.plist中配置相册权限描述。 - 如果同时支持相册和相机,SDK 或系统可能会先展示来源选择入口。
- 如果仅支持相机,通常只能拍摄或选择一张图片,具体行为以 SDK 实现和系统能力为准。
sizeType如果同时包含original和compressed,SDK 可能根据用户选择或默认策略返回对应尺寸图片。- 该方法无同步返回值,图片选择结果应以 SDK 回调或状态回调为准。
