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.