PlayReadyContentHeader Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| PlayReadyContentHeader(Byte[]) |
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse . |
| PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid) |
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse . |
| PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse . |
| PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse. |
PlayReadyContentHeader(Byte[])
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
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())Parameter
- headerBytes
-
Byte[]
byte[]
Rohdatenbytes, die einen PlayReady-Inhaltsheader darstellen.
Gilt für:
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
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)Parameter
- headerBytes
-
Byte[]
byte[]
Rohdatenbytes, die einen älteren WMDRM-Header darstellen.
Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).
Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.
- customAttributes
-
String
Platform::String
winrt::hstring
Enthält benutzerdefinierte Daten, die vom Inhaltsanbieter verwendet werden. Der Inhaltsautor kann diesem Element beliebige XML-Dateien hinzufügen. Microsoft-Code reagiert nicht auf Daten, die in diesem Element enthalten sind.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Dienstbezeichner für den Domänendienst.
Hinweise
Dieser Konstruktor sollte verwendet werden, um einen Legacy-WMDRM-Header in einen PlayReady-Header zu konvertieren.
Der domainServiceId-Parameter berücksichtigt die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.
Gilt für:
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse .
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)Parameter
- contentKeyId
-
Guid
Platform::Guid
winrt::guid
Bezeichner des Inhaltsverschlüsselungsschlüssels.
- contentKeyIdString
-
String
Platform::String
winrt::hstring
Zeichenfolgendarstellung des Inhaltsschlüssels. Wenn der parameter contentKeyId angegeben wird, wird dieser Parameter ignoriert.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Verschlüsselungsalgorithmustyp, der zum Verschlüsseln des Inhalts verwendet wird.
Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).
Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.
- customAttributes
-
String
Platform::String
winrt::hstring
Enthält benutzerdefinierte Daten, die vom Inhaltsanbieter verwendet werden. Der Inhaltsautor kann diesem Element beliebige XML-Dateien hinzufügen. Microsoft-Code reagiert nicht auf Daten, die in diesem Element enthalten sind.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Dienstbezeichner für den Domänendienst.
Hinweise
Die Parameter contentKeyId und domainServiceId sind empfindlich auf die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.
Ab Windows 10 Version 1709 können Sie PlayReadyEncryptionAlgorithm.Aes128Cbc für die AES128CBC-Verschlüsselung oder PlayReadyEncryptionAlgorithm.Unspecified angeben, damit das Server-Back-End den Verschlüsselungstyp als Wert für den Parameter contentEncryptionAlgorithm bestimmen kann. Wenn Sie in früheren Versionen von Windows 10 einen dieser Werte angeben, wird eine Ausnahme ausgelöst. Aus diesem Grund sollten Sie überprüfen, ob der Enumerationswert vorhanden ist, indem Sie ApiInformationIsApiContractPresent aufrufen und Hauptvertragsversion 5 angeben, bevor Sie die neuen Enumerationswerte im Konstruktoraufruf verwenden.
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
}
Gilt für:
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Initialisiert eine neue Instanz der PlayReadyContentHeader-Klasse.
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)Parameter
- dwFlags
-
UInt32
unsigned int
uint32_t
Reserviert. Auf 0 festlegen.
- contentKeyIds
-
Guid[]
Platform::Guid[]
winrt::guid[]
Bezeichner der Inhaltsverschlüsselungsschlüssel.
- contentKeyIdStrings
-
String[]
Platform::String[]
winrt::hstring[]
Zeichenfolgendarstellungen der Inhaltsschlüssel. Jede Zeichenfolge muss ein Base64-codierter 16-Byte-Wert sein.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Verschlüsselungsalgorithmustyp, der zum Verschlüsseln des Inhalts verwendet wird.
Die URL für den unbeaufsichtigten Lizenzerwerbswebdienst (keine Benutzerinteraktion).
Die URL für eine Webseite zum Erwerb einer nicht unbeaufsichtigten Lizenz.
- customAttributes
-
String
Platform::String
winrt::hstring
Enthält benutzerdefinierte Daten, die vom Inhaltsanbieter verwendet werden. Der Inhaltsautor kann diesem Element beliebige XML-Dateien hinzufügen. Microsoft-Code reagiert nicht auf Daten, die in diesem Element enthalten sind.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Dienstbezeichner für den Domänendienst.
Hinweise
Die Parameter contentKeyIds und domainServiceId sind empfindlich auf die Endianität der zugrunde liegenden Plattform. Testen Sie Ihre App sorgfältig auf allen Plattformen, die Sie unterstützen möchten, um sicherzustellen, dass auf jeder Plattform die richtige Endianität verwendet wird.
Ab Windows 10 Version 1709 können Sie PlayReadyEncryptionAlgorithm.Aes128Cbc für die AES128CBC-Verschlüsselung oder PlayReadyEncryptionAlgorithm.Unspecified angeben, damit das Server-Back-End den Verschlüsselungstyp als Wert für den Parameter contentEncryptionAlgorithm bestimmen kann. Wenn Sie in früheren Versionen von Windows 10 einen dieser Werte angeben, wird eine Ausnahme ausgelöst. Aus diesem Grund sollten Sie überprüfen, ob der Enumerationswert vorhanden ist, indem Sie ApiInformationIsApiContractPresent aufrufen und Hauptvertragsversion 5 angeben, bevor Sie die neuen Enumerationswerte im Konstruktoraufruf verwenden.
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
}
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für