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
- downloadBase : url
- jsonFileName : string
- localDownloadDir : url
- offlineAssetsFilePath : url
- preferredLocalDownloadDir : url
- zipFileName : string
Signaux
- finished(bool success)
- progressChanged(int progressValue, int progressMaximum, string progressText)
- started()
Méthodes
- stringlist networkErrors()
- stringlist sslErrors()
- void start()
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.
É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.