tencent cloud

dependencies {
    ...
    // Add this line
    implementation 'com.qcloud.cos:cos-android-lite:5.9.+'
}

dependencies {
    ...
    // Modify to
    implementation 'com.qcloud.cos:cos-android-nobeacon:x.x.x'

    // Modify to lite version
    implementation 'com.qcloud.cos:cos-android-lite-nobeacon:x.x.x'
}

/**
 * Obtain possible collected parameters
 * These parameters are used to analyze system operating status, optimize system performance and stability, and will not be used for other purposes.
 * os_version: system version
 * client_local_ip: local IP address
 * network_type: network status
 */
public static Map<String, String> getPrivacyParams(Context context)

// Implement a BasicLifecycleCredentialProvider subclass to handle the process of requesting temporary keys and returning the results.
public static class MySessionCredentialProvider
        extends BasicLifecycleCredentialProvider {

    @Override
    protected QCloudLifecycleCredentials fetchNewCredentials()
            throws QCloudClientException {

        // First, obtain the response containing key information from your temporary key server.

        // Then parse the response to obtain the temporary key information
        String tmpSecretId = "SECRETID"; // temporary key SecretId
        String tmpSecretKey = "SECRETKEY"; // temporary key SecretKey
        String sessionToken = "SESSIONTOKEN"; // temporary key Token
        long expiredTime = 1556183496L;// expiration timestamp of the temporary key, in seconds

        // It is recommended to return the server time as the start time of the signature to avoid requests expiring due to significant deviation in the user's local device time.
        // Return the server time as the start time of the signature
        long startTime = 1556182000L; // valid start time of the temporary key, in seconds

        // Finally, return the temporary key information object
        return new SessionQCloudCredentials(tmpSecretId, tmpSecretKey,
                sessionToken, startTime, expiredTime);
    }
}

QCloudSelfSigner myQCloudSelfSigner = new QCloudSelfSigner() {
    /**
     * Sign the request
     *
     * @param request request to be signed
     * @throws QCloudClientException client exception
     */
    @Override
    public void sign(QCloudHttpRequest request) throws QCloudClientException {
        // 1. Pass the request parameters to the server to calculate the signature
        String auth = "get auth from server";
        // 2. Add the signature to the request
        request.addHeader(HttpConstants.Header.AUTHORIZATION, auth);
    }
});

String secretId = "SECRETID"; // User's SecretId. It is recommended to use sub-account keys, with authorization following the least privilege principle to mitigate usage risks. For information on how to obtain sub-account keys, see https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1
String secretKey = "SECRETKEY"; // User's SecretKey. It is recommended to use sub-account keys, with authorization following the least privilege principle to mitigate usage risks. For information on how to obtain sub-account keys, see https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1

// keyDuration is the validity period of the key in the request, in seconds
QCloudCredentialProvider myCredentialProvider =
    new ShortTimeCredentialProvider(secretId, secretKey, 300);
    
// Starting from version 5.9.33, setting the start time is supported. If no start time is configured, the system current time will be used as the start time.
// Key validity start time in seconds. It is recommended to use the server time as the start time of the signature to avoid request expiration due to significant deviation in the user's local device time.
// long startTime = 1556182000L;
// QCloudCredentialProvider myCredentialProvider =
//   new ShortTimeCredentialProvider(secretId, secretKey, startTime, 300);

// Here, it is assumed that the class name is MySessionCredentialProvider. Initialize an instance to provide keys to the SDK.
QCloudCredentialProvider myCredentialProvider = new MySessionCredentialProvider();
CosXmlService cosXmlService = new CosXmlService(context,
    serviceConfig, myCredentialProvider);

CosXmlService cosXmlSelfService = new CosXmlService(context,
    serviceConfig, myQCloudSelfSigner);

CosXmlService cosXmlService = new CosXmlService(context,
    serviceConfig, myCredentialProvider);

{
  "version": "2.0",
  "statement": [
    {
      "action": [
                //head operation 
                "name/cos:HeadObject",
                //Downloading operation
                "name/cos:GetObject",
      ],
      "effect": "allow",
      "resource": [
        "qcs::cos:ap-beijing:uid/1250000000:examplebucket-1250000000/doc/*"
      ]
    }
  ]
}

// The advanced download API supports resuming interrupted transfers, so it initiates a HEAD request to obtain file information before downloading.
// If you are using temporary keys or accessing with a sub-account, please ensure that the HeadObject permission is included in the permission list.

// Initialize TransferConfig. The default configuration is used here. If customization is needed, see the SDK API documentation.
TransferConfig transferConfig = new TransferConfig.Builder().build();
//Initialize TransferManager
TransferManager transferManager = new TransferManager(cosXmlService,
        transferConfig);

// The bucket name consists of bucketname-appid, where the appid must be included. You can view the bucket name in the COS console. https://console.tencentcloud.com/cos5/bucket
String bucket = "examplebucket-1250000000";
String cosPath = "exampleobject.txt"; // The location identifier of the object in the bucket, also known as the object key
//Local directory path
String savePathDir = context.getExternalCacheDir().toString();
// The filename saved locally. If not specified (null), it will be the same as the filename on COS.
String savedFileName = "exampleobject.txt";

Context applicationContext = context.getApplicationContext(); // application
// context
COSXMLDownloadTask cosxmlDownloadTask =
        transferManager.download(applicationContext,
                bucket, cosPath, savePathDir, savedFileName);

// Set the download progress callback
cosxmlDownloadTask.setCosXmlProgressListener(new CosXmlProgressListener() {
    @Override
    public void onProgress(long complete, long target) {
        // todo Do something to update progress...
    }
});
// Set the result callback
cosxmlDownloadTask.setCosXmlResultListener(new CosXmlResultListener() {
    @Override
    public void onSuccess(CosXmlRequest request, CosXmlResult result) {
        COSXMLDownloadTask.COSXMLDownloadTaskResult downloadTaskResult =
                (COSXMLDownloadTask.COSXMLDownloadTaskResult) result;
    }

    // If you are using the kotlin language to make the call, note that exceptions in the callback method are nullable; otherwise, the onFail method will not be called back. Specifically:
    // The type of clientException is CosXmlClientException?, and the type of serviceException is CosXmlServiceException?
    @Override
    public void onFail(CosXmlRequest request,
                       @Nullable CosXmlClientException clientException,
                       @Nullable CosXmlServiceException serviceException) {
        if (clientException != null) {
            clientException.printStackTrace();
        } else {
            serviceException.printStackTrace();
        }
    }
});
// Set the task status callback to monitor the task progress
cosxmlDownloadTask.setTransferStateListener(new TransferStateListener() {
    @Override
    public void onStateChanged(TransferState state) {
        // todo notify transfer state
    }
});