AssetDownloader QML Type

异步下载资产以用于 QML 示例。更多

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

所有成员（包括继承成员）的列表

属性

downloadBase : url
jsonFileName : string
localDownloadDir : url
offlineAssetsFilePath : url
preferredLocalDownloadDir : url
zipFileName : string

信号

finished(bool success)
progressChanged(int progressValue, int progressMaximum, string progressText)
started()

方法

stringlist networkErrors()
stringlist sslErrors()
void start()

详细说明

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.