Back to Qt.io
Contact Us Blog Download Qt

AssetDownloader QML Type

QMLサンプルで使用するアセットを非同期にダウンロードします。詳細...

Import Statement: import Qt.labs.assetdownloader
Since: Qt 6.8

プロパティ

信号

方法

詳細説明

AssetDownloader 型は、画像やモデル、データファイルなどの外部アセットをリモートの URL からダウンロードし、QML アプリケーションで利用できるようにする便利な方法を提供します。

注意: この型は公開されているQt APIには含まれておらず、予告なく変更される可能性があります。また、予告なしに変更される可能性があります。

QMLでの使用法

QMLでこの型を使用するには、モジュールをインポートし、ダウンローダをインスタンス化します：

import Qt.labs.assetdownloader

AssetDownloader {
    downloadBase: "https://example.com/assets/"
    preferredLocalDownloadDir: "file:///home/user/assets/"
    jsonFileName: "data.json"
    zipFileName: "archive.zip"
    onFinished: (success) => {
        if (success)
            console.log("Download completed successfully");
        else
            console.log("Download failed");
    }
}

プロパティの説明

downloadBase : url

アセットがダウンロードされるベースURL。


jsonFileName : string

ダウンロードされるアセットのJSONファイル名。このファイルには、ダウンロードされるアセットのリストが含まれていなければなりません。

フォーマット例：

{
    "url": "<base URL for asset downloads>",
    "assets": [
        "<relative path to asset file>",
        ...
    ]
}

localDownloadDir : url

ダウンロード後にアセットが保存される実際のローカルディレクトリ。


offlineAssetsFilePath : url

ネットワークにアクセスできない場合に使用する、オフラインアセットへのファイルパス。


preferredLocalDownloadDir : url

ダウンロードしたアセットが保存される優先ローカルディレクトリ。


zipFileName : string

ダウンロードするZIPファイルの名前。


シグナル ドキュメント

finished(bool success)

ダウンロードプロセスが終了したときに発行されます。success パラメータは、ダウンロードが成功したかどうかを示します。

注意： 対応するハンドラはonFinished です。

AssetDownloader::networkErrors およびAssetDownloader::sslErrorsも参照 。


progressChanged(int progressValue, int progressMaximum, string progressText)

progressValue は現在の進捗状況、progressMaximum は予想される総進捗状況、progressText はテキストによる説明である。

注: 対応するハンドラはonProgressChanged 。


started()

ダウンロード開始時に発行される。

注 ：対応するハンドラはonStarted 。


メソッドの説明

stringlist networkErrors()

ダウンロード中に発生したネットワーク関連エラーのリストを返します。


stringlist sslErrors()

ダウンロード中に発生した SSL 関連エラーのリストを返します。


void start()

ダウンロードプロセスを開始します。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.