PlayReadyContentHeader Konstruktor
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
PlayReadyContentHeader(Byte[]) |
Menginisialisasi instans baru kelas PlayReadyContentHeader . |
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid) |
Menginisialisasi instans baru kelas PlayReadyContentHeader . |
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Menginisialisasi instans baru kelas PlayReadyContentHeader . |
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid) |
Menginisialisasi instans baru kelas PlayReadyContentHeader. |
PlayReadyContentHeader(Byte[])
Menginisialisasi instans baru kelas 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())
Parameter
- headerBytes
-
Byte[]
byte[]
Byte data mentah yang mewakili header konten PlayReady.
Berlaku untuk
PlayReadyContentHeader(Byte[], Uri, Uri, String, Guid)
Menginisialisasi instans baru kelas 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)
Parameter
- headerBytes
-
Byte[]
byte[]
Byte data mentah yang mewakili header WMDRM warisan.
URL untuk layanan Web akuisisi lisensi senyap (tanpa interaksi pengguna).
- customAttributes
-
String
Platform::String
winrt::hstring
Berisi data kustom yang digunakan oleh penyedia konten. Pembuat konten dapat menambahkan XML arbitrer di dalam elemen ini. Kode Microsoft tidak bertindak pada data apa pun yang terkandung dalam elemen ini.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Pengidentifikasi layanan untuk layanan domain.
Keterangan
Konstruktor ini harus digunakan untuk mengonversi header WMDRM warisan ke header PlayReady.
Parameter domainServiceId sensitif terhadap keakuratan platform yang mendasar. Uji aplikasi Anda dengan hati-hati di semua platform yang ingin Anda dukung untuk memastikan bahwa endianness yang benar digunakan pada setiap platform.
Berlaku untuk
PlayReadyContentHeader(Guid, String, PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Menginisialisasi instans baru kelas 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)
Parameter
- contentKeyId
-
Guid
Platform::Guid
winrt::guid
Pengidentifikasi kunci enkripsi konten.
- contentKeyIdString
-
String
Platform::String
winrt::hstring
Representasi string kunci konten. Jika parameter contentKeyId ditentukan, maka parameter ini diabaikan.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Jenis algoritma enkripsi yang digunakan untuk mengenkripsi konten.
URL untuk layanan Web akuisisi lisensi senyap (tanpa interaksi pengguna).
- customAttributes
-
String
Platform::String
winrt::hstring
Berisi data kustom yang digunakan oleh penyedia konten. Pembuat konten dapat menambahkan XML arbitrer di dalam elemen ini. Kode Microsoft tidak bertindak pada data apa pun yang terkandung dalam elemen ini.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Pengidentifikasi layanan untuk layanan domain.
Keterangan
Parameter contentKeyId dan domainServiceId sensitif terhadap endianness platform yang mendasar. Uji aplikasi Anda dengan hati-hati di semua platform yang ingin Anda dukung untuk memastikan bahwa endianness yang benar digunakan pada setiap platform.
Dimulai dengan Windows 10, versi 1709, Anda dapat menentukan PlayReadyEncryptionAlgorithm.Aes128Cbc, untuk enkripsi AES128CBC, atau PlayReadyEncryptionAlgorithm.Unspecified, untuk memungkinkan backend server menentukan jenis enkripsi, sebagai nilai untuk parameter contentEncryptionAlgorithm. Pada versi Windows 10 sebelumnya, menentukan salah satu nilai ini akan menyebabkan pengecualian dilemparkan. Untuk alasan ini, Anda harus memeriksa keberadaan nilai enumerasi dengan memanggil ApiInformationIsApiContractPresent dan menentukan kontrak utama versi 5 sebelum menggunakan nilai enum baru dalam panggilan konstruktor.
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
}
Berlaku untuk
PlayReadyContentHeader(UInt32, Guid[], String[], PlayReadyEncryptionAlgorithm, Uri, Uri, String, Guid)
Menginisialisasi instans baru kelas 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)
Parameter
- dwFlags
-
UInt32
unsigned int
uint32_t
Dicadangkan. Atur ke 0.
- contentKeyIds
-
Guid[]
Platform::Guid[]
winrt::guid[]
Pengidentifikasi kunci enkripsi konten.
- contentKeyIdStrings
-
String[]
Platform::String[]
winrt::hstring[]
Representasi string kunci konten. Setiap string harus berupa nilai 16 byte yang dikodekan Base-64.
- contentEncryptionAlgorithm
- PlayReadyEncryptionAlgorithm
Jenis algoritma enkripsi yang digunakan untuk mengenkripsi konten.
URL untuk layanan Web akuisisi lisensi senyap (tanpa interaksi pengguna).
- customAttributes
-
String
Platform::String
winrt::hstring
Berisi data kustom yang digunakan oleh penyedia konten. Pembuat konten dapat menambahkan XML arbitrer di dalam elemen ini. Kode Microsoft tidak bertindak pada data apa pun yang terkandung dalam elemen ini.
- domainServiceId
-
Guid
Platform::Guid
winrt::guid
Pengidentifikasi layanan untuk layanan domain.
Keterangan
Parameter contentKeyIds dan domainServiceId sensitif terhadap endianness platform yang mendasar. Uji aplikasi Anda dengan hati-hati di semua platform yang ingin Anda dukung untuk memastikan bahwa endianness yang benar digunakan pada setiap platform.
Dimulai dengan Windows 10, versi 1709, Anda dapat menentukan PlayReadyEncryptionAlgorithm.Aes128Cbc, untuk enkripsi AES128CBC, atau PlayReadyEncryptionAlgorithm.Unspecified, untuk memungkinkan backend server menentukan jenis enkripsi, sebagai nilai untuk parameter contentEncryptionAlgorithm. Pada versi Windows 10 sebelumnya, menentukan salah satu nilai ini akan menyebabkan pengecualian dilemparkan. Untuk alasan ini, Anda harus memeriksa keberadaan nilai enumerasi dengan memanggil ApiInformationIsApiContractPresent dan menentukan kontrak utama versi 5 sebelum menggunakan nilai enum baru dalam panggilan konstruktor.
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
}