PlayReadyContentHeader Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
PlayReadyContentHeader(Byte[]) |
Inicializa uma nova instância da classe PlayReadyContentHeader . |
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid) |
Inicializa uma nova instância da classe PlayReadyContentHeader . |
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Inicializa uma nova instância da classe PlayReadyContentHeader . |
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Inicializa uma nova instância da classe PlayReadyContentHeader. |
PlayReadyContentHeader(Byte[])
Inicializa uma nova instância da classe 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())
Parâmetros
- headerBytes
-
Byte[]
byte[]
Bytes de dados brutos que representam um cabeçalho de conteúdo PlayReady.
Aplica-se a
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)
Inicializa uma nova instância da classe 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)
Parâmetros
- headerBytes
-
Byte[]
byte[]
Bytes de dados brutos que representam um cabeçalho WMDRM herdado.
A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).
A URL de uma página da Web de aquisição de licença não silenciosa.
- customAttributes
-
String
Platform::String
winrt::hstring
Contém dados personalizados usados pelo provedor de conteúdo. O autor do conteúdo pode adicionar XML arbitrário dentro desse elemento. O código da Microsoft não atua em nenhum dado contido nesse elemento.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificador de serviço para o serviço de domínio.
Comentários
Esse construtor deve ser usado para converter um cabeçalho WMDRM herdado em um cabeçalho PlayReady.
O parâmetro domainServiceId é sensível à endianidade da plataforma subjacente. Teste cuidadosamente seu aplicativo em todas as plataformas às quais você pretende dar suporte para garantir que a endianidade correta seja usada em cada plataforma.
Aplica-se a
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Inicializa uma nova instância da classe 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)
Parâmetros
- contentKeyId
-
Guid
Platform::Guid
winrt::guid
Identificador da chave de criptografia de conteúdo.
- contentKeyIdString
-
String
Platform::String
winrt::hstring
Representação de cadeia de caracteres da chave de conteúdo. Se o parâmetro contentKeyId for especificado, esse parâmetro será ignorado.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Tipo de algoritmo de criptografia usado para criptografar o conteúdo.
A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).
A URL de uma página da Web de aquisição de licença não silenciosa.
- customAttributes
-
String
Platform::String
winrt::hstring
Contém dados personalizados usados pelo provedor de conteúdo. O autor do conteúdo pode adicionar XML arbitrário dentro desse elemento. O código da Microsoft não atua em nenhum dado contido nesse elemento.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificador de serviço para o serviço de domínio.
Comentários
Os parâmetros contentKeyId e domainServiceId são sensíveis à endianidade da plataforma subjacente. Teste cuidadosamente seu aplicativo em todas as plataformas às quais você pretende dar suporte para garantir que a endianidade correta seja usada em cada plataforma.
A partir do Windows 10, versão 1709, você pode especificar PlayReadyEncryptionAlgorithm.Aes128Cbc, para criptografia AES128CBC ou PlayReadyEncryptionAlgorithm.Unspecified, para permitir que o back-end do servidor determine o tipo de criptografia, como o valor do parâmetro contentEncryptionAlgorithm. Em versões anteriores do Windows 10, especificar um desses valores fará com que uma exceção seja gerada. Por esse motivo, você deve verificar a presença do valor de enumeração chamando ApiInformationIsApiContractPresent e especificando a versão principal do contrato 5 antes de usar os novos valores de enumeração na chamada do construtor.
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
}
Aplica-se a
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Inicializa uma nova instância da classe 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)
Parâmetros
- dwFlags
-
UInt32
unsigned int
uint32_t
Reservado. Defina como 0.
- contentKeyIds
-
Guid[]
Platform::Guid[]
winrt::guid[]
Identificadores das chaves de criptografia de conteúdo.
- contentKeyIdStrings
-
String[]
Platform::String[]
winrt::hstring[]
Representações de cadeia de caracteres das chaves de conteúdo. Cada cadeia de caracteres deve ser um valor de 16 bytes codificado em Base 64.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Tipo de algoritmo de criptografia usado para criptografar o conteúdo.
A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).
A URL de uma página da Web de aquisição de licença não silenciosa.
- customAttributes
-
String
Platform::String
winrt::hstring
Contém dados personalizados usados pelo provedor de conteúdo. O autor do conteúdo pode adicionar XML arbitrário dentro desse elemento. O código da Microsoft não atua em nenhum dado contido nesse elemento.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Identificador de serviço para o serviço de domínio.
Comentários
Os parâmetros contentKeyIds e domainServiceId são sensíveis à endianness da plataforma subjacente. Teste cuidadosamente seu aplicativo em todas as plataformas às quais você pretende dar suporte para garantir que a endianidade correta seja usada em cada plataforma.
A partir do Windows 10, versão 1709, você pode especificar PlayReadyEncryptionAlgorithm.Aes128Cbc, para criptografia AES128CBC ou PlayReadyEncryptionAlgorithm.Unspecified, para permitir que o back-end do servidor determine o tipo de criptografia, como o valor do parâmetro contentEncryptionAlgorithm. Em versões anteriores do Windows 10, especificar um desses valores fará com que uma exceção seja gerada. Por esse motivo, você deve verificar a presença do valor de enumeração chamando ApiInformationIsApiContractPresent e especificando a versão principal do contrato 5 antes de usar os novos valores de enumeração na chamada do construtor.
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
}