DownloadCollection.startDownload 메서드

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

참고

이 섹션에서는 온라인 스토어에서 사용하도록 설계된 기능에 대해 설명합니다. 온라인 스토어의 컨텍스트 외부에서는 이 기능을 사용할 수 없습니다.

startDownload 메서드는 다운로드를 큐에 대기합니다.

구문

retVal = DownloadCollection.startDownload(
  sourceURL,
  type
)

매개 변수

sourceURL [in]

다운로드의 URL을 지정하는 문자열입니다.

형식 [in]

다운로드 유형을 지정하는 문자열입니다. 다음 값 중 하나가 포함됩니다.

값 설명
background (Windows XP 이상). 프로세서 시간을 사용할 수 있게 되면 다운로드가 백그라운드 프로세스로 발생합니다. 다운로드 상태는 Windows 미디어 플레이어 또는 Windows XP가 종료된 경우에도 유지됩니다.
실시간 (지원되는 모든 운영 체제). 다운로드는 한 번에 발생합니다. 세션 간에는 다운로드 상태가 유지되지 않습니다.

반환 값

이 메서드는 DownloadItem 개체를 반환합니다.

설명

새 다운로드가 시작되면 다운로드 관리자가 다운로드를 시작한 다운로드 컬렉션에 항목으로 추가합니다.

다음 디지털 미디어 형식만 다운로드할 수 있습니다.

  • ASF(Advanced Systems Format)
  • MP3
  • WMA(Windows Media 오디오)
  • WMV(Windows Media Video)

sourceURL 매개 변수는 유니코드로 인코딩된 문자열을 지원하지 않습니다. 유효한 콘텐츠를 가리킬 수 있어야 합니다. 리디렉션은 지원되지 않습니다.

Windows XP를 사용하는 경우 오디오 파일은 파일 수준 메타데이터 값에 따라 적절한 내 음악 하위 폴더에 자동으로 배치됩니다. 비디오 파일은 \My Music\download\random number형식에 배치됩니다. 여기서 난수\는 각 사용자에 대해 Windows 미디어 플레이어 생성된 임의 값이고, 형식은 다운로드 유형에 따라 "실시간" 또는 "배경"입니다.

Windows 98 및 ME(Windows Millennium Edition)와 함께 Windows 미디어 플레이어 9 시리즈를 사용하는 경우 오디오 및 비디오 파일은 \My Music\download\random number형식에 배치됩니다. 여기서 난수는 각 사용자에 대해 Player에서 생성한 난수 \ 값이고 형식은 다운로드 유형에 따라 "실시간" 또는 "배경"입니다.

파일에 포함된 메타데이터 특성과 옵션 대화 상자에서 사용자가 지정한 규칙에 따라 파일의 이름을 바꿀 수 있습니다. 앨범 또는 아티스트와 같은 메타데이터가 포함되지 않은 파일은 알 수 없는 아티스트 또는 알 수 없는 앨범이라는 폴더로 이동할 수 있습니다.

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 9 시리즈 이상
DLL
Wmp.dll

추가 정보

DownloadCollection 개체

DownloadItem 개체