개요
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
테스트 시나리오
기본 라이선스 취득
- PlayReady 클라이언트를 사용하여 라이선스 요청 생성
- 적절한 매개 변수를 사용하여 URL 생성
- 생성된 URL에 HTTP POST 요청 보내기
- 반환된 라이선스 응답 처리
다양한 라이선스 유형
매개 변수를 변경하여 다양한 라이선스 구성을 테스트합니다 cfg .
- 영구 및 비영구 동작 테스트
- 임대 만료 기능 확인
- 구독 기반 액세스 유효성 검사
오류 처리
일반적인 오류 시나리오 및 응답:
잘못된 키 ID
-
오류: 매개 변수의
kid형식이 잘못된 GUID - 응답: 오류 세부 정보가 포함된 HTTP 400 잘못된 요청
지원되지 않는 구성
-
오류: 매개 변수 값이 잘못되었습니다.
cfg - 응답: 지원되는 값이 있는 HTTP 400 잘못된 요청
누락된 매개 변수
- 오류: 필수 매개 변수가 제공되지 않음
- 응답: 매개 변수 요구 사항이 있는 HTTP 400 잘못된 요청
모범 사례
- URL 인코딩: 매개 변수 값의 적절한 URL 인코딩 확인
- HTTPS 사용: 항상 라이선스 요청에 보안 연결 사용
- 매개 변수 유효성 검사: 요청하기 전에 매개 변수 유효성 검사
- 오류 처리: 다양한 시나리오에 대한 강력한 오류 처리 구현
통합 예제
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
관련 설명서
- PlayReady 테스트 서버 서비스 - 기본 서비스 개요
- CustomData JSON 구문 - 대체 JSON 기반 접근 방식
- Base64 JSON 구문 - Base64로 인코딩된 구성
- PlayReady 테스트 서버 - 전체 서버 설명서
지원 및 문제 해결
쿼리 문자열 구문 관련 문제:
- 매개 변수 서식 및 값 확인
- 특수 문자의 URL 인코딩 확인
- 키 ID 형식 유효성 검사(GUID)
- 다른 라이선스 구성으로 테스트
- 오류 세부 정보에 대한 서버 응답 검토
추가 지원은 기본 PlayReady 테스트 서버 설명서를 참조하세요.