Condividi tramite

Sintassi legacy per il server di test PlayReady

Informazioni generali

Il server di test PlayReady mantiene il supporto per la sintassi legacy per garantire la compatibilità con le versioni precedenti di PlayReady e le applicazioni client esistenti. Questo approccio legacy usa formati di parametri semplificati e metodi HTTP tradizionali supportati sin dalle prime versioni di PlayReady.

Formato URL legacy

La sintassi legacy usa una struttura url semplificata:

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&kid=KEY_ID

Parametri legacy supportati

Parametro PlayRight

Il PlayRight parametro specifica le autorizzazioni di licenza di base:

  • 1: Consentire la riproduzione (licenza di base)
  • 2: Consentire la riproduzione con la protezione della copia
  • 3: Consentire la riproduzione con protezione avanzata
  • 0: Nega la riproduzione (per gli scenari di negazione dei test)

Parametro ID chiave (kid)

Il formato legacy supporta la specifica dell'ID chiave semplificata:

  • Formato GUID standard: 12345678-1234-1234-1234-123456789012
  • Formato semplificato: 123456789012345678901234567890123456
  • Formato con codifica Base64: base64-encoded-key-id

Tipi di licenza legacy

Licenza di riproduzione di base

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&kid=12345678-1234-1234-1234-123456789012

Licenza Copy-Protected

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=2&kid=12345678-1234-1234-1234-123456789012

Licenza di protezione avanzata

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=3&kid=12345678-1234-1234-1234-123456789012

Metodi HTTP legacy

Formato richiesta POST

Acquisizione di licenze basate su SOAP tradizionale:

POST /pr/svc/rightsmanager.asmx HTTP/1.1
Host: playready.directtaps.net
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://schemas.microsoft.com/DRM/2007/03/protocols/AcquireLicense"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <AcquireLicense xmlns="http://schemas.microsoft.com/DRM/2007/03/protocols">
      <challenge>base64-encoded-challenge</challenge>
    </AcquireLicense>
  </soap:Body>
</soap:Envelope>

Formato richiesta GET

Richieste di licenza semplici basate su GET:

GET /pr/svc/rightsmanager.asmx?PlayRight=1&kid=12345678-1234-1234-1234-123456789012 HTTP/1.1
Host: playready.directtaps.net

Esempi di integrazione client

Implementazione JavaScript legacy

// Legacy URL construction
function buildLegacyLicenseUrl(keyId, playRight) {
    return `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=${playRight}&kid=${keyId}`;
}

// Basic license request
const licenseUrl = buildLegacyLicenseUrl(keyId, 1);

// Use with legacy PlayReady implementations

Implementazione C# legacy

// Legacy license request construction
public string BuildLegacyLicenseUrl(string keyId, int playRight)
{
    return $"https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight={playRight}&kid={keyId}";
}

// Usage
string licenseUrl = BuildLegacyLicenseUrl(keyId, 1);

Matrice di compatibilità

Supporto della versione PlayReady

Versione PlayReady Supporto per sistemi legacy Approccio consigliato
1.0 - 1.3 Completo Sintassi legacy
2.0 - 2.3 Completo Legacy o Modern
3.0+ Limitato Sintassi moderna
4.0+ Deprecato Sintassi moderna

Supporto della piattaforma client

Piattaforma Supporto per sistemi legacy Note
Windows Legacy Completo Implementazione originale
Silverlight Completo Supporto della piattaforma legacy
Windows 10+ Limitato API moderne preferite
Piattaforme mobili Variabile Controllare la documentazione della piattaforma

Linee guida per la migrazione

Dalla sintassi legacy

Quando si esegue la migrazione dalla sintassi legacy agli approcci moderni:

Passaggio 1: Identificare l'utilizzo corrente

// Current legacy usage
const legacyUrl = `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&kid=${keyId}`;

Passaggio 2: Eseguire il mapping all'equivalente moderno

// Modern equivalent
const modernConfig = {
    licenseType: "persistent",
    keyId: keyId,
    policies: {
        playback: {
            allowOffline: true
        }
    }
};

Passaggio 3: Aggiornare l'acquisizione delle licenze

// Modern license request
const licenseUrl = "https://playready.directtaps.net/pr/svc/rightsmanager.asmx";
// Include modern configuration in request body

Limitazioni della sintassi legacy

Limitazioni funzionali

  • Controllo dei criteri limitato: solo autorizzazioni di riproduzione di base
  • Nessuna funzionalità avanzata: funzionalità DRM moderne mancanti
  • Protezione semplificata: opzioni di protezione della copia di base
  • Nessun supporto per il dominio: licenze associate a un dominio non supportate

Considerazioni sulla sicurezza

  • Crittografia precedente: usa metodi di crittografia legacy
  • Convalida limitata: convalida della sicurezza ridotta
  • Problemi di compatibilità: potrebbe non funzionare con i requisiti di sicurezza moderni

Test delle implementazioni legacy

Test di base delle funzionalità

// Test basic playback
testLegacyLicense(keyId, 1); // Should allow playback

// Test copy protection
testLegacyLicense(keyId, 2); // Should enable copy protection

// Test denial scenario
testLegacyLicense(keyId, 0); // Should deny playback

Test di compatibilità

  1. Test della versione: test con diverse versioni di PlayReady
  2. Test della piattaforma: verifica sulle piattaforme supportate
  3. Test delle funzionalità: convalidare il corretto funzionamento delle funzionalità disponibili
  4. Test della migrazione: testare i percorsi di aggiornamento alla sintassi moderna

Gestione degli errori

errori Legacy-Specific

  • PlayRight non supportato: valore del parametro PlayRight non valido
  • Formato chiave legacy: formato ID chiave non supportato in modalità legacy
  • Versione non corrispondente: versione client incompatibile con il server legacy

Formato risposta errore

Le risposte di errore legacy usano un formato XML semplificato:

<?xml version="1.0" encoding="utf-8"?>
<Error>
    <Code>400</Code>
    <Message>Invalid PlayRight parameter</Message>
</Error>

Migliori pratiche

Quando usare la sintassi legacy

  1. Sistemi legacy: supporto di implementazioni PlayReady meno recenti
  2. Compatibilità con le versioni precedenti: mantenimento della compatibilità con i client esistenti
  3. Requisiti semplici: riproduzione di base senza funzionalità avanzate
  4. Periodo di migrazione: durante la transizione alle implementazioni moderne

Per le nuove implementazioni, prendere in considerazione:

Informativa sulle funzionalità deprecate

Nota: il supporto della sintassi legacy viene mantenuto per la compatibilità con le versioni precedenti, ma è deprecato per le nuove implementazioni. Valutare la possibilità di eseguire la migrazione alla sintassi moderna per funzionalità e sicurezza avanzate.

Supporto e risoluzione dei problemi

Per problemi relativi alla sintassi legacy:

  1. Verificare la compatibilità delle versioni di PlayReady
  2. Controllare il formato e i valori dei parametri
  3. Testare con configurazioni semplificate
  4. Prendere in considerazione la migrazione alla sintassi moderna
  5. Esaminare la documentazione specifica della piattaforma

Per assistenza sulla migrazione e alternative moderne, vedere la documentazione principale dei server di test PlayReady .

  • Last updated on