Freigeben über

Abfragezeichenfolgensyntax für PlayReady-Testserver

Überblick

Der PlayReady Test Server unterstützt die Abfragezeichenfolgensyntax für Lizenzanforderungen und stellt eine URL-basierte Methode zum Angeben von Lizenzparametern bereit. Mit diesem Ansatz können Entwickler die Lizenzkonfiguration direkt in die URL einbetten, sodass verschiedene Szenarien und Konfigurationen einfach getestet werden können.

Syntaxformat

Die Abfragezeichenfolgensyntax verwendet standard-URL-Parameter, um Lizenzanforderungen anzugeben:

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

Unterstützte Parameter

Konfigurationsparameter (cfg)

Der cfg Parameter gibt die Lizenzkonfiguration an:

  • persistent: Erstellt eine persistente Lizenz, die auf dem Gerät gespeichert werden kann.
  • nicht persistent: Erstellt eine temporäre Lizenz, die abläuft, wenn die Anwendung geschlossen wird.
  • Vermietung: Erstellt eine Mietlizenz mit zeitlichen Einschränkungen
  • subscription: Creates a subscription-based license

Key ID-Parameter (kid)

Der kid Parameter gibt die Schlüssel-ID für die Inhaltsentschlüsselung an:

  • Muss ein gültiges GUID-Format sein
  • Entspricht dem Verschlüsselungsschlüsselbezeichner des Inhalts.
  • Wird verwendet, um mit der Lizenz mit dem verschlüsselten Inhalt übereinzugleichen

Beispiel-URLs

Basic Persistent License

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

Nicht persistente Lizenz

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=non-persistent&kid=87654321-4321-4321-4321-210987654321

Mietlizenz mit Ablauf von 48 Stunden

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=rental&kid=12345678-1234-1234-1234-123456789012&expiry=48h

Testszenarien

Basislizenzerwerb

  1. Generieren einer Lizenzanforderung mit Ihrem PlayReady-Client
  2. Erstellen der URL mit entsprechenden Parametern
  3. Senden einer HTTP POST-Anforderung an die erstellte URL
  4. Verarbeiten der zurückgegebenen Lizenzantwort

Verschiedene Lizenztypen

Testen Sie verschiedene Lizenzkonfigurationen, indem Sie den cfg Parameter ändern:

  • Testen des persistenten und nicht persistenten Verhaltens
  • Überprüfen der Ablauffunktion des Miets
  • Überprüfen des abonnementbasierten Zugriffs

Fehlerbehandlung

Häufige Fehlerszenarien und -antworten:

Ungültige Schlüssel-ID

  • Fehler: Falsch formatierte GUID im kid Parameter
  • Antwort: HTTP 400 Ungültige Anforderung mit Fehlerdetails

Nicht unterstützte Konfiguration

  • Fehler: Ungültiger Wert für cfg parameter
  • Antwort: HTTP 400 Ungültige Anforderung mit unterstützten Werten

Fehlende Parameter

  • Fehler: Erforderliche Parameter nicht angegeben
  • Antwort: HTTP 400 Ungültige Anforderung mit Parameteranforderungen

Bewährte Methoden

  1. URL-Codierung: Sicherstellen der richtigen URL-Codierung von Parameterwerten
  2. HTTPS-Verwendung: Sichere Verbindungen immer für Lizenzanforderungen verwenden
  3. Parameterüberprüfung: Überprüfen von Parametern vor dem Senden von Anforderungen
  4. Fehlerbehandlung: Implementieren einer robusten Fehlerbehandlung für verschiedene Szenarien

Integrationsbeispiele

JavaScript/HTML5

const licenseUrl = `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=persistent&kid=${keyId}`;
// Use with your PlayReady implementation

C#-Anwendung

string licenseUrl = $"https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=persistent&kid={keyId}";
// Use with PlayReady SDK

Support und Problembehandlung

Bei Problemen mit der Abfragezeichenfolgensyntax:

  1. Überprüfen der Parameterformatierung und -werte
  2. Überprüfen der URL-Codierung von Sonderzeichen
  3. Überprüfen des Schlüssel-ID-Formats (GUID)
  4. Testen mit unterschiedlichen Lizenzkonfigurationen
  5. Überprüfen der Serverantwort auf Fehlerdetails

Weitere Unterstützung finden Sie in der Hauptdokumentation zu PlayReady-Testservern .

  • Last updated on