Come testare i client PlayReady con versioni di PlayReady Server SDK
Il sito Web di test PlayReady contiene un set di servizi licenze che usano le versioni correnti e legacy di Server SDK. Questi servizi di licenza possono essere usati per facilitare il test della compatibilità dei client. Ad esempio, quando si aggiorna un client a PK 4.0, è possibile testare il client rispetto alle versioni precedenti del servizio per verificare la compatibilità.
I servizi con versione sono elencati nella tabella seguente.
| Versione SDK | URL del servizio licenze |
|---|---|
| SDK 1.52 | http(s)://test.playready.microsoft.com/directtaps/svc/pr152/rightsmanager.asmx |
| SDK 2.0 | http(s)://test.playready.microsoft.com/directtaps/svc/pr20/rightsmanager.asmx |
| SDK 2.1 | http(s)://test.playready.microsoft.com/directtaps/svc/pr21/rightsmanager.asmx |
| SDK 2.9 | http(s)://test.playready.microsoft.com/directtaps/svc/pr29/rightsmanager.asmx |
| SDK 3.0 | http(s)://test.playready.microsoft.com/directtaps/svc/pr30/rightsmanager.asmx |
| SDK 4.0 | http(s)://test.playready.microsoft.com/service/rightsmanager.asmx |
Questi servizi con controllo delle versioni possono usare i parametri elencati nel sito di test PlayReady per il test di criteri specifici. Il server di test pubblico PlayReady supporta ora più sintassi per fornire questi parametri in modo che i tester possano scegliere quello più appropriato per il caso.
Il sito http(s)://test.playready.microsoft.com/service/rightsmanager.asmx viene sempre usato per il server aggiornato più recente.
La sintassi consigliata è la sintassi della stringa di query. Altre sintassi includono la sintassi JSON dei dati personalizzati, la sintassi JSON di base 64 e la sintassi legacy.
Si noti che non tutti i parametri dei criteri funzioneranno con ognuna delle versioni del servizio. Ad esempio, MaxResDecode funziona solo con i servizi sviluppati con Server SDK 3.0 o versione successiva.
Per facilitare il test delle funzionalità, è possibile usare i test seguenti con i diversi servizi licenze con controllo delle versioni per coprire quattro scenari di licenza univoci. Questi scenari illustrano come usare la sintassi della stringa di query nei test. Tuttavia, è possibile usare una qualsiasi delle altre sintassi collegate in precedenza se sono più appropriate per il caso.
Scenario 1: licenze non persistenti
Le licenze non persistenti sono lo scenario di licenza più comune usato dai servizi di streaming.
Passaggi di test:
Creare un pacchetto del contenuto usando KeySeed annotato nel sito di test PlayReady. Per questo test è possibile usare qualsiasi KeyID durante la creazione del pacchetto.
Testare una richiesta di licenza dal client usando l'URL seguente:
{URL del servizio licenze con versione} senza parametri
ad esempio: https://test.playready.microsoft.com/service/rightsmanager.asmx
Verificare che venga restituita una licenza e che la riproduzione sia riuscita.
Scenario 2: licenze persistenti
Le licenze persistenti vengono comunemente usate dai servizi che abilitano il contenuto di riproduzione offline.
Passaggi di test:
Creare un pacchetto del contenuto usando KeySeed annotato nel sito di test PlayReady. Per questo test è possibile usare qualsiasi KeyID durante la creazione del pacchetto.
Testare una richiesta di licenza dal client usando l'URL seguente:
{URL del servizio licenze con versione} ?cfg=(persist:true,firstexp:60)
Questo parametro indirizza il servizio licenze a restituire una licenza che scade 60 secondi dopo la prima esecuzione. Si noti che è necessario chiamare in modo esplicito persist:true per ricevere licenze persistenti.
ad esempio: https://test.playready.microsoft.com/service/rightsmanager.asmx?cfg=(persist:true,firstexp:60)
Verificare che venga restituita una licenza e che la riproduzione venga eseguita correttamente. Aggiungere o modificare i parametri dei criteri basati sul tempo come indicato nel sito di test per testare altri scenari persistenti.
Scenario 3: licenze concatenati
Le licenze associate radice vengono usate da alcuni servizi di sottoscrizione, in genere per la musica. Con lo scenario associato alla radice, diverse licenze foglia possono essere associate a una singola licenza radice. Alla scadenza della licenza radice, le licenze foglia non sono più utilizzabili a meno che non venga riemissione una nuova radice.
Passaggi di test:
Creare il pacchetto del contenuto usando KeySeed annotato nel sito di test PlayReady usando il keyID seguente:
Base64: uPeXHrR3K0icGCpYMBGsZw==
Testare il client usando l'URL seguente per richiedere una licenza:
{URL del servizio licenze con versione} ?cfg=(rootid:uPeXHrR3K0icGCpYMBGsZw==,kid:header),(isroot:true,kid:uPeXHrR3K0icGCpYMBGsZw==)
Verificare che venga restituita una licenza e che la riproduzione venga eseguita correttamente. In questo scenario una singola risposta dal servizio deve contenere due licenze. Una di esse sarà una licenza radice e l'altra una licenza foglia. Le licenze devono scadere cinque minuti dopo l'emissione al client.
Scenario 4: licenza associata a dominio
I domini non vengono usati comunemente dai servizi. I domini PlayReady consentono a un servizio di gestire il numero di dispositivi attivi in un account e per i dispositivi all'interno dell'account per condividere contenuti e licenze offline.
Creare il pacchetto del contenuto usando KeySeed annotato nel sito di test PlayReady usando il keyID seguente:
Base64: m1HAERIu8E+uABCZY4TX2g==
Il client di test userà l'URL seguente per l'aggiunta al dominio e l'acquisizione di una licenza:
{versioned license service URL}?cfg=(accountid:A/uHOj7F+UaM+Jlny2obFA==)
ad esempio: https://test.playready.microsoft.com/service/rightsmanager.asmx?cfg=(accountid:A/uHOj7F+UaM+Jlny2obFA==)
Chiedere al client di test di generare e inviare una richiesta joinDomain e verificare che nella risposta del servizio sia presente un certificato di dominio.
Chiedere al client di test di inviare una richiesta di licenza al servizio usando lo stesso URL, incluso l'ID account.
Verificare che venga restituita una licenza e che la riproduzione venga eseguita correttamente. È anche possibile inviare una richiesta LeaveDomain al servizio licenze per reimpostare lo scenario.
Altre informazioni
Per altre informazioni, visitare il sito Web PlayReady all'indirizzo https://www.microsoft.com/playready/ e il sito di test di PlayReady all'indirizzo https://test.playready.microsoft.com/.