AssetDownloader QML Type

Télécharge des actifs de manière asynchrone pour les utiliser dans les exemples QML. Plus d'informations...

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

Propriétés

Signaux

Méthodes

Description détaillée

Le type AssetDownloader offre un moyen pratique de télécharger des ressources externes telles que des images, des modèles ou des fichiers de données à partir d'URL distantes et de les mettre à la disposition des applications QML.

Remarque : ce type ne fait pas partie de l'API Qt publique et peut être modifié sans préavis. Il est destiné à un usage interne ou à des environnements étroitement contrôlés.

Utilisation en QML

Pour utiliser ce type en QML, importez le module et instanciez le téléchargeur :

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

Documentation des propriétés

downloadBase : url

L'URL de base à partir de laquelle les ressources seront téléchargées.


jsonFileName : string

Le nom du fichier JSON des ressources à télécharger. Ce fichier doit contenir une liste des ressources à télécharger.

Exemple de format :

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

localDownloadDir : url

Répertoire local dans lequel les ressources sont stockées après le téléchargement.


offlineAssetsFilePath : url

Le chemin d'accès aux ressources hors ligne, utilisé lorsque l'accès au réseau n'est pas disponible.


preferredLocalDownloadDir : url

Le répertoire local préféré dans lequel les ressources téléchargées doivent être stockées.


zipFileName : string

Le nom du fichier ZIP à télécharger.


Signal Documentation

finished(bool success)

Émis lorsque le processus de téléchargement est terminé. Le paramètre success indique si le téléchargement a réussi.

Remarque : le gestionnaire correspondant est onFinished.

Voir également AssetDownloader::networkErrors et AssetDownloader::sslErrors.


progressChanged(int progressValue, int progressMaximum, string progressText)

Émis pour indiquer l'état d'avancement du téléchargement. progressValue représente l'état d'avancement actuel, progressMaximum l'état d'avancement total prévu et progressText une description textuelle.

Remarque : le gestionnaire correspondant est onProgressChanged.


started()

Emis lorsque le processus de téléchargement démarre.

Remarque : Le gestionnaire correspondant est onStarted.


Documentation de la méthode

stringlist networkErrors()

Renvoie une liste des erreurs liées au réseau rencontrées au cours du téléchargement.


stringlist sslErrors()

Renvoie une liste des erreurs liées à SSL rencontrées au cours du téléchargement.


void start()

Démarre le processus de téléchargement.


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