다음을 통해 공유


PlayReady 테스트 서버에 대한 쿼리 문자열 구문

개요

PlayReady 테스트 서버는 라이선스 요청에 대한 쿼리 문자열 구문을 지원하여 라이선스 매개 변수를 지정하는 URL 기반 메서드를 제공합니다. 이 방법을 사용하면 개발자가 URL에 라이선스 구성을 직접 포함할 수 있으므로 다양한 시나리오와 구성을 쉽게 테스트할 수 있습니다.

구문 형식

쿼리 문자열 구문은 표준 URL 매개 변수를 사용하여 라이선스 요구 사항을 지정합니다.

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

지원되는 매개 변수

구성 매개 변수(cfg)

매개 변수는 cfg 라이선스 구성을 지정합니다.

  • 영구적: 디바이스에 저장할 수 있는 영구 라이선스를 만듭니다.
  • 비영구: 애플리케이션이 닫히면 만료되는 임시 라이선스를 만듭니다.
  • 대여: 시간 기반 제한이 있는 임대 라이선스를 만듭니다.
  • 구독: 구독 기반 라이선스 만들기

키 ID 매개 변수(kid)

매개 변수는 kid 콘텐츠 암호 해독에 대한 키 ID를 지정합니다.

  • 유효한 GUID 형식이어야 합니다.
  • 콘텐츠의 암호화 키 식별자에 해당합니다.
  • 라이선스를 암호화된 콘텐츠와 일치시킬 때 사용됩니다.

예시 URL

기본 영구 라이선스

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

비영구 라이선스

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

48시간 만료가 있는 임대 라이선스

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

테스트 시나리오

기본 라이선스 취득

  1. PlayReady 클라이언트를 사용하여 라이선스 요청 생성
  2. 적절한 매개 변수를 사용하여 URL 생성
  3. 생성된 URL에 HTTP POST 요청 보내기
  4. 반환된 라이선스 응답 처리

다양한 라이선스 유형

매개 변수를 변경하여 다양한 라이선스 구성을 테스트합니다 cfg .

  • 영구 및 비영구 동작 테스트
  • 임대 만료 기능 확인
  • 구독 기반 액세스 유효성 검사

오류 처리

일반적인 오류 시나리오 및 응답:

잘못된 키 ID

  • 오류: 매개 변수의 kid 형식이 잘못된 GUID
  • 응답: 오류 세부 정보가 포함된 HTTP 400 잘못된 요청

지원되지 않는 구성

  • 오류: 매개 변수 값이 잘못되었습니다.cfg
  • 응답: 지원되는 값이 있는 HTTP 400 잘못된 요청

누락된 매개 변수

  • 오류: 필수 매개 변수가 제공되지 않음
  • 응답: 매개 변수 요구 사항이 있는 HTTP 400 잘못된 요청

모범 사례

  1. URL 인코딩: 매개 변수 값의 적절한 URL 인코딩 확인
  2. HTTPS 사용: 항상 라이선스 요청에 보안 연결 사용
  3. 매개 변수 유효성 검사: 요청하기 전에 매개 변수 유효성 검사
  4. 오류 처리: 다양한 시나리오에 대한 강력한 오류 처리 구현

통합 예제

JavaScript/HTML5

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

C# 애플리케이션

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

지원 및 문제 해결

쿼리 문자열 구문 관련 문제:

  1. 매개 변수 서식 및 값 확인
  2. 특수 문자의 URL 인코딩 확인
  3. 키 ID 형식 유효성 검사(GUID)
  4. 다른 라이선스 구성으로 테스트
  5. 오류 세부 정보에 대한 서버 응답 검토

추가 지원은 기본 PlayReady 테스트 서버 설명서를 참조하세요.