Sorgu Dizesi Söz Dizimi Belgeleri

Parametreler sorgu dizesine virgül ve köşeli ayraçlarla ayrılmış olarak girilir. Bu söz dizimi, PlayReady 3 işlevlerini tam olarak desteklemek için 2017'de kullanıma sunulmuştur:

• JSON söz dizimine benzer (yine de gerçek JSON değil)
• Okuması ve düzenlemesi kolay
• Güvenli olmayan karakterler (ve işareti gibi) içermez ve bunlardan herhangi birinin kaçmasını gerektirmemelidir
• Not: Sorgu dizesi boşluk karakteri içermemelidir (' ')
• Not: '+' karakterleri base64 kodlanmış bağımsız değişkenlerinde kabul edilebilir
• Tek bir lisans yanıtında birden çok lisans isteğinde bulunmaya ve her biri için parametreler ayarlamaya olanak tanır.
• Örnek: SL3000'de bir anahtar kümesiyle şifrelenmiş video izleme ve SL2000'de başka bir anahtar kümesiyle şifrelenmiş ses parçası.
• Yeni tarih saat biçimi yyyymmdd (örnek: 20171231) ve ayar saatlerine, dakikalara ve saniyelere izin verir: yyyymmdd[hhmmss] (örnek: 20171231235959)

Not: Kalıcı lisanslar almak istiyorsanız parametrelerin persist:true değerini içermesi gerekir.

Örnekler

LAURL (https://test.playready.microsoft.com/service/)	Description
rightsmanager.asmx	Test Anahtarı Tohumunu kullanarak WRMHEADER'da bulunan çocuk için PLAY hakkı ve Güvenlik Düzeyi 150 olan kalıcı olmayan bir lisans döndürün
rightsmanager.asmx?cfg=(ckt:aescbc)	PLAYREADY 4.0'DA YENİ. WRMHEADER'da bulunan çocuk için PLAY hakkı olan ve AESCBC şifrelemesi için ayarlanmış içerik anahtarı türüne sahip kalıcı olmayan bir lisans döndürün (AESCTR'nin aksine)
rightsmanager.asmx?cfg=(begindate:20170101,expiration:20170101010000)	1 Ocak 2017 0:00 başlangıç tarihi ve 1 Ocak 2017 01:00 ile Test Anahtarı Tohumunu kullanarak WRMHEADER'da bulunan çocuk için PLAY hakkı olan kalıcı olmayan bir lisans döndürün
rightsmanager.asmx?cfg=(persist:true,begindate:20170101,expiration:20170201,firstexp:60)	Sabit başlangıç ve bitiş tarihleriyle ve ilk yürütmeden sonra 60 saniyelik göreli süre sonuyla bir kalıcı lisans döndürür. Not: Kalıcı lisansları almak için persist:true öğesini açıkça çağırmanız gerekir.
rightsmanager.asmx?cfg=(kid:B6E39626-1CFB-4AA1-BCBD-4EF1ABA7843A,sl:3000),(kid:7C9484BA-C238-467A-869C-CDD8C7167712,sl:2000)	Play haklarına sahip, biri Güvenlik Düzeyi 3000, diğeri Güvenlik Düzeyi 2000 olan iki kalıcı olmayan lisans döndürür. Not: Bu iki KID, WRMHEADER'daki KID'lerle eşleşmelidir

Parametreler

Parametre	Anlamı	Değerler	Açıklamalar, Örnekler, Varsayılan Değer
Sl	Lisans için En Düşük Güvenlik Düzeyini ayarlama	150, 2000, 3000	Örnek: sl:3000 Varsayılan değer 150'dir. Not: Video tuşu sl:3000 olarak ayarlanabilir, ancak genel olarak istemciler yalnızca sl:2000 maksimum olarak ayarlanacak ses anahtarlarını destekler
anahtarlı	Lisanslarda içerik anahtarı oluşturmak için sağlanan anahtar tohumunu kullanın	base64 bayt dizisi	Örnek: keyseed:Wdkg2jsl3djgqSFer26XVBoVVRPzVEggUOSKSQaz Varsayılan değer, burada sağlanan Test Anahtarı Tohumu'dur
çocuk	Bu özellikleri tek bir KID ile ilişkilendirmek için bir özellik grubunda kullanılır	Kayıt defteri biçiminde veya base64 dizesinde 'header' veya Guid	Örnek 1: kid:header Örnek 2: kid:e13a7861-d8cc-4284-9245-7c835ebde9f0 Örnek 3: kid:YXg64czYhEKSRXyDXr3p8A== kid:header durumunda lisans sunucusu, lisans isteğiyle birlikte gelen WRMHEADER'da bulunan KID'yi kullanır. Bu durumda WRMHEADER yalnızca bir ÇOCUK içermelidir
contentkey	İçerik anahtarını ayarlama	base64 bayt dizisi	Örnek: contentkey:eNqVnXrElmo2NSsn7IXeEA== Varsayılan değer key(TestKeySeed, kid)
ckt	İçerik Anahtarı Şifreleme Türünü (CTR veya CBC) belirtir	aesctr , aescbc	Örnek: ckt:aescbc Varsayılan değer aesctr'dir Lisans, AESCBC şifrelemesi için bir içerik anahtarı kümesi içerir PLAYREADY 4.0'DA YENİ
Tid	Lisans yanıtında TransactionId ayarlama	guid (rastgele)	Örnek: tid:3033E8F0-FB1B-4170-AD5C-60549AAB2C79 Sağlanan değeri LicenseResponse.TransactionId özelliğine ekler. Bu özellik, istemcinin belirtilen işlem tanımlayıcısını kullanarak lisans sunucusuna bir lisans onaylama sınaması göndermesini gerektirir
oyun hakkı	Yürütme Hakkı Ekle	yanlış, doğru	Örnek: playright:true Varsayılan değer true Not: Hakkı olmayan bir şekilde döndürülen lisans, istemcinin içeriği kullanmasına izin vermez
salt okunur	Sağa Okuma Ekleme	yanlış, doğru	Örnek: readright:true Varsayılan değer false
executeright	Yürütme Hakkı Ekleme	yanlış, doğru	Örnek: executeright:true Varsayılan değer false
genişletilmiş hakkı	Genişletilmiş Sağ Ekleme	Tam sayı. Örne bakın	Örnek: (extendedright:(type:500,extended:((type:400, mustunderstand:true,besteffort:false,data:Ah==)))
Devam ettirmek	Lisansı Kalıcı veya Değil olarak ayarlama	yanlış, doğru	Örnek: persist:true Varsayılan değer yanlış'tır. Lisans kalıcı olmayan olarak ayarlanırsa, medya yürütücüsü bağlamında yalnızca RAM'de istemcide depolanır.
simple	SimpleNonPersistentLicense kullanma	yanlış, doğru	Örnek: simple:true Varsayılan değer yanlış'tır. Lisans yanıtını vermek için belirli bir SimpleNonPersistentLicense sınıfını kullanır. Bu sınıf Silverlight'ın eski sürümlerinde destekleniyordu.
başlangıç tarihi	Lisansın devre dışı bırakıldığı tarih ve saati ayarlama	yyyymmdd[hhmmss] (GMT)	Örnek: begindate:20170101 Lisans, 1 Ocak 2017 00:00:00 GMT'den önce oynatılmaya izin vermez
bitiş tarihi veya süre sonu	Lisansın devre dışı bırakıldığı tarih ve saati ayarlama	yyyymmdd[hhmmss] (GMT)	Örnek 1: enddate:20170131 Örnek 2: enddate:20170131235959 - Lisans 31 Ocak 2017 23:59:59 GMT'den sonra oynatılmaya izin vermez
firstplayexpiration veya firstexp	İlk yürütmeden sonra göreli süre sonu ayarlama	tamsayı olarak saniye	Örnek: firstexp:60 Lisans, aynı lisansla ilk kayıttan yürütme başlatıldıktan tam 60 saniye sonra kayıttan yürütme başlatmaya izin vermez.
Gerçek zamanlı	Gerçek Zamanlı süre sonu kısıtlaması ekleme	yanlış, doğru	Örnek: realtime:true Varsayılan değer false Bu özellik ayarlanırsa, istemci tarafından bir kayıttan yürütme oturumu sırasında gerçek zamanlı süre sonu zorlaması gerekir. Not: Bu yalnızca PlayReady 3 istemcileri tarafından desteklenir
kaldırma tarihi	lisansın istemcide silinebileceği bir tarih ayarlama (GMT)	yyyymmdd[hhmmss]	Örnek: removaldate:20170228 İstemcilerin bu özelliğe göre lisansları kaldırmalarının isteğe bağlı olduğunu unutmayın. Ancak Windows bu kaldırma işlemini her lisans alımında çalıştırır. Bu özelliği ayarlamayla ilgili ek kısıtlamalar için Sunucu SDK'sı belgelerine bakın.
isroot	İstenen lisansın tanımlı kök KID ile bir kök lisans olması gerekir	yanlış, doğru	Örnek: cfg=(isroot:true,kid:3C6F3C13-6207-4916-867C-8252B3993638)
rootid	Yaprak lisansı için kök KID'yi ayarlama	Kılavuz	Örnek: cfg=(rootid:3C6F3C13-6207-4916-867C-8252B3993638,kid:header),(isroot:true,kid:3C6F3C13-6207-4916-867C-8252B3993638)
sourceid	SourceID veya Kısıtlı Kaynak Kimliği kısıtlamasını ayarlama	int	Örnek: sourceid:267 6.12 CRS bölümünde izin verilen değerleri denetleyin
caopl	Sıkıştırılmış Dijital Ses Çıkış Koruma Düzeyi kısıtlaması ayarlama	tamsayı	Örnek: caopl:200 Varsayılan değer 0'dır Genellikle sıkıştırılmış ses için Güvenli Ses Sürücüleri gerektirir. 6.7 ve 3.6.2 CRS bölümünde izin verilen değerleri denetleyin Sunucu SDK kodu: right.CompressedDigitalAudioOPL = 200;
ucaopl	Sıkıştırılmamış Dijital Ses Çıkış Koruma Düzeyi kısıtlaması ayarlama	tamsayı	Örnek: ucaopl:300 Varsayılan değer 0'dır Genellikle sıkıştırılmamış ses için HDCP veya DTCP gerektirir. 6.7 ve 3.6.3 CRS bölümünde izin verilen değerleri denetleyin Sunucu SDK kodu: right.UncompressedDigitalAudioOPL = 300;
cvopl	Sıkıştırılmış Dijital Video Çıkış Koruma Düzeyi kısıtlaması ayarlama	tamsayı	Örnek: cvopl:500 İzin verilen tüm değerler, PlayReady Ürününün sıkıştırılmış şifresi çözülmüş İçeriğin video bölümünü herhangi bir video çıkışına geçirmemesi gerektiği anlamına gelir. 6.7 ve 3.6.4 CRS bölümünde izin verilen değerleri denetleyin Sunucu SDK kodu: right.CompressedDigitalVideoOPL = 500;
ucvopl	Sıkıştırılmamış Dijital Video Çıkış Koruma Düzeyi kısıtlaması ayarlama	tamsayı	Örnek: ucvopl:300 Varsayılan değer 0'dır Genellikle sıkıştırılmamış video için HDMI'da HDCP gerektirir. 6.7 ve 3.6.5 CRS bölümünde izin verilen değerleri denetleyin Sunucu SDK kodu: right.UncompressedDigitalVideoOPL = 300;
avopl	Analog Video Çıkış Koruma Düzeyi kısıtlaması ayarlama	tamsayı	Örnek: avopl:200 için hiçbir zaman CGMS-A kopya gerektirme 6.7 ve 3.6.6 bölümündeki izin verilen değerleri denetleyin Sunucu SDK kodu: right.AnalogVideoOPL = 200;
dvop	Açık Dijital Video Çıkış Koruması ekleme	temel 64 dizesinde kodlanmış guid ve isteğe bağlı veriler	Örnek: dvop:(guid:ABB2C6F1-E663-4625-A945-972D17B231E7,data:AAAAAQ==) HDCP Tür 1'i gerektirmek için. 3.6.5.7 CRS bölümüne bakın. Sunucu SDK kodu: right.AddDigitalVideoOutputProtection(new Guid("", 1))
daop	Açık Bir Dijital Ses Çıkış Koruması Ekleme	temel 64 dizesinde kodlanmış guid ve isteğe bağlı veriler	Örnek: daop:(guid:6D5CFA59-C250-4426-930E-FAC72C8FCFA6,data:AAAAAQ==) SCMS gerektirmek için. 3.6.3.8 CRS bölümüne bakın. Sunucu SDK kodu: right.AddDigitalAudioOutputProtection(new Guid("{6D5CFA59-C250-4426-930E-FAC72C8FCFA6}", 1))
avop	Açık Analog Video Çıkış Koruması ekleme	guid ve temel 64 dizesinde kodlanmış veriler	Örnek: avop:(guid:760AE755-682A-41E0-B1B3-DCDF836A7306,data:AAAAAQ==) 6.5 CRS bölümünde izin verilen değerleri denetleyin. Sunucu SDK kodu: right.AddAnalogVideoOutputProtection(new Guid("{760AE755-682A-41E0-B1B3-DCDF836A7306}", 1)
extendedrestrictions	Sağa bir veya birden çok Genişletilmiş Kısıtlama ekleme	tamsayı ve özellikler, bkz. örnek	Örnek: (extendedrestrictions:((type:400, mustunderstand:true,besteffort:false,data:Ah==),(type:401, mustunderstand:true,besteffort:false,data:Ah==))) Başka bir hak ayarlanmadıysa Yürütme hakkı için geçerli olduğunu varsayar.
playenablers	Lisansa bir veya birden çok Play Enabler ekleme	guid veya guid grubu	Örnek 1: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7) (Bilinmeyen Çıkışlara izin ver). Örnek 2: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7,5ABF0F0D-DC29-4B82-9982-FD8E57525BFC) (Bilinmeyen Çıkışlara ve AirPlay'e izin ver). Tüm Play Enabler'lar için CR'lere bakın.
			Aşağıdaki parametreler, yukarıda açıklanan belirli kısıtlama ve yürütme etkinleştirici bileşimleri için kısaltmalardır
explicitacp	Analog Video için Otomatik Kazanç Denetimi ve Renk Şeridi kısıtlaması ayarlama	tamsayı 0,1,2,3	Örnek: explicitacp:2 Eşdeğer: avop(guid:C3FD11C6-F8B7-4D20-B008-1DB17D61F2DA,data:AgAAAA==) 6.5.1 ve 3.6.7.2 CRS bölümüne bakın. Sunucu SDK kodu: right.AddAnalogVideoOutputProtection(new ExplicitOutputProtection(new Guid("C3FD11C6-F8B7-4D20-B008-1DB17D61F2DA"), HeightBytes.Concat(WidthBytes).ToArray()))
maxres	Maksimum Etkili Çözünürlük Kod Çözme Boyutu kısıtlaması ayarlama	tamsayı x tamsayı	Örnek: maxres:1920x1080 Eşdeğer: dvop:(guid:9645E831-E01D-4FFF-8342-0A720E3E028F,data:AAAEOAAAB4A=) 6.5 ve 3.6.5.7.1 CRS bölümüne bakın. Sunucu SDK kodu: right.AddDigitalVideoOutputProtection(new ExplicitOutputProtection(new Guid("9645E831-E01D-4FFF-8342-0A720E3E028F"), BitConverter.GetBytes((int)value))
allowunknownsd	Kısıtlı çözünürlük için Bilinmeyen Çıkış için Çıkış Denetimi Ekleme	yanlış, doğru	Örnek: allowunknownsd:true Eşdeğer: playenablers:(B621D91F-EDCC-4035-8D4B-DC71760D43E9) 3.9.2 CRS bölümüne bakın. Sunucu SDK kodu: right.AddPlayEnabler(new PlayEnabler(new Guid("B621D91F-EDCC-4035-8D4B-DC71760D43E9")))
allowunknownhd	Herhangi bir çözüm için Bilinmeyen Çıkış için Çıkış Denetimi Ekleme	yanlış, doğru	Örnek: allowunknownhd:true Eşdeğer: playenablers:(786627D8-C2A6-44BE-8F88-08AE255B01A7) 3.9.1 CRS bölümüne bakın. Sunucu SDK kodu: right.AddPlayEnabler(new PlayEnabler(new Guid("786627D8-C2A6-44BE-8F88-08AE255B01A7")))
clientinfo			Özel yansıma özelliği. Diğer ayrıntılar için bu sayfaya bakın.