javaV2NIMStorageScene addCustomStorageScene(String sceneName, long expireTime);

objective-c- (void)addCustomStorageScene:(NSString *)sceneName expireTime:(NSUInteger)expireTime;

cppvirtual void addCustomStorageScene(nstd::string sceneName, uint64_t expireTime) = 0;

typescriptaddCustomStorageScene(sceneName: string, expireTime: number): V2NIMStorageScene

typescriptaddCustomStorageScene(sceneName: string, expireTime: number): V2NIMStorageScen

javaV2NIMStorageService v2StorageService = NIMClient.getService(V2NIMStorageService.class);
v2StorageService.addCustomStorageScene(sceneName, expireTime);

objective-c[[[NIMSDK sharedSDK] v2StorageService] addCustomStorageScene:@"scene_name" expireTime:1000];

cppstorageService.addCustomStorageScene("customScene", 0); // never expire

typescriptnim.V2NIMStorageService.addCustomStorageScene("nim", 86400)

typescriptnim.storageService.addCustomStorageScene("nim", 86400)

V2NIMStorageScene

无

javaList<V2NIMStorageScene> getStorageSceneList();

objective-c- (NSArray<V2NIMStorageScene *> *)getStorageSceneList;

cppvirtual nstd::vector<V2NIMStorageScene> getStorageSceneList() = 0;

typescriptgetStorageSceneList(): V2NIMStorageScene[]

typescriptgetStorageSceneList(): V2NIMStorageScene[]

javaV2NIMStorageService v2StorageService = NIMClient.getService(V2NIMStorageService.class);
List<V2NIMStorageScene> storageSceneList = v2StorageService.getStorageSceneList();

objective-c[[[NIMSDK sharedSDK] v2StorageService] getStorageSceneList];

cppauto sceneList = storageService.getStorageSceneList();

typescriptconst sceneList = nim.V2NIMStorageService.getStorageSceneList()

typescriptconst sceneList = nim.storageService.getStorageSceneList()

javaV2NIMUploadFileTask createUploadFileTask(V2NIMUploadFileParams params);

objective-c- (V2NIMUploadFileTask *)createUploadFileTask:(V2NIMUploadFileParams *)fileParams;

cppvirtual V2NIMUploadFileTask createUploadFileTask(V2NIMUploadFileParams fileParams) = 0;

typescriptcreateUploadFileTask(fileParams: V2NIMUploadFileParams): V2NIMUploadFileTask

typescriptcreateUploadFileTask(fileParams: V2NIMUploadFileParams): V2NIMUploadFileTask

javaV2NIMStorageService v2StorageService = NIMClient.getService(V2NIMStorageService.class);
V2NIMUploadFileParams params = new V2NIMUploadFileParams("filePath")
V2NIMUploadFileTask uploadFileTask = v2StorageService.createUploadFileTask(params);

objective-cV2NIMUploadFileParams *fileParams = [[V2NIMUploadFileParams alloc] init];
fileParams.filePath = @"filePath";
[[[NIMSDK sharedSDK] v2StorageService] createUploadFileTask:fileParams];

cppV2NIMUploadFileParams fileParams;
fileParams.filePath = "~/test.txt";
fileParams.name = "hello.txt";
fileParams.scene = "customScene";
auto uploadTask = storageService.createUploadFileTask(fileParams);

typescriptconst task = nim.V2NIMStorageService.createUploadFileTask({
    fileObj: document.getElementById('input-id').files[0]
}})

typescriptconst params:V2NIMUploadFileParams = {
    filePath: '文件沙盒路径',
    sceneName: '场景名'
} as V2NIMUploadFileParams

const task = nim.storageService.createUploadFileTask(params)

javavoid uploadFile(V2NIMUploadFileTask fileTask, V2NIMSuccessCallback<String> success,
    V2NIMFailureCallback failure,
    V2NIMProgressCallback progress);

objective-c- (void)uploadFile:(V2NIMUploadFileTask *)fileTask
           success:(V2NIMFileUploadSuccess)success
           failure:(V2NIMFileUploadFailure)failure
          progress:(V2NIMFileUploadProgress)progress;

cppvirtual void uploadFile(V2NIMUploadFileTask fileTask,
    V2NIMSuccessCallback<nstd::string> success,
    V2NIMFailureCallback failure,
    V2NIMProgressCallback progress) = 0;

typescriptuploadFile(fileTask: V2NIMUploadFileTask, progress: V2NIMProgressCallback): Promise<string>

typescriptuploadFile(fileTask: V2NIMUploadFileTask, progress: V2NIMProgressCallback): Promise<string>

javaV2NIMStorageService v2StorageService = NIMClient.getService(V2NIMStorageService.class);
v2StorageService.uploadFile(task, (V2NIMSuccessCallback<String>) s -> {
    // 上传成功
}, (V2NIMFailureCallback) error -> {
    // 上传失败
}, (V2NIMProgressCallback) progress -> {
    // 上传进度
});

objective-c[[[NIMSDK sharedSDK] v2StorageService] uploadFile:fileTask success:^(NSString * _Nonnull urlString) {
        // 上传成功
    } failure:^(V2NIMError * _Nonnull error) {
        // 上传失败
    } progress:^(float progress) {
         // 上传进度
    }];

cppV2NIMUploadFileParams fileParams;
fileParams.filePath = "~/test.txt";
fileParams.name = "hello.txt";
fileParams.scene = "customScene";
auto uploadTask = storageService.createUploadFileTask(fileParams);
storageService.uploadFile(
    uploadTask,
    [](nstd::string url) {
        // upload file succeeded
    },
    [](V2NIMError error) {
        // upload file failed, handle error
    },
    [](uint32_t progress) {
        // upload progress
    });

typescriptnim.V2NIMStorageService.uploadFile(task, function onProgress(progress) {
 console.log('uploadFile progress: ', progress)   
})

typescriptnim.storageService.uploadFile(task, function onProgress(progress) {
 console.log('uploadFile progress: ', progress)   
})

无返回值

Promise<string> 文件 URL 地址

• 请求成功，返回 V2NIMSuccessCallback 回调，包含文件 URL 地址。
• 请求失败，返回 V2NIMFailureCallback 回调，包含存储相关错误码。

• 请求成功，返回 V2NIMFileUploadSuccess 回调，可自定义设置。
• 请求失败，返回 V2NIMFileUploadFailure 回调，可自定义设置。

无

javavoid cancelUploadFile(V2NIMUploadFileTask fileTask, V2NIMSuccessCallback<Void> success,
    V2NIMFailureCallback failure);

objective-c- (void)cancelUploadFile:(V2NIMUploadFileTask *)fileTask
                 success:(V2NIMSuccessCallback)success
                 failure:(V2NIMFailureCallback)failure;

cppvirtual void cancelUploadFile(V2NIMUploadFileTask fileTask, V2NIMSuccessCallback<void> success, V2NIMFailureCallback failure) = 0;

typescriptcancelUploadFile(fileTask: V2NIMUploadFileTask): Promise<void>

typescriptcancelUploadFile(fileTask: V2NIMUploadFileTask): Promise<void>

javaV2NIMStorageService v2StorageService = NIMClient.getService(V2NIMStorageService.class);
v2StorageService.cancelUploadFile(task, (V2NIMSuccessCallback<Void>) s -> {
    // 取消成功
}, (V2NIMFailureCallback) error -> {
    // 取消失败
});

objective-c[[[NIMSDK sharedSDK] v2StorageService] cancelUploadFile:fileTask success:^{
        //取消成功
    } failure:^(V2NIMError * _Nonnull error) {
        //取消失败
    }];

cppV2NIMUploadFileTask fileTask;
// uploadFile
// ...
storageService.cancelUploadFile(
    fileTask,
    []() {
        // cancel upload file succeeded
    },
    [](V2NIMError error) {
        // cancel upload file failed, handle error
    });

typescriptnim.V2NIMStorageService.cancelUploadFile(task)

typescriptnim.storageService.cancelUploadFile(task)

无返回值

Promise<void>

• 请求成功，返回 V2NIMSuccessCallback 回调。
• 请求失败，返回 V2NIMFailureCallback 回调，包含存储相关错误码。

无

javavoid downloadFile(String url, String filePath, V2NIMSuccessCallback<String> success,
    V2NIMFailureCallback failure, V2NIMProgressCallback progress);

objective-c- (void)downloadFile:(NSString *)url
            filePath:(NSString *)filePath
             success:(V2NIMSuccessCallback)success
             failure:(V2NIMFailureCallback)failure
            progress:(nullable V2NIMProgressCallback)progress;

javaString url = "https://www.abc.com/ttt.txt";
// 设置文件存储位置
String filePath = "xxx/ttt.txt";
NIMClient.getService(V2NIMStorageService.class).downloadFile(url, filePath, new V2NIMSuccessCallback<String>() {
    @Override
    public void onSuccess(String filePath) {
        // 下载成功
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        // 下载失败
    }
}, new V2NIMProgressCallback() {
    @Override
    public void onProgress(int progress) {
        // 下载进度
    }
});

objective-c// 按需配置远程目录
NSString *url = @"https://www.abc.com/ttt.txt";
// 按需配置存储目录
NSString *filePath = @"Document/ttt.txt";
[[NIMSDK sharedSDK].v2StorageService downloadFile:url filePath:filePath success:^() {
    // 成功回调
} failure:^(V2NIMError *error) {
    // 失败回调
} progress:^(NSUInteger progress) {
    // 进度回调
}]; 

javavoid shortUrlToLong(String url, V2NIMSuccessCallback<String> success,
    V2NIMFailureCallback failure);

objective-c- (void)shortUrlToLong:(NSString *)url
               success:(V2NIMShortUrlToLongSuccess)success
               failure:(V2NIMFailureCallback)failure;

typescriptshortUrlToLong(url: string): Promise<string>

javaString shortUrl = "https://s.netease.im/safe/AAAAAAAAAAAAAAAAAAAAAAAAAAA?_im_url=1";
NIMClient.getService(V2NIMStorageService.class).shortUrlToLong(shortUrl, new V2NIMSuccessCallback<String>() {
    @Override
    public void onSuccess(String longUrl) {
        // 转换成功
    }
}, new V2NIMFailureCallback() {
    @Override
    public void onFailure(V2NIMError error) {
        // 转换失败
    }
});

objective-c// 按需传入短链
NSString *shortUrl = @"https://s.netease.im/safe/AAAAAAAAAAAAAAAAAAAAAAAAAAA?_im_url=1";
[[NIMSDK sharedSDK].v2StorageService shortUrlToLong:shortUrl success:^(NSString *url) {
    // 成功回调
} failure:^(V2NIMError *error) {
    // 失败回调
}];

typescriptvar shortUrl = "https://s.netease.im/safe/AAAAAAAAAAAAAAAAAAAAAAAAAAA?_im_url=1";
var originUrl = await nim.V2NIMStorageService.shortUrlToLong(shortUrl)

• 请求成功，返回 V2NIMSuccessCallback 回调。
• 请求失败，返回 V2NIMFailureCallback 回调，包含存储相关错误码。

• 请求成功，返回 V2NIMShortUrlToLongSuccess 回调，可自定义设置。
• 请求失败，返回 V2NIMFailureCallback 回调，包含存储相关错误码。

javapublic static String imageThumbUrl(String url,int thumbSize)

objective-c+ (NSString *)imageThumbUrl:(NSString *)url
                  thumbSize:(NSInteger)thumbSize;

typescriptimageThumbUrl(url: string, thumbSize: number): string

javaString url = "http://xxx.com/xxx.jpg";
int thumbSize = 100;
String imageThumbUrl = V2NIMStorageUtil.imageThumbUrl(url, thumbSize);

objective-c- (void)imageThumbUrl
{
    V2NIMMessage *message = nil; // message
    V2NIMMessageImageAttachment *attachment = nil; // image attachment
    if ([message.attachment isKindOfClass:V2NIMMessageImageAttachment.class]) {
        attachment = (V2NIMMessageImageAttachment *)(message.attachment);
    }
    if (attachment) {
        NSInteger size = 100; // screen size
        size *= UIScreen.mainScreen.scale;
        // keep aspect ratio and width or height > size
        NSString *thumbUrl = [V2NIMStorageUtil imageThumbUrl:attachment.url thumbSize:size];
    }
}

typescriptconst url = nim.V2NIMStorageUtil.imageThumbUrl("https://host/path", 80)

javapublic static String videoCoverUrl(String url,int offset)

objective-c+ (NSString *)videoCoverUrl:(NSString *)url
                     offset:(NSInteger)offset;

typescriptvideoCoverUrl(url: string, offset: number): string

javaString url = "http://xxx.com/xxx.jpg";
int offset = 0;
String videoCoverUrl = V2NIMStorageUtil.videoCoverUrl(url, offset);

objective-c- (void)videoCoverUrl
{
    V2NIMMessage *message = nil; // message
    V2NIMMessageVideoAttachment *attachment = nil; // video attachment
    if ([message.attachment isKindOfClass:V2NIMMessageVideoAttachment.class]) {
        attachment = (V2NIMMessageVideoAttachment *)(message.attachment);
    }
    if (attachment) {
        NSInteger offset = 0; // start of video
        NSString *coverUrl = [V2NIMStorageUtil videoCoverUrl:attachment.url offset:offset];
    }
}

typescriptconst url = nim.V2NIMStorageUtil.videoCoverUrl("https://host/path", 0)