ContentDistributor 특성 추가

  • 아티클

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

사용자가 온라인 스토어 콘텐츠를 재생하거나 콘텐츠를 CD 또는 디바이스에 복사하려고 하면 Windows 미디어 플레이어 COM 개체의 특정 메서드를 호출합니다. 이를 위해 플레이어는 콘텐츠를 다른 온라인 스토어 공급자와 구별할 수 있는 방법이 필요합니다. 온라인 스토어 키 이름을 ContentDistributor ( WM/ContentDistributor라는 Windows Media Format SDK 특성의 별칭) 특성의 값으로 Windows 미디어 기반 콘텐츠에 추가하면 플레이어가 서비스와 연결된 콘텐츠를 식별할 수 있습니다.

ContentDistributor에 대한 값을 추가하면 Windows 미디어 플레이어 제공하는 콘텐츠에 대한 노드를 라이브러리에 만들 수 있습니다. 라이브러리 통합을 참조하세요.

다음 두 가지 방법으로 이 값을 지정할 수 있습니다.

  • Windows 미디어 플레이어 개체 모델을 사용합니다. 이렇게 하면 Windows 미디어 플레이어 지정한 값을 라이브러리 데이터베이스에 추가합니다. 결국 플레이어는 특성 값도 디지털 미디어 파일에 씁니다.
  • Windows Media Format SDK를 사용하여 프로그래밍 방식으로 WM/ContentDistributor 특성을 추가합니다. 이렇게 하면 Windows 미디어 플레이어 특성 값을 읽고 디지털 미디어 파일이 라이브러리에 추가되면 데이터베이스에 추가합니다.

온라인 스토어 COM 개체를 만들 때 ContentDistributor 에 대해 설정한 파일 특성 값과 YourProject.h의 상수 kszContentDistributorID에 할당된 값은 정확히 일치해야 합니다. 프로젝트 마법사를 사용하여 프로젝트를 만들 때 COM 개체에 대해 이 상수 값을 지정했습니다. 이 값을 수동으로 변경할 수 있습니다. 서비스를 고유하게 식별하는 문자열을 사용해야 합니다.

Windows 미디어 플레이어 개체 모델 사용

Windows 미디어 플레이어 개체 모델을 사용하여 ContentDistributor의 값을 지정하려면 Media.setItemInfo 메서드를 사용합니다. 다음 예제 코드는 현재 재생 중인 미디어 항목의 ContentDistributor 에 대한 "Proseware" 값을 지정합니다.

// Retrieve the current media item.
var theMedia = Player.currentMedia;

//Test whether the media item was retrieved.
if(theMedia)
{
    // Set the ContentDistributor value.
    theMedia.setItemInfo("ContentDistributor", "Proseware");
}

Windows Media Format SDK 사용

Windows 미디어 플레이어 SDK에는 Windows Media Format 9 Series SDK를 사용하여 WM/ContentDistributor 특성을 추가하는 방법을 보여 주는 SetContentDistributor.cpp라는 샘플 C++ 파일이 포함되어 있습니다. SDK를 설치한 메타데이터라는 폴더에서 이 샘플 파일을 찾을 수 있습니다. 이 코드를 사용하려면 다음 단계를 수행해야 합니다.

  1. Windows Media Format 9 Series SDK를 설치하고 설명서에 설명된 대로 런타임을 구성합니다.
  2. Visual Studio에서 빈 C++ 프로젝트를 새로 만들고 SetContentDistributor.cpp라는 샘플 파일을 프로젝트에 추가합니다.
  3. Windows Media Format 9 Series SDK Lib 폴더의 경로를 파일 경로 목록에 추가합니다. 도구 메뉴에서 옵션을 선택합니다.
  4. 옵션 대화 상자에서 프로젝트를 클릭한 다음 VC++ 디렉터리를 클릭합니다.
  5. 디렉터리 표시 드롭다운 목록 상자에서 라이브러리 파일을 클릭합니다.
  6. 단추를 사용하여 목록 상자에 경로를 추가합니다.
  7. 프로젝트의 속성 페이지 대화 상자를 엽니다. 구성 속성, 링커, 입력을 차례로 선택합니다. 추가 종속성 텍스트 상자에 "wmvcore.lib"를 입력합니다.

샘플 코드는 명령줄 프로그램을 만듭니다. 프로그램을 실행할 때 제공하는 인수는 수정할 디지털 미디어 파일의 경로와 ContentDistributor 특성 값에 대한 문자열을 지정합니다. 이 코드는 IWMHeaderInfo::SetAttribute 를 사용하여 지정한 파일에 특성을 추가합니다. 이 샘플을 있는 그대로 사용하거나 자체 프로그램의 시작점으로 사용할 수 있습니다.

유형 1 및 유형 2 온라인 저장소에 공통적인 정보