Partilhar via


PlayReadyContentHeader Construtores

Definição

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.

licenseAcquisitionUrl
Uri Uri

A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).

licenseAcquisitionUserInterfaceUrl
Uri Uri

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.

licenseAcquisitionUrl
Uri Uri

A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).

licenseAcquisitionUserInterfaceUrl
Uri Uri

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.

licenseAcquisitionUrl
Uri Uri

A URL do serviço Web de aquisição de licença silenciosa (sem interação do usuário).

licenseAcquisitionUserInterfaceUrl
Uri Uri

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
}

Aplica-se a