Compartir a través de

Sintaxis de cadena de consulta para el servidor de pruebas de PlayReady

Información general

El servidor de pruebas de PlayReady admite la sintaxis de cadena de consulta para las solicitudes de licencia, proporcionando un método basado en direcciones URL para especificar parámetros de licencia. Este enfoque permite a los desarrolladores insertar la configuración de licencias directamente en la dirección URL, lo que facilita la prueba de diferentes escenarios y configuraciones.

Formato de sintaxis

La sintaxis de cadena de consulta usa parámetros de dirección URL estándar para especificar los requisitos de licencia:

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

Parámetros admitidos

Parámetro de configuración (cfg)

El cfg parámetro especifica la configuración de licencia:

  • persistent: crea una licencia persistente que se puede almacenar en el dispositivo.
  • no persistente: crea una licencia temporal que expira cuando se cierra la aplicación.
  • alquiler: crea una licencia de alquiler con restricciones basadas en el tiempo.
  • suscripción: crea una licencia basada en suscripciones.

Parámetro de id. de clave (kid)

El kid parámetro especifica el identificador de clave para el descifrado de contenido:

  • Debe ser un formato GUID válido
  • Corresponde al identificador de clave de cifrado del contenido.
  • Se usa para hacer coincidir la licencia con el contenido cifrado

Direcciones URL de ejemplo

Licencia persistente básica

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

Licencia no persistente

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

Licencia de alquiler con expiración de 48 horas

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

Escenarios de prueba

Adquisición básica de licencias

  1. Generación de una solicitud de licencia mediante el cliente de PlayReady
  2. Construcción de la dirección URL con los parámetros adecuados
  3. Enviar una solicitud HTTP POST a la dirección URL construida
  4. Procesar la respuesta de licencia devuelta

Diferentes tipos de licencia

Pruebe varias configuraciones de licencia cambiando el cfg parámetro :

  • Probar el comportamiento persistente frente a no persistente
  • Comprobación de la funcionalidad de expiración del alquiler
  • Validación del acceso basado en suscripciones

Tratamiento de errores

Escenarios y respuestas de error comunes:

Identificador de clave no válido

  • Error: GUID con formato incorrecto en kid el parámetro
  • Respuesta: SOLICITUD INCORRECTA HTTP 400 con detalles de error

Configuración no admitida

  • Error: Valor no válido para el cfg parámetro
  • Respuesta: SOLICITUD INCORRECTA HTTP 400 con valores admitidos

Parámetros que faltan

  • Error: No se proporcionan los parámetros necesarios
  • Respuesta: Solicitud incorrecta HTTP 400 con requisitos de parámetro

Procedimientos recomendados

  1. Codificación de direcciones URL: asegúrese de que la codificación url correcta de los valores de parámetro
  2. Uso de HTTPS: use siempre conexiones seguras para las solicitudes de licencia.
  3. Validación de parámetros: valide los parámetros antes de realizar solicitudes.
  4. Control de errores: Implementación de un control de errores sólido para varios escenarios

Ejemplos de integración

JavaScript/HTML5

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

Aplicación de C#

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

Soporte técnico y solución de problemas

Para problemas con la sintaxis de cadena de consulta:

  1. Comprobación del formato y los valores de los parámetros
  2. Comprobación de la codificación url de caracteres especiales
  3. Validar el formato de identificador de clave (GUID)
  4. Prueba con diferentes configuraciones de licencia
  5. Revisión de la respuesta del servidor para obtener detalles del error

Para obtener soporte adicional, consulte la documentación principal de los servidores de prueba de PlayReady .

  • Last updated on