Sintaxis heredada para el servidor de pruebas de PlayReady

Información general

El servidor de pruebas de PlayReady mantiene la compatibilidad con la sintaxis heredada para garantizar la compatibilidad con versiones anteriores de las implementaciones de PlayReady y las aplicaciones cliente existentes. Este enfoque heredado usa formatos de parámetro simplificados y métodos HTTP tradicionales que se han admitido desde las primeras versiones de PlayReady.

Formato de dirección URL heredada

La sintaxis heredada usa una estructura de dirección URL simplificada:

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

Parámetros heredados admitidos

Parámetro PlayRight

El PlayRight parámetro especifica los permisos de licencia básicos:

• 1: Permitir reproducción (licencia básica)
• 2: Permitir reproducción con protección de copia
• 3: Permitir la reproducción con protección mejorada
• 0: Denegar la reproducción (para probar escenarios de denegación)

Parámetro de id. de clave (kid)

El formato heredado admite la especificación simplificada del identificador de clave:

• Formato GUID estándar: 12345678-1234-1234-1234-123456789012
• Formato simplificado: 123456789012345678901234567890123456
• Formato codificado en Base64: base64-encoded-key-id

Tipos de licencia heredados

Licencia básica de reproducción

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

licencia de Copy-Protected

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

Licencia de protección mejorada

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

Métodos HTTP heredados

Formato de solicitud POST

Adquisición tradicional de licencias basada en SOAP:

POST /pr/svc/rightsmanager.asmx HTTP/1.1
Host: playready.directtaps.net
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://schemas.microsoft.com/DRM/2007/03/protocols/AcquireLicense"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <AcquireLicense xmlns="http://schemas.microsoft.com/DRM/2007/03/protocols">
      <challenge>base64-encoded-challenge</challenge>
    </AcquireLicense>
  </soap:Body>
</soap:Envelope>

Formato de solicitud GET

Solicitudes de licencia sencillas basadas en GET:

GET /pr/svc/rightsmanager.asmx?PlayRight=1&kid=12345678-1234-1234-1234-123456789012 HTTP/1.1
Host: playready.directtaps.net

Ejemplos de integración de cliente

Implementación heredada de JavaScript

// Legacy URL construction
function buildLegacyLicenseUrl(keyId, playRight) {
    return `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=${playRight}&kid=${keyId}`;
}

// Basic license request
const licenseUrl = buildLegacyLicenseUrl(keyId, 1);

// Use with legacy PlayReady implementations

Implementación heredada de C#

// Legacy license request construction
public string BuildLegacyLicenseUrl(string keyId, int playRight)
{
    return $"https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight={playRight}&kid={keyId}";
}

// Usage
string licenseUrl = BuildLegacyLicenseUrl(keyId, 1);

Matriz de compatibilidad

Compatibilidad con versiones de PlayReady

Compatibilidad con la plataforma cliente

Guía de migración

Desde la sintaxis heredada

Al migrar de sintaxis heredada a enfoques modernos:

Paso 1: Identificar el uso actual

// Current legacy usage
const legacyUrl = `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?PlayRight=1&kid=${keyId}`;

Paso 2: Asignar a equivalente moderno

// Modern equivalent
const modernConfig = {
    licenseType: "persistent",
    keyId: keyId,
    policies: {
        playback: {
            allowOffline: true
        }
    }
};

Paso 3: Actualizar la adquisición de licencias

// Modern license request
const licenseUrl = "https://playready.directtaps.net/pr/svc/rightsmanager.asmx";
// Include modern configuration in request body

Limitaciones de la sintaxis heredada

Limitaciones funcionales

• Control de directiva limitado: permisos de reproducción básicos solo
• Sin características avanzadas: faltan funcionalidades modernas de DRM
• Protección simplificada: opciones básicas de protección de copia
• Sin compatibilidad con dominios: no se admiten licencias enlazadas a dominio

Consideraciones de seguridad

• Cifrado anterior: usa métodos de cifrado heredados
• Validación limitada: validación de seguridad reducida
• Problemas de compatibilidad: puede que no funcione con los requisitos de seguridad modernos.

Probar implementaciones heredadas

Pruebas básicas de funcionalidad

// Test basic playback
testLegacyLicense(keyId, 1); // Should allow playback

// Test copy protection
testLegacyLicense(keyId, 2); // Should enable copy protection

// Test denial scenario
testLegacyLicense(keyId, 0); // Should deny playback

Pruebas de compatibilidad

1. Prueba de versiones: prueba con diferentes versiones de PlayReady
2. Pruebas de plataforma: comprobación en plataformas compatibles
3. Pruebas de características: validar que las características disponibles funcionan correctamente
4. Pruebas de migración: probar las rutas de actualización a la sintaxis moderna

Tratamiento de errores

errores de Legacy-Specific

• PlayRight no admitido: valor de parámetro PlayRight no válido
• Formato de clave heredada: el formato de identificador de clave no se admite en el modo heredado
• Error de coincidencia de versiones: versión de cliente incompatible con el servidor heredado

Formato de respuesta de error

Las respuestas de error heredadas usan formato XML simplificado:

<?xml version="1.0" encoding="utf-8"?>
<Error>
    <Code>400</Code>
    <Message>Invalid PlayRight parameter</Message>
</Error>

Procedimientos recomendados

Cuándo usar la sintaxis heredada

1. Sistemas heredados: compatibilidad con implementaciones anteriores de PlayReady
2. Compatibilidad con versiones anteriores: mantener la compatibilidad con los clientes existentes
3. Requisitos simples: reproducción básica sin características avanzadas
4. Período de migración: durante la transición a implementaciones modernas

Alternativas recomendadas

Para las nuevas implementaciones, tenga en cuenta lo siguiente:

• Sintaxis de cadena de consulta : enfoque moderno sencillo
• Sintaxis JSON de CustomData : configuración avanzada
• Sintaxis JSON de Base64 : formato moderno compacto

Aviso sobre elementos desusados

Nota: La compatibilidad con la sintaxis heredada se mantiene para la compatibilidad con versiones anteriores, pero está en desuso para las nuevas implementaciones. Considere la posibilidad de migrar a la sintaxis moderna para características y seguridad mejoradas.

Documentación relacionada

• Servicio de servidor de prueba de PlayReady : información general sobre el servicio principal
• Sintaxis de cadena de consulta : enfoque sencillo moderno
• Migración: guía de migración
• Servidores de prueba de PlayReady : documentación completa del servidor

Soporte técnico y solución de problemas

Para problemas con la sintaxis heredada:

1. Comprobar la compatibilidad de la versión de PlayReady
2. Comprobación del formato y los valores de los parámetros
3. Prueba con configuraciones simplificadas
4. Considere la posibilidad de migrar a la sintaxis moderna
5. Revisión de la documentación específica de la plataforma

Para obtener ayuda de migración y alternativas modernas, consulte la documentación principal de Los servidores de pruebas de PlayReady .