Udostępnij przez

Składnia ciągu zapytania dla serwera testowego PlayReady

Przegląd

Serwer PlayReady Test Server obsługuje składnię ciągu zapytania dla żądań licencji, zapewniając metodę opartą na adresie URL służącą do określania parametrów licencji. Takie podejście umożliwia deweloperom osadzanie konfiguracji licencji bezpośrednio w adresie URL, co ułatwia testowanie różnych scenariuszy i konfiguracji.

Format składni

Składnia ciągu zapytania używa standardowych parametrów adresu URL do określania wymagań licencyjnych:

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

Obsługiwane parametry

Parametr konfiguracji (cfg)

Parametr cfg określa konfigurację licencji:

  • trwałe: tworzy trwałą licencję, którą można przechowywać na urządzeniu
  • nietrwale: tworzy tymczasową licencję wygasającą po zamknięciu aplikacji
  • wynajem: tworzy licencję na wynajem z ograniczeniami opartymi na czasie
  • subskrypcja: tworzy licencję opartą na subskrypcji

Parametr identyfikatora klucza (kid)

Parametr kid określa identyfikator klucza dla odszyfrowywania zawartości:

  • Musi być prawidłowym formatem GUID
  • Odpowiada identyfikatorowi klucza szyfrowania zawartości
  • Służy do dopasowywania licencji do zaszyfrowanej zawartości

Przykładowe adresy URL

Podstawowa licencja trwała

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

Licencja nietrwalna

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

Licencja na wynajem z 48-godzinnym wygaśnięciem

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

Scenariusze testowania

Podstawowe pozyskiwanie licencji

  1. Generowanie żądania licencji przy użyciu klienta PlayReady
  2. Konstruowanie adresu URL przy użyciu odpowiednich parametrów
  3. Wysyłanie żądania HTTP POST do skonstruowanego adresu URL
  4. Przetwarzanie zwróconej odpowiedzi na licencję

Różne typy licencji

Przetestuj cfg różne konfiguracje licencji, zmieniając parametr:

  • Testowanie trwałego i nietrwalnego zachowania
  • Weryfikowanie funkcji wygasania wypożyczania
  • Weryfikowanie dostępu opartego na subskrypcji

Obsługa błędów

Typowe scenariusze błędów i odpowiedzi:

Nieprawidłowy identyfikator klucza

  • Błąd: Źle sformułowany identyfikator GUID w parametrze kid
  • Odpowiedź: HTTP 400 Nieprawidłowe żądanie ze szczegółami błędu

Nieobsługiwana konfiguracja

  • Błąd: Nieprawidłowa wartość parametru cfg
  • Odpowiedź: HTTP 400 Nieprawidłowe żądanie z obsługiwanymi wartościami

Brakujące parametry

  • Błąd: Nie podano wymaganych parametrów
  • Odpowiedź: HTTP 400 Nieprawidłowe żądanie z wymaganiami dotyczącymi parametrów

Najlepsze praktyki

  1. Kodowanie adresów URL: Upewnij się, że prawidłowe kodowanie adresów URL wartości parametrów
  2. Użycie protokołu HTTPS: zawsze używaj bezpiecznych połączeń dla żądań licencji
  3. Weryfikacja parametru: Zweryfikuj parametry przed wykonaniem żądań
  4. Obsługa błędów: Implementowanie niezawodnej obsługi błędów w różnych scenariuszach

Przykłady integracji

JavaScript/HTML5

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

Aplikacja języka C#

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

Pomoc techniczna i rozwiązywanie problemów

W przypadku problemów ze składnią ciągu zapytania:

  1. Weryfikowanie formatowania parametrów i wartości
  2. Sprawdzanie kodowania adresów URL znaków specjalnych
  3. Weryfikowanie formatu identyfikatora klucza (GUID)
  4. Testowanie przy użyciu różnych konfiguracji licencji
  5. Przejrzyj odpowiedź serwera, aby uzyskać szczegółowe informacje o błędzie

Aby uzyskać dodatkową pomoc techniczną, zapoznaj się z główną dokumentacją serwerów testowych PlayReady .

  • Last updated on