Type 2 Online Store에 대한 레지스트리 키 및 항목

  • 아티클

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

참고

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

Windows 미디어 플레이어 형식 2 온라인 저장소를 사용할 수 있도록 하려면 온라인 스토어 공급자가 사용자의 컴퓨터에 다음 레지스트리 하위 키 및 항목을 만들어야 합니다.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MediaPlayer\Subscriptions\keyName]
"Capabilities"=dword:flags
"SubscriptionObjectGUID"=clsid
"FriendlyName"=friendlyName

[HKEY_CLASSES_ROOT\CLSID\clsid]
@=className

[HKEY_CLASSES_ROOT\CLSID\clsid\InprocServer32]
@=moduleName
"ThreadingModel"="Apartment"

이전 레지스트리 구문에서 기울임꼴의 기호는 이름에 대한 자리 표시자이며 온라인 저장소와 관련된 GUID(Globally Unique Identifier)입니다. 다음 표에서는 이러한 자리 표시자에 대해 설명합니다.

자리 표시자 Description
keyName Microsoft와 온라인 스토어 간에 합의된 문자열입니다. 이 문자열은 온라인 저장소를 고유하게 식별합니다. 예: "Proseware"
flags 하나 이상의 플러그 인 기능 플래그의 비트 OR 이 플래그는 Windows 미디어 플레이어 IWMPSubscriptionService 및 IWMPSubscriptionService2의 특정 메서드를 호출해야 하는지 여부를 지정합니다. 지원되는 플래그에 대한 자세한 내용은 이 테이블 뒤의 플러그 인 기능 플래그 표를 참조하세요. 예: 00000037
Clsid 온라인 저장소의 플러그 인에서 IWMPSubscriptionService 를 구현하는 클래스의 CLSID(클래스 식별자)인 GUID입니다. 이 GUID는 중괄호가 있는 레지스트리 형식이어야 합니다. 형식: {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx}
Friendlyname 온라인 스토어의 이름입니다. 예: "Proseware Music Service"
pluginName 온라인 스토어의 플러그 인 이름입니다. 예: "Proseware Service 플러그 인"
Classname 온라인 스토어의 플러그 인에서 IWMPSubscriptionService 를 구현하는 클래스의 이름입니다. 예: "CProsewareService"
moduleName 온라인 스토어의 플러그 인을 구현하는 DLL에 대한 정규화된 경로입니다. 예: "C:\Program Files\Proseware\ProsewareService.dll"

다음 표에서는 플러그 인 기능 플래그에 대해 설명합니다.

플래그 값 설명
SUBSCRIPTION_CAP_ALLOWPLAY 0X1 Windows 미디어 플레이어 IWMPSubscriptionService::allowPlay를 호출해야 합니다.
SUBSCRIPTION_CAP_ALLOWCDBURN 0X2 Windows 미디어 플레이어 IWMPSubscriptionService::allowCDBurn을 호출해야 합니다.
SUBSCRIPTION_CAP_ALLOWPDATRANSFER 0X4 Windows 미디어 플레이어 IWMPSubscriptionService::allowPDATransfer를 호출해야 합니다.
SUBSCRIPTION_CAP_BACKGROUNDPROCESSING 0X8 Windows 미디어 플레이어 IWMPSubscriptionService::startBackgroundProcessing을 호출해야 합니다.
SUBSCRIPTION_CAP_DEVICEAVAILABLE 0X10 Windows 미디어 플레이어 IWMPSubscriptionService2::d eviceAvailable을 호출해야 합니다.
SUBSCRIPTION_CAP_PREPAREFORSYNC 0X20 Windows 미디어 플레이어 IWMPSubscriptionService2::p repareForSync를 호출해야 합니다.
SUBSCRIPTION_V1_CAPS 0XF 기본값 이 값은 등록되지 않은 경우에 사용됩니다. 이는 SUBSCRIPTION_CAP_ALLOWPLAY, SUBSCRIPTION_CAP_ALLOWCDBURN, SUBSCRIPTION_CAP_ALLOWPDATRANSFER 및 SUBSCRIPTION_CAP_BACKGROUNDPROCESSING 결합하는 것과 같습니다.

개발 및 테스트를 위한 레지스트리 항목

온라인 스토어 개발을 시작할 때 Microsoft는 테스트 키와 프로덕션 키라는 두 가지 키를 제공합니다. 개발 및 테스트 단계에서는 테스트 키 또는 프로덕션 키가 사용자 컴퓨터의 레지스트리에 있는 경우에만 온라인 저장소가 Windows 미디어 플레이어 표시됩니다. 테스트 및 프로덕션 키에 대한 자세한 내용은 유형 2 온라인 스토어에 대한 테스트 및 프로덕션 키를 참조하세요.

레지스트리의 다음 위치에 테스트 또는 프로덕션 키를 배치합니다.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "key1;key2;...;keyN"

TestParameter 레지스트리 항목의 값은 여러 테스트 또는 프로덕션 키를 지정할 수 있습니다. 예를 들어 Proseware의 테스트 키가 "1234"이고 Contoso에 테스트 키가 "2345"라고 가정합니다. 다음 레지스트리 항목은 Proseware 및 Contoso에 대한 테스트 저장소가 Windows 미디어 플레이어 표시되도록 지정합니다.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "1234;2345"

ActiveService 레지스트리 항목

사용자가 온라인 스토어를 활성화하면 Windows 미디어 플레이어 활성 온라인 저장소를 식별하는 정보를 레지스트리에 씁니다. Windows 미디어 플레이어 사용자의 컴퓨터에 있는 레지스트리의 다음 위치에 정보를 배치합니다.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Subscriptions]
"ActiveService"=serviceInfo

이전 레지스트리 구문에서 serviceInfo 는 활성 온라인 저장소에 대한 설명 정보가 포함된 문자열의 자리 표시자입니다.

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