Skip to content

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 ​

参数类型是否必填默认值说明
countNSInteger否9最多可以选择的图片数量。
sizeTypeNSArray<NSString *> *否-图片尺寸类型。可选值:original 原图、compressed 压缩图。
sourceTypeNSArray<NSString *> *否-图片来源。可选值:album 相册、camera 相机。

sizeType 可选值 ​

常量值说明
kSUDOPImageSizeTypeOriginaloriginal原图。
kSUDOPImageSizeTypeCompressedcompressed压缩图。

sourceType 可选值 ​

常量值说明
kSUDOPImageSourceTypeAlbumalbum从系统相册选择图片。
kSUDOPImageSourceTypeCameracamera使用相机拍摄图片。

方法参数 ​

参数类型是否必填说明
stateHandleid<SUDOPStateHandle>是状态句柄对象,用于管理当前操作状态及回调。
optionsSUDOPChooseImageOptions *是图片选择配置对象,包含选择数量、图片尺寸类型、图片来源等配置。

使用示例 ​

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];

处理流程 ​

  1. 业务侧创建 SUDOPChooseImageOptions 对象。
  2. 根据业务需求设置最大选择数量 count。
  3. 根据业务需求设置图片尺寸类型 sizeType。
  4. 根据业务需求设置图片来源 sourceType。
  5. 调用 chooseImage:options: 发起图片选择操作。
  6. SDK 根据配置调起系统相册或相机。
  7. 用户选择或拍摄图片后,SDK 通过回调或状态回调返回选择结果。

注意事项 ​

  • stateHandle 不应为空,否则 SDK 可能无法正确管理当前操作状态或回调。
  • options 不应为空。
  • count 表示最多可选择的图片数量,未设置时默认值为 9。
  • 当 sourceType 包含 camera 时,调用前需要确保 App 已具备相机权限,并在 Info.plist 中配置相机权限描述。
  • 当 sourceType 包含 album 时,调用前需要确保 App 已具备相册访问权限,并在 Info.plist 中配置相册权限描述。
  • 如果同时支持相册和相机,SDK 或系统可能会先展示来源选择入口。
  • 如果仅支持相机,通常只能拍摄或选择一张图片,具体行为以 SDK 实现和系统能力为准。
  • sizeType 如果同时包含 original 和 compressed,SDK 可能根据用户选择或默认策略返回对应尺寸图片。
  • 该方法无同步返回值,图片选择结果应以 SDK 回调或状态回调为准。