Поделиться через


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-код внутри этого элемента. Код Майкрософт не действует с данными, содержащимися в этом элементе.

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-код внутри этого элемента. Код Майкрософт не действует с данными, содержащимися в этом элементе.

domainServiceId
Guid

Platform::Guid

winrt::guid

Идентификатор службы для службы домена.

Комментарии

Параметры contentKeyId и domainServiceId чувствительны к эндианности базовой платформы. Тщательно протестируйте приложение на всех платформах, которые вы планируете поддерживать, чтобы убедиться, что на каждой платформе используется правильное байтовость.

Начиная с Windows 10 версии 1709, можно указать PlayReadyEncryptionAlgorithm.Aes128Cbc для шифрования AES128CBC или PlayReadyEncryptionAlgorithm.Unspecified, чтобы серверная часть сервера определяла тип шифрования в качестве значения параметра contentEncryptionAlgorithm. В предыдущих версиях Windows 10 указание любого из этих значений вызовет исключение. По этой причине необходимо проверить наличие значения перечисления, вызвав 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[]

Строковые представления ключей содержимого. Каждая строка должна быть 16-байтовым значением в кодировке Base-64.

contentEncryptionAlgorithm
PlayReadyEncryptionAlgorithm

Тип алгоритма шифрования, используемый для шифрования содержимого.

licenseAcquisitionUrl
Uri Uri

URL-адрес веб-службы автоматического получения лицензий (без взаимодействия с пользователем).

licenseAcquisitionUserInterfaceUrl
Uri Uri

URL-адрес веб-страницы, не являющейся автоматическим приобретением лицензии.

customAttributes
String

Platform::String

winrt::hstring

Содержит пользовательские данные, используемые поставщиком содержимого. Автор содержимого может добавить произвольный XML-код внутри этого элемента. Код Майкрософт не действует с данными, содержащимися в этом элементе.

domainServiceId
Guid

Platform::Guid

winrt::guid

Идентификатор службы для службы домена.

Комментарии

Параметры contentKeyIds и domainServiceId чувствительны к эндианности базовой платформы. Тщательно протестируйте приложение на всех платформах, которые вы планируете поддерживать, чтобы убедиться, что на каждой платформе используется правильное байтовость.

Начиная с Windows 10 версии 1709, можно указать PlayReadyEncryptionAlgorithm.Aes128Cbc для шифрования AES128CBC или PlayReadyEncryptionAlgorithm.Unspecified, чтобы серверная часть сервера определяла тип шифрования в качестве значения параметра contentEncryptionAlgorithm. В предыдущих версиях Windows 10 указание любого из этих значений вызовет исключение. По этой причине необходимо проверить наличие значения перечисления, вызвав 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
}

Применяется к