Partager via


PlayReadyContentHeader Constructeurs

Définition

Surcharges

PlayReadyContentHeader(Byte[])

Initialise une nouvelle instance de la classe PlayReadyContentHeader .

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

Initialise une nouvelle instance de la classe PlayReadyContentHeader .

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

Initialise une nouvelle instance de la classe PlayReadyContentHeader .

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

Initialise une nouvelle instance de la classe PlayReadyContentHeader.

PlayReadyContentHeader(Byte[])

Initialise une nouvelle instance de la 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())

Paramètres

headerBytes

Byte[]

byte[]

Octets de données brutes représentant un en-tête de contenu PlayReady.

S’applique à

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

Initialise une nouvelle instance de la 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)

Paramètres

headerBytes

Byte[]

byte[]

Octets de données brutes représentant un en-tête WMDRM hérité.

licenseAcquisitionUrl
Uri Uri

URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).

licenseAcquisitionUserInterfaceUrl
Uri Uri

URL d’une page Web d’acquisition de licence non silencieuse.

customAttributes
String

Platform::String

winrt::hstring

Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.

domainServiceId
Guid

Platform::Guid

winrt::guid

Identificateur de service pour le service de domaine.

Remarques

Ce constructeur doit être utilisé pour convertir un en-tête WMDRM hérité en en-tête PlayReady.

Le paramètre domainServiceId est sensible à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.

S’applique à

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

Initialise une nouvelle instance de la 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)

Paramètres

contentKeyId
Guid

Platform::Guid

winrt::guid

Identificateur de la clé de chiffrement de contenu.

contentKeyIdString
String

Platform::String

winrt::hstring

Représentation sous forme de chaîne de la clé de contenu. Si le paramètre contentKeyId est spécifié, ce paramètre est ignoré.

contentEncryptionAlgorithm
PlayReadyEncryptionAlgorithm

Type d’algorithme de chiffrement utilisé pour chiffrer le contenu.

licenseAcquisitionUrl
Uri Uri

URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).

licenseAcquisitionUserInterfaceUrl
Uri Uri

URL d’une page Web d’acquisition de licence non silencieuse.

customAttributes
String

Platform::String

winrt::hstring

Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.

domainServiceId
Guid

Platform::Guid

winrt::guid

Identificateur de service pour le service de domaine.

Remarques

Les paramètres contentKeyId et domainServiceId sont sensibles à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.

À compter de Windows 10, version 1709, vous pouvez spécifier PlayReadyEncryptionAlgorithm.Aes128Cbc, pour le chiffrement AES128CBC, ou PlayReadyEncryptionAlgorithm.Unspecified, pour permettre au serveur principal de déterminer le type de chiffrement, comme valeur du paramètre contentEncryptionAlgorithm. Dans les versions précédentes de Windows 10, la spécification de l’une de ces valeurs entraîne la levée d’une exception. Pour cette raison, vous devez vérifier la présence de la valeur d’énumération en appelant ApiInformationIsApiContractPresent et en spécifiant la version de contrat principal 5 avant d’utiliser les nouvelles valeurs d’énumération dans l’appel du constructeur.

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
}

S’applique à

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

Initialise une nouvelle instance de la 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)

Paramètres

dwFlags
UInt32

unsigned int

uint32_t

Réservé. Définit la valeur 0.

contentKeyIds

Guid[]

Platform::Guid[]

winrt::guid[]

Identificateurs des clés de chiffrement de contenu.

contentKeyIdStrings

String[]

Platform::String[]

winrt::hstring[]

Représentations sous forme de chaîne des clés de contenu. Chaque chaîne doit être une valeur codée en base 64 de 16 octets.

contentEncryptionAlgorithm
PlayReadyEncryptionAlgorithm

Type d’algorithme de chiffrement utilisé pour chiffrer le contenu.

licenseAcquisitionUrl
Uri Uri

URL du service Web d’acquisition de licence silencieux (sans interaction utilisateur).

licenseAcquisitionUserInterfaceUrl
Uri Uri

URL d’une page Web d’acquisition de licence non silencieuse.

customAttributes
String

Platform::String

winrt::hstring

Contient des données personnalisées utilisées par le fournisseur de contenu. L’auteur du contenu peut ajouter du code XML arbitraire à l’intérieur de cet élément. Le code Microsoft n’agit pas sur les données contenues dans cet élément.

domainServiceId
Guid

Platform::Guid

winrt::guid

Identificateur de service pour le service de domaine.

Remarques

Les paramètres contentKeyIds et domainServiceId sont sensibles à l’endianness de la plateforme sous-jacente. Testez soigneusement votre application sur toutes les plateformes que vous envisagez de prendre en charge pour vous assurer que l’endianness correct est utilisé sur chaque plateforme.

À compter de Windows 10, version 1709, vous pouvez spécifier PlayReadyEncryptionAlgorithm.Aes128Cbc, pour le chiffrement AES128CBC, ou PlayReadyEncryptionAlgorithm.Unspecified, pour permettre au serveur principal de déterminer le type de chiffrement, comme valeur du paramètre contentEncryptionAlgorithm. Dans les versions précédentes de Windows 10, la spécification de l’une de ces valeurs entraîne la levée d’une exception. Pour cette raison, vous devez vérifier la présence de la valeur d’énumération en appelant ApiInformationIsApiContractPresent et en spécifiant la version de contrat principal 5 avant d’utiliser les nouvelles valeurs d’énumération dans l’appel du constructeur.

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
}

S’applique à