Back to Qt.io
Contact Us Blog Download Qt

AssetDownloader QML Type

Lädt Assets asynchron zur Verwendung in QML-Beispielen herunter. Mehr...

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

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Der AssetDownloader-Typ bietet eine bequeme Möglichkeit, externe Assets wie Bilder, Modelle oder Datendateien von entfernten URLs herunterzuladen und sie für QML-Anwendungen verfügbar zu machen.

Hinweis: Dieser Typ ist nicht Teil der öffentlichen Qt-API und kann sich ohne Ankündigung ändern. Er ist für den internen Gebrauch oder streng kontrollierte Umgebungen gedacht.

QML-Verwendung

Um diesen Typ in QML zu verwenden, importieren Sie das Modul und instanziieren den Downloader:

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");
    }
}

Eigenschaft Dokumentation

downloadBase : url

Die Basis-URL, von der die Assets heruntergeladen werden sollen.


jsonFileName : string

Der Name der herunterzuladenden Asset-JSON-Datei. Diese Datei sollte eine Liste der herunterzuladenden Assets enthalten.

Beispielformat:

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

localDownloadDir : url

Das aktuelle lokale Verzeichnis, in dem die Assets nach dem Download gespeichert werden.


offlineAssetsFilePath : url

Der Dateipfad für Offline-Assets, der verwendet wird, wenn kein Netzwerkzugang verfügbar ist.


preferredLocalDownloadDir : url

Das bevorzugte lokale Verzeichnis, in dem die heruntergeladenen Assets gespeichert werden sollen.


zipFileName : string

Der Name der ZIP-Datei, die heruntergeladen werden soll.


Signal Dokumentation

finished(bool success)

Wird ausgegeben, wenn der Download-Prozess abgeschlossen ist. Der Parameter success zeigt an, ob der Download erfolgreich war.

Hinweis: Der entsprechende Handler ist onFinished.

Siehe auch AssetDownloader::networkErrors und AssetDownloader::sslErrors.


progressChanged(int progressValue, int progressMaximum, string progressText)

Wird ausgegeben, um den Fortschritt des Downloads anzuzeigen. progressValue ist der aktuelle Fortschritt, progressMaximum ist der erwartete Gesamtfortschritt und progressText liefert eine textliche Beschreibung.

Hinweis: Der entsprechende Handler ist onProgressChanged.


started()

Wird gesendet, wenn der Download-Prozess beginnt.

Hinweis: Der entsprechende Handler ist onStarted.


Dokumentation der Methode

stringlist networkErrors()

Gibt eine Liste der netzwerkbezogenen Fehler zurück, die während des Downloads aufgetreten sind.


stringlist sslErrors()

Gibt eine Liste von SSL-bezogenen Fehlern zurück, die während des Downloads aufgetreten sind.


void start()

Startet den Download-Prozess.


© 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.