腾讯云对象存储单链接限速

简介

本文档提供关于调用上传下载接口时对链接进行限速。

使用说明

限速值设置范围为 819200 – 838860800，单位默认为 bit/s，即800Kb/s – 800Mb/s，如果超出该范围将返回400错误。
通过调用 upload 和 download 方法时传入的 trafficLimit 参数进行限速。说明关于单链接限速的更多说明，请参见 单链接限速 开发者指南。

示例代码一：上传时对单链接限速

    // 存储桶所在地域简称，例如广州地区是 ap-guangzhou    String region = "COS_REGION";    // 创建 CosXmlServiceConfig 对象，根据需要修改默认的配置参数    CosXmlServiceConfig serviceConfig = CosXmlServiceConfig(        region: region,        isDebuggable: true,        isHttps: true,    );    // 创建 TransferConfig 对象，根据需要修改默认的配置参数    // TransferConfig 可以设置智能分块阈值 默认对大于或等于2M的文件自动进行分块上传，可以通过如下代码修改分块阈值    TransferConfig transferConfig = TransferConfig(        forceSimpleUpload: false,        enableVerification: true,        divisionForUpload: 2097152, // 设置大于等于 2M 的文件进行分块上传        sliceSizeForUpload: 1048576, //设置默认分块大小为 1M    );    // 注册默认 COS TransferManger    await Cos().registerDefaultTransferManger(serviceConfig, transferConfig);
    // 获取 TransferManager    CosTransferManger transferManager = Cos().getDefaultTransferManger();    //CosTransferManger transferManager = Cos().getTransferManger("newRegion");    // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket    String bucket = "examplebucket-1250000000";    String cosPath = "exampleobject"; //对象在存储桶中的位置标识符，即称对象键    String srcPath = "本地文件的绝对路径"; //本地文件的绝对路径    //若存在初始化分块上传的 UploadId，则赋值对应的 uploadId 值用于续传；否则，赋值 null    String? _uploadId;
    // 上传成功回调    successCallBack(result) {      // todo 上传成功后的逻辑    }    //上传失败回调    failCallBack(clientException, serviceException) {      // todo 上传失败后的逻辑      if (clientException != null) {        print(clientException);      }      if (serviceException != null) {        print(serviceException);      }    }    //上传状态回调, 可以查看任务过程    stateCallback(state) {      // todo notify transfer state    }    //上传进度回调    progressCallBack(complete, target) {      // todo Do something to update progress...    }    //初始化分块完成回调    initMultipleUploadCallback(        String bucket, String cosKey, String uploadId) {      //用于下次续传上传的 uploadId      _uploadId = uploadId;    }    // 设置单链接限速，单位为 bit/s，示例设置为 1M/s    int _trafficLimit = 1024 * 1024 * 8;    //开始上传    TransferTask transferTask = await transferManager.upload(bucket, cosPath,        filePath: srcPath,        uploadId: _uploadId,        trafficLimit: _trafficLimit,        resultListener: ResultListener(successCallBack, failCallBack),        stateCallback: stateCallback,        progressCallBack: progressCallBack,        initMultipleUploadCallback: initMultipleUploadCallback    );

示例代码二：下载时对单链接限速

    // 高级下载接口支持断点续传，所以会在下载前先发起 HEAD 请求获取文件信息。    // 如果您使用的是临时密钥或者使用子账号访问，请确保权限列表中包含 HeadObject 的权限。
    // TransferManager 支持断点下载，您只需要保证 bucket、cosPath、savePath    // 参数一致，SDK 便会从上次已经下载的位置继续下载。
    // 获取 TransferManager    CosTransferManger transferManager = Cos().getDefaultTransferManger();    //CosTransferManger transferManager = Cos().getTransferManger("newRegion");    // 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket    String bucket = "examplebucket-1250000000";    String cosPath = "exampleobject"; //对象在存储桶中的位置标识符，即称对象键    String downliadPath = "本地文件的绝对路径"; //保存到本地文件的绝对路径
    // 下载成功回调    successCallBack(result) {      // todo 下载成功后的逻辑    }    //下载失败回调    failCallBack(clientException, serviceException) {      // todo 下载失败后的逻辑      if (clientException != null) {        print(clientException);      }      if (serviceException != null) {        print(serviceException);      }    }    //下载状态回调, 可以查看任务过程    stateCallback(state) {      // todo notify transfer state    }    //下载进度回调    progressCallBack(complete, target) {      // todo Do something to download progress...    }    // 设置单链接限速，单位为 bit/s，示例设置为 1M/s    int _trafficLimit = 1024 * 1024 * 8;    //开始下载    TransferTask transferTask = await transferManager.download(bucket, cosPath, downliadPath,         trafficLimit: _trafficLimit,        resultListener: ResultListener(successCallBack, failCallBack),        stateCallback: stateCallback,        progressCallBack: progressCallBack    );    //暂停任务    transferTask.pause();    //恢复任务    transferTask.resume();    //取消任务    transferTask.cancel();



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠