Windows 미디어 플레이어 BITS 작업 규칙

  • 아티클

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

Windows 미디어 플레이어 BITS(Background Intelligent Transfer Service)를 사용하는 경우 자동으로 디지털 미디어 항목을 다운로드하여 라이브러리에 추가할 수 있습니다. 이 기능을 활용하려면 BITS 전송 큐에 작업을 추가하고 IBackgroundCopyJob::SetDescription을 호출하여 올바른 형식을 사용하는 설명 문자열을 제공해야 합니다.

참고

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

 

구문

::WMP_JOB:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

매개 변수

serviceId

Windows 미디어 플레이어 서비스를 식별하는 데 사용하는 임의로 생성된 32비트 값입니다.

Provider

공급자 이름입니다. 이 값은 유효한 온라인 스토어 키 이름과 일치해야 합니다.

AlbumArtist

앨범의 기본 아티스트 이름입니다.

AlbumTitle

앨범의 제목입니다.

TrackNumber

CD 트랙 번호입니다.

제목

콘텐츠의 제목입니다.

기간

콘텐츠의 기간입니다.

평가

콘텐츠에 대한 등급입니다.

설명

Windows 미디어 플레이어 10 이상에서 BITS를 사용하여 콘텐츠를 다운로드하는 경우 전송 큐의 작업을 열거하고 각 작업에 대한 설명 문자열을 검사합니다. 설명 문자열이 예상된 규칙과 일치하는 경우 Windows 미디어 플레이어 콘텐츠를 다운로드합니다.

다운로드할 디지털 미디어 파일은 각 BITS 작업에 하나만 추가해야 합니다.

이 규칙을 사용하여 BITS 작업을 시작한 후에는 Windows 미디어 플레이어 작업을 완료하도록 해야 합니다. 또한 Windows 미디어 플레이어 BITS 큐에서 작업을 제거하고, 다운로드한 파일을 찢어진 음악이 저장된 위치로 이동하고, 다운로드한 파일을 라이브러리에 추가합니다.

serviceId 매개 변수에는 0이 아닌 32비트 값이 포함되어야 합니다. CryptGenRandom 함수를 사용하여 이 값을 만드는 것이 좋습니다.

IBackgroundCopyJob::AddFile의 localName 매개 변수를 사용하여 지정하는 파일 이름에는 .wma, .wmv, .mp3 또는 .asf 파일 이름 확장명이 있어야 합니다.

나머지 매개 변수는 콘텐츠와 관련된 메타데이터 값을 포함하도록 설계되었습니다. DownloadItem.getItemInfo를 사용하여 온라인 스토어 웹 페이지에서 이러한 값을 검색할 수 있습니다. DownloadManager.getDownloadCollection을 호출하고 serviceId를 collectionId 매개 변수로 제공하여 올바른 다운로드 컬렉션을 검색할 수 있습니다.

Windows 미디어 플레이어 플레이어가 실행되는 동안 BITS 큐를 주기적으로 검사합니다. Windows 미디어 플레이어 다운로드 작업에 대한 BITS 큐를 확인하려면 다음 레지스트리 하위 키에 값을 만들어야 합니다.

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services

값은 다음과 같이 만들어야 합니다.

이름 형식 설명
RefreshDownload DWORD Windows 미디어 플레이어 BITS 큐에서 다운로드 작업을 검사해야 하는지 여부를 지정합니다. 값이 0이면 플레이어는 BITS 큐를 검사하지 않습니다. 값이 0이 아닌 경우 플레이어는 큐를 검사해야 합니다.

 

다음 대체 구문을 사용하여 Windows 미디어 플레이어 완료되지 않지만 상태 정보를 표시하는 BITS 작업을 추가할 수 있습니다.

::WMP_STATUS:1:serviceId:Provider:AlbumArtist:AlbumTitle:TrackNumber:Title:Duration:Rating

위의 구문을 사용하는 경우 코드를 작성하여 BITS 다운로드를 완료하고, 사용자의 컴퓨터에서 콘텐츠를 구성하고, 원하는 경우 라이브러리에 콘텐츠를 추가해야 합니다.

CryptGenRandom

DownloadItem.getItemInfo

DownloadManager.getDownloadCollection

유형 2 온라인 스토어에 대한 참조