Compartilhar via

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

Visão geral

O Servidor de Teste do PlayReady dá suporte à 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 insiram a configuração de licença diretamente na URL, facilitando o teste de diferentes cenários e configurações.

Formato de 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 com suporte

Parâmetro de configuração (cfg)

O cfg parâmetro especifica a configuração de 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 fecha
  • aluguel: cria uma licença de aluguel com restrições baseadas em tempo
  • assinatura: cria uma licença baseada em assinatura

Parâmetro de ID da chave (kid)

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

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

URLs de exemplo

Licença persistente básica

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 aluguel com expiração 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 básica de licença

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

Tipos de licença diferentes

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 de aluguel
  • Validar o 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: Solicitação Inválida HTTP 400 com detalhes de erro

Configuração sem suporte

  • Erro: valor inválido para cfg parâmetro
  • Resposta: Solicitação Inválida HTTP 400 com valores com suporte

Parâmetros ausentes

  • Erro: parâmetros necessários não fornecidos
  • Resposta: Solicitação Inválida HTTP 400 com requisitos de parâmetro

Práticas recomendadas

  1. Codificação de URL: garantir a codificação de URL adequada 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âmetro: validar parâmetros antes de fazer solicitações
  4. Tratamento de erros: implementar o tratamento de erros robustos 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

Aplicativo 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 do parâmetro
  2. Verificar a codificação de URL de caracteres especiais
  3. Validar o formato de ID da chave (GUID)
  4. Testar com diferentes configurações de licença
  5. Examinar a resposta do servidor para obter detalhes de erro

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

  • Last updated on