76 lines
1.9 KiB
Objective-C
76 lines
1.9 KiB
Objective-C
//
|
||
// QiniuManager.h
|
||
// msext
|
||
//
|
||
// Created on June 15, 2025.
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
/**
|
||
* 上传完成后的回调
|
||
* @param key 文件在七牛云中的key
|
||
* @param error 错误信息，如果上传成功则为nil
|
||
*/
|
||
typedef void(^QiniuUploadCompletionHandler)(NSString * _Nullable key, NSError * _Nullable error);
|
||
|
||
/**
|
||
* 下载完成后的回调
|
||
* @param filePath 下载文件的本地路径
|
||
* @param error 错误信息，如果下载成功则为nil
|
||
*/
|
||
typedef void(^QiniuDownloadCompletionHandler)(NSString * _Nullable filePath, NSError * _Nullable error);
|
||
|
||
/**
|
||
* 进度回调
|
||
* @param progress 进度值，范围0-1
|
||
*/
|
||
typedef void(^QiniuProgressHandler)(float progress);
|
||
|
||
@interface QiniuManager : NSObject
|
||
|
||
/**
|
||
* 获取QiniuManager的单例
|
||
* @return QiniuManager实例
|
||
*/
|
||
+ (instancetype)sharedManager;
|
||
|
||
/**
|
||
* 初始化七牛云SDK
|
||
*/
|
||
- (void)setupQiniuSDK;
|
||
|
||
/**
|
||
* 上传本地音频文件到七牛云
|
||
* @param filePath 本地文件路径
|
||
* @param fileName 上传后的文件名（不含路径）
|
||
* @param progressHandler 上传进度回调
|
||
* @param completionHandler 上传完成回调
|
||
*/
|
||
- (void)uploadAudioFile:(NSString *)filePath
|
||
fileName:(NSString *)fileName
|
||
progressHandler:(nullable QiniuProgressHandler)progressHandler
|
||
completionHandler:(QiniuUploadCompletionHandler)completionHandler;
|
||
|
||
/**
|
||
* 从七牛云下载音频文件
|
||
* @param key 文件在七牛云中的key
|
||
* @param progressHandler 下载进度回调
|
||
* @param completionHandler 下载完成回调
|
||
*/
|
||
- (void)downloadAudioFile:(NSString *)key
|
||
progressHandler:(nullable QiniuProgressHandler)progressHandler
|
||
completionHandler:(QiniuDownloadCompletionHandler)completionHandler;
|
||
|
||
/**
|
||
* 根据key获取七牛云文件的URL
|
||
* @param key 文件在七牛云中的key
|
||
* @return 完整的URL字符串
|
||
*/
|
||
- (NSString *)getFileUrlWithKey:(NSString *)key;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END |