NIMResourceManager Protocol Reference

Conforms to NSObject
Declared in NIMResourceManagerProtocol.h

Overview

资源管理

– upload:progress:completion: required method

上传文件

- (void)upload:(NSString *)filepath progress:(nullable NIMHttpProgressBlock)progress completion:(nullable NIMUploadCompleteBlock)completion

Parameters

filepath

上传文件路径

progress

进度Block

completion

上传Block

Discussion

上传文件

Declared In

NIMResourceManagerProtocol.h

– upload:scene:progress:completion: required method

上传文件

- (void)upload:(NSString *)filepath scene:(nonnull NSString *)scene progress:(nullable NIMHttpProgressBlock)progress completion:(nullable NIMUploadCompleteBlock)completion

Parameters

filepath

上传文件路径

scene

场景类别

progress

进度Block

completion

上传Block

Discussion

上传文件

Declared In

NIMResourceManagerProtocol.h

– upload:scene:md5:progress:completion: required method

上传文件

- (void)upload:(NSString *_Nonnull)filepath scene:(nullable NSString *)scene md5:(nullable NSString *)md5 progress:(nullable NIMHttpProgressBlock)progress completion:(nullable NIMUploadCompleteBlock)completion

Parameters

filepath

上传文件路径

scene

场景类别

md5

文件MD5

progress

进度Block

completion

上传Block

Discussion

上传文件

Declared In

NIMResourceManagerProtocol.h

– upload:extraInfo:progress:completion: required method

上传文件

- (void)upload:(NSString *_Nonnull)filepath extraInfo:(nullable NIMResourceExtraInfo *)extraInfo progress:(nullable NIMHttpProgressBlock)progress completion:(nullable NIMUploadCompleteBlock)completion

Parameters

filepath

上传文件路径

extraInfo

资源辅助信息

progress

进度Block

completion

上传Block

Discussion

上传文件

Declared In

NIMResourceManagerProtocol.h

– download:filepath:progress:completion: required method

下载文件

- (void)download:(NSString *)urlString filepath:(NSString *)filepath progress:(nullable NIMHttpProgressBlock)progress completion:(nullable NIMDownloadCompleteBlock)completion

Parameters

urlString

下载的RL

filepath

下载路径

progress

进度Block

completion

完成Block

Discussion

下载文件

Declared In

NIMResourceManagerProtocol.h

– download:filepath:extraInfo:progress:completion: required method

下载文件

- (void)download:(NSString *)urlString filepath:(NSString *)filepath extraInfo:(NIMResourceExtraInfo *_Nullable)extraInfo progress:(NIMHttpProgressBlock _Nullable)progress completion:(NIMDownloadCompleteBlock _Nullable)completion

Parameters

urlString

下载的RL

filepath

下载路径

extraInfo

资源辅助信息

progress

进度Block

completion

完成Block

Discussion

下载文件

Declared In

NIMResourceManagerProtocol.h

– cancelTask: required method

取消上传/下载任务

- (void)cancelTask:(NSString *)filepath

Parameters

filepath

上传/下载任务对应的文件路径

Discussion

取消上传/下载任务

如果同一个文件同时上传或者下载(理论上不应该出现这种情况),ResourceManager会进行任务合并,基于这个原则cancel的操作对象是某个文件对应的所有的上传/下载任务

Declared In

NIMResourceManagerProtocol.h

– normalizeURLString: required method

规范化 URL 地址

- (NSString *)normalizeURLString:(NSString *)urlString

Parameters

urlString

url 地址

Discussion

规范化 URL 地址

按照 NIMSDK 的要求对 url 进行规范化处理,调用该接口等同于同时调用 convertHttpToHttps:convertURLToAcceleratedURL:

Declared In

NIMResourceManagerProtocol.h

– convertHttpToHttps: required method

将 http url 转换为 https url

- (NSString *)convertHttpToHttps:(NSString *)urlString

Parameters

urlString

http url 地址

Discussion

将 http url 转换为 https url

SDK 会自动处理除自定义消息外所有消息内的 http url 以保证符合苹果的审核请求,但是自定义消息中的 http 地址 SDK 并不知道具体属性在哪,所以在做这些文件下载时,需要上层自己处理 如果传入的 url 是 https 地址,直接返回字符串本身。如果传入的 url 是云信无法识别 host 的 http 地址,直接返回添加了 https 的地址

Declared In

NIMResourceManagerProtocol.h

– convertURLToAcceleratedURL: required method

将 url 转换为加速后的 CDN url 地址

- (NSString *)convertURLToAcceleratedURL:(NSString *)urlString

Parameters

urlString

未加速 url 地址

Discussion

将 url 转换为加速后的 CDN url 地址

SDK 会自动处理除自定义消息外所有消息内的 url 进行 CDN 加速,但是自定义消息中的 url 地址 SDK 并不知道具体属性在哪,所以在做这些文件下载时,需要上层传入对应的 URL 替换为走 CDN 格式的地址,以获得 CDN 加速的效果

Declared In

NIMResourceManagerProtocol.h

– imageThumbnailURL: required method

将传入的 nos 图片 url 调整为缩略图形式 url

- (NSString *)imageThumbnailURL:(NSString *)urlString

Parameters

urlString

图片url

Discussion

将传入的 nos 图片 url 调整为缩略图形式 url

Declared In

NIMResourceManagerProtocol.h

– videoThumbnailURL: required method

将传入的 nos 视频 url 调整为缩略图形式 url

- (NSString *)videoThumbnailURL:(NSString *)urlString

Parameters

urlString

视频url

Discussion

将传入的 nos 视频 url 调整为缩略图形式 url

Declared In

NIMResourceManagerProtocol.h

– searchResourceFiles:completion: required method

搜索缓存的资源文件

- (void)searchResourceFiles:(NIMResourceQueryOption *)option completion:(NIMResourceSearchHandler)completion

Parameters

option

搜索选项

completion

完成回调

Discussion

搜索缓存的资源文件

Declared In

NIMResourceManagerProtocol.h

– removeResourceFiles:completion: required method

删除缓存的资源文件

- (void)removeResourceFiles:(NIMResourceQueryOption *)option completion:(NIMResourceDeleteHandler)completion

Parameters

option

搜索选项

completion

完成回调

Discussion

删除缓存的资源文件

Declared In

NIMResourceManagerProtocol.h

– fetchNOSURLWithURL:completion: required method

使用短链换源链

- (void)fetchNOSURLWithURL:(NSString *)shortCode completion:(NIMFetchURLCompletion)completion

Parameters

shortCode

短链

completion

完成回调

Discussion

使用短链换源链

当用户后台配置了NOS文件安全,文件上传的URL为短链,无法直接下载, 可通过该接口换取源链

Declared In

NIMResourceManagerProtocol.h

– fetchNOSURLWithURL:roomId:completion: required method

使用短链换源链

- (void)fetchNOSURLWithURL:(NSString *)shortCode roomId:(NSString *_Nullable)roomId completion:(NIMFetchURLCompletion)completion

Parameters

shortCode

短链

roomId

聊天室ID

completion

完成回调

Discussion

使用短链换源链

当用户后台配置了NOS文件安全,文件上传的URL为短链,无法直接下载, 可通过该接口换取源链

Declared In

NIMResourceManagerProtocol.h