Partilhar via

Sintaxe da cadeia de caracteres de consulta para o servidor de teste PlayReady

Visão geral

O PlayReady Test Server suporta sintaxe de cadeia de caracteres de consulta para solicitações de licença, fornecendo um método baseado em URL para especificar parâmetros de licença. Essa abordagem permite que os desenvolvedores incorporem a configuração de licença diretamente na URL, facilitando o teste de diferentes cenários e configurações.

Formato da sintaxe

A sintaxe da cadeia de caracteres de consulta usa parâmetros de URL padrão para especificar os requisitos de licença:

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

Parâmetros suportados

Parâmetro de configuração (cfg)

O cfg parâmetro especifica a configuração da licença:

  • persistente: cria uma licença persistente que pode ser armazenada no dispositivo
  • não persistente: cria uma licença temporária que expira quando o aplicativo é fechado
  • aluguel: cria uma licença de aluguel com restrições baseadas no tempo
  • assinatura: cria uma licença baseada em assinatura

Parâmetro ID da chave (kid)

O kid parâmetro especifica o ID da chave para a descriptografia de conteúdo:

  • Deve ser um formato GUID válido
  • Corresponde ao identificador de chave de criptografia do conteúdo
  • Usado para fazer corresponder a licença com o conteúdo criptografado

URLs de exemplo

Licença Básica Persistente

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

Licença não persistente

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

Licença de aluguer com validade de 48 horas

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

Cenários de teste

Aquisição de Licença Básica

  1. Gere uma solicitação de licença usando seu cliente PlayReady
  2. Construa a URL com parâmetros apropriados
  3. Enviar uma solicitação HTTP POST para a URL construída
  4. Processar a resposta da licença devolvida

Diferentes tipos de licença

Teste várias configurações de licença alterando o cfg parâmetro:

  • Testar comportamento persistente versus não persistente
  • Verificar a funcionalidade de expiração do aluguer
  • Validar acesso baseado em assinatura

Tratamento de erros

Cenários de erro e respostas comuns:

ID de chave inválida

  • Erro: GUID malformado no kid parâmetro
  • Resposta: HTTP 400 Bad Request com detalhes de erro

Configuração não suportada

  • Erro: Valor inválido para cfg o parâmetro
  • Resposta: HTTP 400 Bad Request com valores suportados

Parâmetros em falta

  • Erro: Parâmetros necessários não fornecidos
  • Resposta: HTTP 400 Bad Request com requisitos de parâmetro

Melhores práticas

  1. Codificação de URL: Garanta a codificação adequada de URL de valores de parâmetro
  2. Uso de HTTPS: sempre use conexões seguras para solicitações de licença
  3. Validação de parâmetros: valide parâmetros antes de fazer solicitações
  4. Tratamento de erros: implemente um tratamento robusto de erros para vários cenários

Exemplos de integração

JavaScript/HTML5

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

Aplicação C#

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

Suporte e solução de problemas

Para problemas com a sintaxe da cadeia de caracteres de consulta:

  1. Verificar a formatação e os valores dos parâmetros
  2. Verificar a codificação de URL de caracteres especiais
  3. Validar formato de ID de chave (GUID)
  4. Teste com diferentes configurações de licença
  5. Revise a resposta do servidor para obter detalhes do erro

Para obter suporte adicional, consulte a documentação principal dos Servidores de Teste PlayReady .

  • Last updated on