すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:プログレスバー (Android SDK)

最終更新日:Nov 30, 2025

プログレスバーを使用して、アップロードまたはダウンロード中のオブジェクトの進行状況を表示できます。

注意事項

  • このトピックのサンプルコードを実行する前に、カスタムドメイン名の使用や Security Token Service (STS) などの方法で OSSClient インスタンスを作成する必要があります。詳細については、「初期化 (Android SDK)」をご参照ください。

次のサンプルコードは、asyncPutObject を使用してオブジェクトを非同期にアップロードする際に、プログレスバーを使用する方法の例を示しています。

// アップロードリクエストを作成します。
// バケット名 (例:examplebucket)、オブジェクトの完全なパス (例:exampledir/exampleobject.txt)、およびローカルファイルの完全なパス (例:/storage/emulated/0/oss/examplefile.txt) を指定します。
// オブジェクトの完全なパスにバケット名を含めないでください。
PutObjectRequest put = new PutObjectRequest("examplebucket", "exampledir/exampleobject.txt", "/storage/emulated/0/oss/examplefile.txt");

// プログレスコールバック関数を設定して、プログレスバーを表示します。
put.setProgressCallback(new OSSProgressCallback<PutObjectRequest>() {
    @Override
    public void onProgress(PutObjectRequest request, long currentSize, long totalSize) {
        // currentSize はアップロードされた部分のサイズです。 単位:バイト。
        // totalSize はアップロードするファイルの合計サイズです。 単位:バイト。
        Log.d("PutObject", "currentSize: " + currentSize + " totalSize: " + totalSize);
    }
});

// ファイルを非同期にアップロードします。
OSSAsyncTask task = oss.asyncPutObject(put, new OSSCompletedCallback<PutObjectRequest, PutObjectResult>() {
    @Override
    public void onSuccess(PutObjectRequest request, PutObjectResult result) {
        Log.d("PutObject", "UploadSuccess");
        Log.d("ETag", result.getETag());
        Log.d("RequestId", result.getRequestId());
    }

    @Override
    public void onFailure(PutObjectRequest request, ClientException clientExcepion, ServiceException serviceException) {
        // リクエスト例外。
        if (clientExcepion != null) {
            // クライアント例外 (ネットワーク例外など)。
            clientExcepion.printStackTrace();
        }
        if (serviceException != null) {
            // サービス例外。
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});
// task.cancel(); // タスクをキャンセルします。
// task.waitUntilFinished(); // タスクが完了するまで待機します。

関連ドキュメント

オブジェクトのアップロード時にプログレスバーを使用する方法に関する完全なサンプルコードについては、GitHub をご参照ください。