다음을 통해 공유


PlayReadyContentHeader 생성자

정의

오버로드

PlayReadyContentHeader(Byte[])

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

PlayReadyContentHeader(Byte[])

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

public:
 PlayReadyContentHeader(Platform::Array <byte> ^ headerBytes);
 PlayReadyContentHeader(winrt::array_view <byte> const& headerBytes);
public PlayReadyContentHeader(byte[] headerBytes);
function PlayReadyContentHeader(headerBytes)
Public Sub New (headerBytes As Byte())

매개 변수

headerBytes

Byte[]

byte[]

PlayReady 콘텐츠 헤더를 나타내는 원시 데이터 바이트입니다.

적용 대상

PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

public:
 PlayReadyContentHeader(Platform::Array <byte> ^ headerBytes, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);
 PlayReadyContentHeader(winrt::array_view <byte> const& headerBytes, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);
public PlayReadyContentHeader(byte[] headerBytes, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);
function PlayReadyContentHeader(headerBytes, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)
Public Sub New (headerBytes As Byte(), licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

매개 변수

headerBytes

Byte[]

byte[]

레거시 WMDRM 헤더를 나타내는 원시 데이터 바이트입니다.

licenseAcquisitionUrl
Uri Uri

자동(사용자 상호 작용 없음) 라이선스 취득 웹 서비스에 대한 URL입니다.

licenseAcquisitionUserInterfaceUrl
Uri Uri

비사일 라이선스 취득 웹 페이지의 URL입니다.

customAttributes
String

Platform::String

winrt::hstring

콘텐츠 공급자가 사용하는 사용자 지정 데이터를 포함합니다. 콘텐츠 작성자가 이 요소 내에 임의의 XML을 추가할 수 있습니다. Microsoft 코드는 이 요소 내에 포함된 데이터에 대해 아무 작업도 수행하지 않습니다.

domainServiceId
Guid

Platform::Guid

winrt::guid

도메인 서비스에 대한 서비스 식별자입니다.

설명

이 생성자는 레거시 WMDRM 헤더를 PlayReady 헤더로 변환하는 데 사용해야 합니다.

domainServiceId 매개 변수는 기본 플랫폼의 엔디언성에 민감합니다. 지원하려는 모든 플랫폼에서 앱을 신중하게 테스트하여 각 플랫폼에서 올바른 엔디언이 사용되는지 확인합니다.

적용 대상

PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

public:
 PlayReadyContentHeader(Platform::Guid contentKeyId, Platform::String ^ contentKeyIdString, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);
 PlayReadyContentHeader(winrt::guid const& contentKeyId, winrt::hstring const& contentKeyIdString, PlayReadyEncryptionAlgorithm const& contentEncryptionAlgorithm, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);
public PlayReadyContentHeader(Guid contentKeyId, string contentKeyIdString, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);
function PlayReadyContentHeader(contentKeyId, contentKeyIdString, contentEncryptionAlgorithm, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)
Public Sub New (contentKeyId As Guid, contentKeyIdString As String, contentEncryptionAlgorithm As PlayReadyEncryptionAlgorithm, licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

매개 변수

contentKeyId
Guid

Platform::Guid

winrt::guid

콘텐츠 암호화 키의 식별자입니다.

contentKeyIdString
String

Platform::String

winrt::hstring

콘텐츠 키의 문자열 표현입니다. contentKeyId 매개 변수를 지정하면 이 매개 변수는 무시됩니다.

contentEncryptionAlgorithm
PlayReadyEncryptionAlgorithm

콘텐츠를 암호화하는 데 사용되는 암호화 알고리즘 유형입니다.

licenseAcquisitionUrl
Uri Uri

자동(사용자 상호 작용 없음) 라이선스 취득 웹 서비스에 대한 URL입니다.

licenseAcquisitionUserInterfaceUrl
Uri Uri

비사일 라이선스 취득 웹 페이지의 URL입니다.

customAttributes
String

Platform::String

winrt::hstring

콘텐츠 공급자가 사용하는 사용자 지정 데이터를 포함합니다. 콘텐츠 작성자가 이 요소 내에 임의의 XML을 추가할 수 있습니다. Microsoft 코드는 이 요소 내에 포함된 데이터에 대해 아무 작업도 수행하지 않습니다.

domainServiceId
Guid

Platform::Guid

winrt::guid

도메인 서비스에 대한 서비스 식별자입니다.

설명

contentKeyIddomainServiceId 매개 변수는 기본 플랫폼의 엔디언성에 민감합니다. 지원하려는 모든 플랫폼에서 앱을 신중하게 테스트하여 각 플랫폼에서 올바른 엔디언이 사용되는지 확인합니다.

Windows 10 버전 1709부터 AES128CBC 암호화의 경우 PlayReadyEncryptionAlgorithm.Aes128Cbc 또는 PlayReadyEncryptionAlgorithm.Unspecified를 지정하여 서버 백 엔드가 contentEncryptionAlgorithm 매개 변수의 값으로 암호화 형식을 확인할 수 있도록 할 수 있습니다. 이전 버전의 Windows 10 이러한 값 중 하나를 지정하면 예외가 throw됩니다. 따라서 생성자 호출에서 새 열거형 값을 사용하기 전에 ApiInformationIsApiContractPresent 를 호출하고 주 계약 버전 5를 지정하여 열거형 값이 있는지 확인해야 합니다.

bool supportsAes128CbcAndUnspecified = ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 5);

if (supportsAes128CbcAndUnspecified)
{
    // Guid and URL below are known by app, obtaining them is out of scope
    PlayReadyContentHeader header = new PlayReadyContentHeader(
        new Guid("{6591a70e-06fc-4d1f-862a-80bb569f07da}"),
        null,
        PlayReadyEncryptionAlgorithm.Unspecified,
        new Uri("http://www.contoso.com/rightsmanager.aspx"),
        null,
        null,
        new Guid("{215304E7-9263-446A-B150-0754D5E18973}"));

    var request = PlayReadyContentResolver.ServiceRequest(header);
    await request.BeginServiceRequest();
}
else
{
    // Application chooses behavior, for example, picks different content
    // or tells user that their system doesn’t support the selected content
}

적용 대상

PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)

PlayReadyContentHeader 클래스의 새 인스턴스를 초기화합니다.

public:
 PlayReadyContentHeader(unsigned int dwFlags, Platform::Array <Platform::Guid> ^ contentKeyIds, Platform::Array <Platform::String ^> ^ contentKeyIdStrings, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, Uri ^ licenseAcquisitionUrl, Uri ^ licenseAcquisitionUserInterfaceUrl, Platform::String ^ customAttributes, Platform::Guid domainServiceId);
 PlayReadyContentHeader(uint32_t const& dwFlags, winrt::array_view <winrt::guid> const& contentKeyIds, winrt::array_view <winrt::hstring const&> const& contentKeyIdStrings, PlayReadyEncryptionAlgorithm const& contentEncryptionAlgorithm, Uri const& licenseAcquisitionUrl, Uri const& licenseAcquisitionUserInterfaceUrl, winrt::hstring const& customAttributes, winrt::guid const& domainServiceId);
public PlayReadyContentHeader(uint dwFlags, Guid[] contentKeyIds, string[] contentKeyIdStrings, PlayReadyEncryptionAlgorithm contentEncryptionAlgorithm, System.Uri licenseAcquisitionUrl, System.Uri licenseAcquisitionUserInterfaceUrl, string customAttributes, Guid domainServiceId);
function PlayReadyContentHeader(dwFlags, contentKeyIds, contentKeyIdStrings, contentEncryptionAlgorithm, licenseAcquisitionUrl, licenseAcquisitionUserInterfaceUrl, customAttributes, domainServiceId)
Public Sub New (dwFlags As UInteger, contentKeyIds As Guid(), contentKeyIdStrings As String(), contentEncryptionAlgorithm As PlayReadyEncryptionAlgorithm, licenseAcquisitionUrl As Uri, licenseAcquisitionUserInterfaceUrl As Uri, customAttributes As String, domainServiceId As Guid)

매개 변수

dwFlags
UInt32

unsigned int

uint32_t

예약되어 있습니다. 0으로 설정합니다.

contentKeyIds

Guid[]

Platform::Guid[]

winrt::guid[]

콘텐츠 암호화 키의 식별자입니다.

contentKeyIdStrings

String[]

Platform::String[]

winrt::hstring[]

콘텐츠 키의 문자열 표현입니다. 각 문자열은 Base-64로 인코딩된 16 바이트 값이어야 합니다.

contentEncryptionAlgorithm
PlayReadyEncryptionAlgorithm

콘텐츠를 암호화하는 데 사용되는 암호화 알고리즘 유형입니다.

licenseAcquisitionUrl
Uri Uri

자동(사용자 상호 작용 없음) 라이선스 취득 웹 서비스에 대한 URL입니다.

licenseAcquisitionUserInterfaceUrl
Uri Uri

비사일 라이선스 취득 웹 페이지의 URL입니다.

customAttributes
String

Platform::String

winrt::hstring

콘텐츠 공급자가 사용하는 사용자 지정 데이터를 포함합니다. 콘텐츠 작성자가 이 요소 내에 임의의 XML을 추가할 수 있습니다. Microsoft 코드는 이 요소 내에 포함된 데이터에 대해 아무 작업도 수행하지 않습니다.

domainServiceId
Guid

Platform::Guid

winrt::guid

도메인 서비스에 대한 서비스 식별자입니다.

설명

contentKeyIdsdomainServiceId 매개 변수는 기본 플랫폼의 엔디언성에 민감합니다. 지원하려는 모든 플랫폼에서 앱을 신중하게 테스트하여 각 플랫폼에서 올바른 엔디언이 사용되는지 확인합니다.

Windows 10 버전 1709부터 AES128CBC 암호화의 경우 PlayReadyEncryptionAlgorithm.Aes128Cbc 또는 PlayReadyEncryptionAlgorithm.Unspecified를 지정하여 서버 백 엔드가 contentEncryptionAlgorithm 매개 변수의 값으로 암호화 형식을 확인할 수 있도록 할 수 있습니다. 이전 버전의 Windows 10 이러한 값 중 하나를 지정하면 예외가 throw됩니다. 따라서 생성자 호출에서 새 열거형 값을 사용하기 전에 ApiInformationIsApiContractPresent 를 호출하고 주 계약 버전 5를 지정하여 열거형 값이 있는지 확인해야 합니다.

bool supportsAes128CbcAndUnspecified = ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 5);

if (supportsAes128CbcAndUnspecified)
{
    // Guid and URL below are known by app, obtaining them is out of scope
    PlayReadyContentHeader header = new PlayReadyContentHeader(
        new Guid("{6591a70e-06fc-4d1f-862a-80bb569f07da}"),
        null,
        PlayReadyEncryptionAlgorithm.Unspecified,
        new Uri("http://www.contoso.com/rightsmanager.aspx"),
        null,
        null,
        new Guid("{215304E7-9263-446A-B150-0754D5E18973}"));

    var request = PlayReadyContentResolver.ServiceRequest(header);
    await request.BeginServiceRequest();
}
else
{
    // Application chooses behavior, for example, picks different content
    // or tells user that their system doesn’t support the selected content
}

적용 대상