Download Manager (다운로드 매니저)

개요

Download Manager는 원격 소스에서 로컬 저장소로 파일을 다운로드하는 기능을 제공하는 Game Framework의 핵심 모듈입니다.

다운로드 작업을 관리하고, 진행 상황을 추적하며, 오류를 처리하고, 우선순위 기반 동시 다운로드 시스템을 제공합니다.

•

GameFramework의 Network 및 IO 시스템의 일부

•

다른 시스템에서 다운로드 요청을 받을 수 있는 인터페이스 제공

•

여러 Download Agent를 관리하여 동시 다운로드 지원

•

모든 다운로드 작업의 상태와 진행률을 추적

아키텍처

Download Manager는 여러 핵심 구성 요소가 계층적으로 협력하는 구조로 이루어져 있습니다.

핵심 구성 요소

1. Download Manager

중앙 클래스 DownloadManager는 IDownloadManager 인터페이스를 구현합니다.

다운로드 작업 풀을 관리하고, 다운로드 속도를 추적하며, 다운로드 라이프사이클에 대한 이벤트를 발생시킵니다.

주요 속성:

•

Paused: 모든 다운로드 작업 일시정지 여부

•

TotalAgentCount: 전체 다운로드 에이전트 수

•

FreeAgentCount: 사용 가능한 에이전트 수

•

WorkingAgentCount: 현재 작업 중인 에이전트 수

•

WaitingTaskCount: 대기 중인 다운로드 작업 수

•

FlushSize: 디스크 기록 버퍼 크기 (기본 1MB)

•

Timeout: 다운로드 유휴 시간 제한 (기본 30초)

•

CurrentSpeed: 현재 다운로드 속도

주요 메서드:

•

AddDownloadAgentHelper: 새로운 다운로드 에이전트 헬퍼 추가

•

AddDownload: 다운로드 작업 생성 및 큐 등록 (여러 오버로드 제공)

•

RemoveDownload: 특정 다운로드 작업 제거

•

GetDownloadInfo: 특정 다운로드 작업 정보 조회

2. Download Agent

DownloadAgent는 하나의 다운로드 작업을 처리합니다.

파일 스트림을 열고 데이터를 기록하며, IDownloadAgentHelper를 통해 실제 네트워크 다운로드를 수행합니다.

주요 속성:

•

Task: 현재 처리 중인 다운로드 작업

•

WaitTime: 마지막 데이터 수신 이후 경과 시간 (타임아웃 추적용)

•

StartLength: 이어받기 시작 시 기존 파일 크기

•

DownloadedLength: 이번 세션에서 다운로드된 데이터 크기

•

CurrentLength: 전체 파일 크기 (StartLength + DownloadedLength)

•

SavedLength: 디스크에 저장된 데이터 크기

주요 동작:

•

파일 스트림 열기 및 관리

•

다운로드 진행률 추적

•

타임아웃 처리

•

데이터 청크 처리

•

디스크에 데이터 플러시

3. Download Agent Helper

IDownloadAgentHelper는 플랫폼별 다운로드 구현을 담당하는 인터페이스입니다.

구체 구현체가 실제 네트워크 요청을 처리합니다.

이벤트:

•

DownloadAgentHelperUpdateBytes: 새로운 바이트 수신 시 발생

•

DownloadAgentHelperUpdateLength: 다운로드 진행률 업데이트 시 발생

•

DownloadAgentHelperComplete: 다운로드 완료 시 발생

•

DownloadAgentHelperError: 오류 발생 시 발생

메서드:

•

Download: 다운로드 시작 (이어받기 지원 버전 포함)

•

Reset: 재사용을 위한 초기화

4. Download Counter

DownloadCounter는 다운로드 속도를 계산합니다.

•

시간 기반 슬라이딩 윈도우 방식 사용

•

최근 다운로드 속도 기록 유지

주요 속성:

•

UpdateInterval: 속도 계산 주기

•

RecordInterval: 속도 기록 윈도우 길이

•

CurrentSpeed: 현재 계산된 다운로드 속도

다운로드 과정

다운로드 작업의 라이프사이클:

다운로드 작업 생성

DownloadManager 작업 풀에 추가

에이전트가 작업을 시작, 파일 스트림 열기

데이터 수신 및 기록

진행률 추적

완료 시 이벤트 발생

이벤트 시스템

Download Manager는 이벤트 기반 알림을 제공합니다:

이벤트	설명	EventArgs
DownloadStart	다운로드 시작 시	DownloadStartEventArgs
DownloadUpdate	다운로드 진행 업데이트	DownloadUpdateEventArgs
DownloadSuccess	다운로드 성공 시	DownloadSuccessEventArgs
DownloadFailure	다운로드 실패 시	DownloadFailureEventArgs

각 이벤트는 다음 정보를 포함합니다:

•

작업 ID (Serial ID)

•

다운로드 경로 (저장 위치)

•

다운로드 URI (소스 주소)

•

현재 진행률

•

사용자 데이터(UserData)

작업(Task) 관리

다운로드 작업은 작업 풀에서 관리됩니다.

지원 기능:

•

우선순위 큐잉: 우선순위 높은 작업 먼저 처리

•

태그 기반 관리: 태그를 통해 작업 그룹화

•

Serial ID 추적: 각 작업은 고유 ID 보유

•

사용자 데이터 연결: 사용자 정의 데이터 부착 가능

조회 메서드:

•

GetDownloadInfo(serialId)

•

GetDownloadInfos(tag)

•

GetAllDownloadInfos()

삭제 메서드:

•

RemoveDownload(serialId)

•

RemoveDownloads(tag)

•

RemoveAllDownloads()

이어받기(Resumable Downloads)

Download Manager는 중단된 다운로드 재개를 지원합니다.

작동 방식:

•

.download 확장자의 임시 파일 확인

•

존재하면 append 모드로 열기

•

기존 크기 이후부터 다운로드 시작

•

완료 시 .download 파일을 최종 파일명으로 변경

다운로드 속도 추적

DownloadCounter는 링크드 리스트 기반 샘플 노드를 사용하여 속도를 계산합니다.

•

최근 데이터 전송량 기록 유지

•

슬라이딩 윈도우 방식으로 평균 속도 계산

•

결과는 DownloadManager.CurrentSpeed로 제공

버퍼링과 성능

다운로드는 버퍼 기반 디스크 기록으로 성능을 최적화합니다:

•

데이터가 FlushSize(기본 1MB)까지 메모리에 쌓임

•

임계치 도달 시 디스크로 플러시

•

디스크 I/O 감소 → 성능 향상

※ FlushSize는 플랫폼 특성과 메모리 제약에 따라 조정 가능

Web Request Manager와 비교

구분	Download Manager	Web Request Manager
주요 목적	파일 다운로드 (디스크 저장)	웹 서비스 요청
데이터 처리	파일 시스템에 스트리밍	메모리에 응답 반환
이어받기	지원 (부분 다운로드)	미지원
진행률 추적	세부 이벤트 제공	제한적 (시작/완료)
속도 계산	다운로드 속도 제공	없음
버퍼 관리	FlushSize 설정 가능	없음

•

파일 다운로드 → Download Manager

•

웹 API 호출 → Web Request Manager

사용 예시

다운로드 추가

// 기본 다운로드
int downloadId = downloadManager.AddDownload(
    downloadPath: "Assets/Downloads/example.zip",
    downloadUri: "https://example.com/files/example.zip"
);

// 태그, 우선순위, 사용자 데이터 포함
int downloadId = downloadManager.AddDownload(
    downloadPath: "Assets/Downloads/example.zip",
    downloadUri: "https://example.com/files/example.zip",
    tag: "AssetUpdates",
    priority: 100,
    userData: myCustomData
);
C#
복사

진행 상황 모니터링

downloadManager.DownloadStart   += OnDownloadStart;
downloadManager.DownloadUpdate  += OnDownloadUpdate;
downloadManager.DownloadSuccess += OnDownloadSuccess;
downloadManager.DownloadFailure += OnDownloadFailure;
C#
복사

다운로드 에이전트 추가

IDownloadAgentHelper downloadAgentHelper = new MyDownloadAgentHelper();
downloadManager.AddDownloadAgentHelper(downloadAgentHelper);
C#
복사

※ 동시 다운로드 개수는 플랫폼 성능 및 네트워크 환경에 맞게 조절 필요

성능 고려사항

•

동시 다운로드: 너무 많으면 네트워크/디스크 I/O 과부하

•

FlushSize: 크게 하면 디스크 I/O 줄지만 메모리 사용 증가

•

Timeout: 네트워크 환경에 맞게 적절히 설정 필요

•

우선순위: 중요한 자산은 높은 우선순위 부여

원하시면 제가 Download Manager와 Network Manager 차이점 비교도 표로 정리해드릴 수 있습니다.

둘 다 "네트워크 기반 모듈"이지만, 하나는 파일 다운로드 전용, 다른 하나는 패킷 통신 전용이라 혼동될 수 있습니다. 정리해드릴까요?

Download Manager (다운로드 매니저)