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.
URL-адрес веб-службы автоматического получения лицензий (без взаимодействия с пользователем).
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
Тип алгоритма шифрования, используемый для шифрования содержимого.
URL-адрес веб-службы автоматического получения лицензий (без взаимодействия с пользователем).
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
Тип алгоритма шифрования, используемый для шифрования содержимого.
URL-адрес веб-службы автоматического получения лицензий (без взаимодействия с пользователем).
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
}