Documentatie voor syntaxis van queryreeks

Parameters worden ingevoerd in de querytekenreeks, gescheiden door komma's en vierkante haken. Deze syntaxis is in 2017 geïntroduceerd ter volledige ondersteuning van PlayReady 3-functies:

• Vergelijkbaar met een JSON-syntaxis (niet echte JSON)
• Gemakkelijk te lezen en te bewerken
• Bevat geen onveilige tekens (zoals ampersand) en mag geen escape-tekens vereisen
• Opmerking: de querytekenreeks mag geen spatietekens bevatten (' ')
• Opmerking: +-tekens zijn acceptabel in de met base64 gecodeerde argumenten
• Hiermee kunt u aanvragen voor meerdere licenties in één licentieantwoord aanvragen en parameters instellen voor elk van deze licenties.
• Voorbeeld: videotrack versleuteld met één sleutelset op SL3000 en audiospoor versleuteld met een andere sleutelset op SL2000.
• Nieuwe datum/tijdnotatie jjjjmmdd (bijvoorbeeld: 20171231) en stelt uren, minuten en seconden in: jjjjmmdd[uummss] (bijvoorbeeld: 20171231235959)

Opmerking: de parameters moeten persistent:true bevatten als u permanente licenties wilt ontvangen.

Voorbeelden

LAURL (https://test.playready.microsoft.com/service/)	Description
rightsmanager.asmx	Retourneer één niet-permanente licentie met een PLAY-recht en een beveiligingsniveau van 150 voor de jongen die in de WRMHEADER is gevonden, met behulp van de Test Key Seed
rightsmanager.asmx?cfg=(ckt:aescbc)	NIEUW IN PLAYREADY 4.0. Retourneer één niet-permanente licentie met een PLAY-recht voor de jongen die in de WRMHEADER is gevonden, met een inhoudssleuteltype dat is ingesteld voor AESCBC-versleuteling (in tegenstelling tot AESCTR)
rightsmanager.asmx?cfg=(begindate:20170101,expiration:20170101010000)	Retourneer één niet-permanente licentie met een PLAY-recht voor het kind dat is gevonden in de WRMHEADER, met behulp van de Test Key Seed, met een begindatum van 1 januari 2017 0:00 en een vaste vervaldatum van 1 januari 2017 1:00 uur
rightsmanager.asmx?cfg=(persist:true,begindate:20170101,expiration:20170201,firstexp:60)	Retourneer één permanente licentie met vaste begin- en einddatums en een relatieve vervaldatum van 60 seconden na het eerste afspelen. Opmerking: u moet persistent:true expliciet aanroepen om permanente licenties te ontvangen.
rightsmanager.asmx?cfg=(kid:B6E39626-1CFB-4AA1-BCBD-4EF1ABA7843A,sl:3000),(kid:7C9484BA-C238-467A-869C-CDD8C7167712,sl:2000)	Retourneer twee niet-permanente licenties met PLAY-rechten, één met een beveiligingsniveau van 3000, één met een beveiligingsniveau van 2000. Opmerking: deze twee KID's moeten overeenkomen met de KID's in de WRMHEADER

Parameterwaarden

Kenmerk	Meaning	Waarden	Opmerkingen, voorbeelden, standaardwaarde
Sl	Het minimale beveiligingsniveau voor een licentie instellen	150, 2000, 3000	Voorbeeld: sl:3000 De standaardwaarde is 150. Opmerking: de videosleutel kan worden ingesteld op sl:3000, maar in het algemeen ondersteunen clients alleen audiotoetsen die moeten worden ingesteld op sl:2000 maximum
keyseed	De opgegeven sleutel seed gebruiken om de inhoudssleutel in de licenties te genereren	base64 bytematrix	Voorbeeld: keyseed:Wdkg2jsl3djgqSFer26XVBoVVRPzVEggUOSKSQaz De standaardwaarde is de Test Key Seed die hier wordt opgegeven
geitje	Wordt gebruikt in een groep eigenschappen om deze eigenschappen te koppelen aan één KID	'header' of guid in registerindeling of base64-tekenreeks	Voorbeeld 1: kid:header Voorbeeld 2: kid:e13a7861-d8cc-4284-9245-7c835ebde9f0 Voorbeeld 3: kid:YXg64czYhEKSRXyDXr3p8A== In het geval van kid:header gebruikt de licentieserver de KID die is gevonden in de WRMHEADER die samen met de licentieaanvraag wordt geleverd. In dit geval moet de WRMHEADER slechts één KID bevatten
contentkey	De inhoudssleutel instellen	base64 bytematrix	Voorbeeld: contentkey:eNqVnXrElmo2NSsn7IXeEA== De standaardwaarde is sleutel (TestKeySeed, kind)
ckt	Hiermee geeft u het type inhoudssleutelversleuteling (CTR of CBC) op	aesctr, aescbc	Voorbeeld: ckt:aescbc Standaardwaarde is aesctr De licentie bevat een inhoudssleutelset voor AESCBC-versleuteling NIEUW IN PLAYREADY 4.0
Tijd	Een TransactionId instellen in het licentieantwoord	guid (willekeurig)	Voorbeeld: tid:3033E8F0-FB1B-4170-AD5C-60549AAB2C79 Voegt de opgegeven waarde toe aan de eigenschap LicenseResponse.TransactionId, waarvoor de client een licentiebevestigingsvraag moet plaatsen met behulp van de opgegeven transactie-id terug naar de licentieserver
toneelschrijver	Een afspeelrecht toevoegen	onwaar, waar	Voorbeeld: playright:true De standaardwaarde is waar Opmerking: een licentie die zonder recht wordt geretourneerd, staat de client niet toe de inhoud te gebruiken
leesrecht	Een leesrecht toevoegen	onwaar, waar	Voorbeeld: leesrecht:true De standaardwaarde is onwaar
executeright	Een uitvoering rechts toevoegen	onwaar, waar	Voorbeeld: executeright:true De standaardwaarde is onwaar
extendedright	Een uitgebreide rechter toevoegen	Geheel getal. Zie het voorbeeld	Voorbeeld: (extendedright:(type:500,extended:((type:400, mustunderstand:true,besteffort:false,data:Ah==)))
Blijven bestaan	De licentie instellen als permanent of niet	onwaar, waar	Voorbeeld: persistent:true De standaardwaarde is onwaar. Als de licentie niet permanent is ingesteld, wordt deze alleen op de client opgeslagen in ram-geheugen, in de context van de mediaspeler.
simple	Een SimpleNonPersistentLicense gebruiken	onwaar, waar	Voorbeeld: simple:true De standaardwaarde is onwaar. Gebruikt een specifieke SimpleNonPersistentLicense-klasse om het licentieantwoord uit te geven. Deze klasse werd ondersteund in oudere versies van Silverlight.
begindatum	Een datum en tijd instellen waarvoor de licentie is uitgeschakeld	yyyymmdd[hhmmss] (GMT)	Voorbeeld: begindate:20170101 De licentie staat afspelen niet toe vóór 1 januari 2017 00:00:00 GMT
einddatum of vervaldatum	Een datum en tijd instellen waarna de licentie is uitgeschakeld	yyyymmdd[hhmmss] (GMT)	Voorbeeld 1: enddate:20170131 Voorbeeld 2: enddate:20170131235959 - De licentie staat afspelen na 31 januari 2017 23:59:59 GMT niet toe
firstplayexpiration of firstexp	Een relatieve vervaldatum instellen na het eerste afspelen	seconden in geheel getal	Voorbeeld: firstexp:60 De licentie staat niet toe dat een playback exact 60 seconden wordt gestart nadat een eerste afspeeltaak met diezelfde licentie is gestart.
realtime	Een vervalbeperking voor realtime toevoegen	onwaar, waar	Voorbeeld: realtime:true De standaardwaarde is onwaar Als deze eigenschap is ingesteld, moet de client vervaldatums afdwingen tijdens een afspeelsessie in realtime. Opmerking: dit wordt alleen ondersteund door PlayReady 3-clients
removaldate	Een datum instellen waarop de licentie kan worden verwijderd op client (GMT)	yyyymmdd[uummss]	Voorbeeld: removaldate:20170228 Houd er rekening mee dat het optioneel is voor clients om licenties te verwijderen op basis van deze eigenschap. Windows voert dit verwijderingsproces echter uit bij elke licentieverwerving. Zie de Documentatie voor de Server SDK voor aanvullende beperkingen voor het instellen van deze eigenschap.
isroot	Vereist dat de aangevraagde licentie een basislicentie is met de gedefinieerde root KID	onwaar, waar	Voorbeeld: cfg=(isroot:true,kid:3C6F3C13-6207-4916-867C-8252B3993638)
rootid	De basis-KID instellen voor een leaf-licentie	Richtlijn	Voorbeeld: cfg=(rootid:3C6F3C13-6207-4916-867C-8252B3993638,kid:header),(isroot:true,kid:3C6F3C13-6207-4916-867C-8252B3993638)
sourceid	De beperking bron-id of beperkte bron-id instellen	int	Voorbeeld: sourceid:267 Controleer de toegestane waarden in de sectie CR's 6.12
caopl	Een beperking voor het beveiligingsniveau voor gecomprimeerde digitale audio-uitvoer instellen	integer	Voorbeeld: caopl:200 De standaardwaarde is 0 Normaal gesproken is beveiligde audiostuurprogramma's vereist voor gecomprimeerde audio. Controleer de toegestane waarden in de sectie CR's 6.7 en 3.6.2 Server-SDK-code: right.CompressedDigitalAudioOPL = 200;
ucaopl	Een beperking voor het beveiligingsniveau Voor niet-gecomprimeerde digitale audio-uitvoer instellen	integer	Voorbeeld: ucaopl:300 De standaardwaarde is 0 Normaal gesproken is HDCP of DTCP vereist voor niet-gecomprimeerde audio. Controleer de toegestane waarden in de sectie CR's 6.7 en 3.6.3 Server-SDK-code: right.UncompressedDigitalAudioOPL = 300;
cvopl	Een beperking voor het beveiligingsniveau voor gecomprimeerde digitale video-uitvoer instellen	integer	Voorbeeld: cvopl:500 Alle toegestane waarden hebben dezelfde betekenis dat een PlayReady-product het videogedeelte van gecomprimeerde ontsleutelde inhoud niet mag doorgeven aan een video-uitvoer. Controleer de toegestane waarden in de sectie CR's 6.7 en 3.6.4 Server-SDK-code: right.CompressedDigitalVideoOPL = 500;
ucvopl	Een beperking voor het beveiligingsniveau voor niet-gecomprimeerde digitale video-uitvoer instellen	integer	Voorbeeld: ucvopl:300 De standaardwaarde is 0 Normaal gesproken moet HDCP op HDMI zijn vereist voor niet-gecomprimeerde video. Controleer de toegestane waarden in de sectie CR's 6.7 en 3.6.5 Server-SDK-code: right.UncompressedDigitalVideoOPL = 300;
avopl	Een beperking voor het beveiligingsniveau voor analoge video-uitvoer instellen	integer	Voorbeeld: avopl:200 vereisen CGMS-A kopie nooit Controleer de toegestane waarden in de sectie CR's 6.7 en 3.6.6 Server-SDK-code: right.AnalogVideoOPL = 200;
dvop	Een expliciete digitale video-uitvoerbeveiliging toevoegen	guid en optionele gegevens die zijn gecodeerd in base 64-tekenreeks	Voorbeeld: dvop:(guid:ABB2C6F1-E663-4625-A945-972D17B231E7,data:AAAAAQ==) om HDCP-type 1 te vereisen. Zie de sectie CR's 3.6.5.7. Server-SDK-code: right.AddDigitalVideoOutputProtection(new Guid("", 1))
daop	Een expliciete digitale audio-uitvoerbeveiliging toevoegen	guid en optionele gegevens die zijn gecodeerd in base 64-tekenreeks	Voorbeeld: daop:(guid:6D5CFA59-C250-4426-930E-FAC72C8FCFA6,data:AAAAAQ==) om SCMS te vereisen. Zie de sectie CR's 3.6.3.8. Server-SDK-code: right.AddDigitalAudioOutputProtection(new Guid("{6D5CFA59-C250-4426-930E-FAC72C8FCFA6}", 1))
avop	Een expliciete analoge video-uitvoerbeveiliging toevoegen	guid en gegevens die zijn gecodeerd in base 64-tekenreeks	Voorbeeld: avop:(guid:760AE755-682A-41E0-B1B3-DCDF836A7306,data:AAAAAQ==) naar Controleer de toegestane waarden in de sectie CR's 6.5. Server-SDK-code: right.AddAnalogVideoOutputProtection(new Guid("{760AE755-682A-41E0-B1B3-DCDF836A7306}", 1)
uitgebreide beperkingen	Een of meer uitgebreide beperkingen aan de rechterkant toevoegen	geheel getal en eigenschappen, zie voorbeeld	Voorbeeld: (extendedrestrictions:((type:400, mustunderstand:true,besteffort:false,data:Ah==),(type:401, mustunderstand:true,besteffort:false,data:Ah==))) Wordt ervan uitgegaan dat dit van toepassing is op het Play-recht als er geen ander recht is ingesteld.
playenablers	Een of meerdere Play Enablers toevoegen aan de licentie	guid of groep guids	Voorbeeld 1: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7) (onbekende uitvoer toestaan). Voorbeeld 2: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7,5ABF0F0D-DC29-4B82-9982-FD8E57525BFC) (onbekende uitvoer en AirPlay toestaan). Zie de CA's voor alle Play Enablers.
			De onderstaande parameters zijn afkortingen voor bepaalde combinaties van beperkingen en play enablers die hierboven worden beschreven
explicitacp	Een beperking voor automatische versterkingsbesturingselement en kleurstreep instellen voor analoge video	geheel getal 0,1,2,3	Voorbeeld: explicitacp:2 Equivalent aan: avop(guid:C3FD11C6-F8B7-4D20-B008-1DB17D61F2DA,data:AgAAAA==) Zie de sectie CR's 6.5.1 en 3.6.7.2. Server-SDK-code: right.AddAnalogVideoOutputProtection(new ExplicitOutputProtection(new Guid("C3FD11C6-F8B7-4D20-B008-1DB17D61F2DA"), HeightBytes.Concat(WidthBytes).ToArray()))
maxres	Een beperking voor maximale effectieve resolutiedecodeergrootte instellen	geheel getal x geheel getal	Voorbeeld: maxres:1920x1080 Equivalent aan: dvop:(guid:9645E831-E01D-4FFF-8342-0A720E3E028F,data:AAAEOAAAB4A=) Zie de sectie CR's 6.5 en 3.6.5.7.1. Server-SDK-code: right.AddDigitalVideoOutputProtection(new ExplicitOutputProtection(new Guid("9645E831-E01D-4FFF-8342-0A720E3E028F"), BitConverter.GetBytes((int)value))
allowunknownsd	Een uitvoerbesturingselement voor onbekende uitvoer toevoegen voor beperkte resolutie	onwaar, waar	Voorbeeld: allowunknownsd:true Equivalent aan: playenablers:(B621D91F-EDCC-4035-8D4B-DC71760D43E9) Zie de sectie CR's 3.9.2. Server-SDK-code: right.AddPlayEnabler(new PlayEnabler(new Guid("B621D91F-EDCC-4035-8D4B-DC71760D43E9")))
allowunknownhd	Een uitvoerbeheer voor onbekende uitvoer toevoegen voor een resolutie	onwaar, waar	Voorbeeld: allowunknownhd:true Equivalent aan: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7) Zie de sectie CR's 3.9.1. Server-SDK-code: right.AddPlayEnabler(new PlayEnabler(new Guid("786627D8-C2A6-44BE-8F88-08AE255B01A7")))
clientinfo			Speciale weerspiegelingsfunctie. Zie deze pagina voor meer informatie.