Modelos predefinidos e políticas personalizadas

Use um modelo de política chamado do lado do servidor#

Proteção com uma única chave de vídeo

Todas as versões de vídeo partilham uma chave de vídeo. O áudio encriptado utiliza uma chave de áudio separada. O conteúdo apenas de áudio utiliza uma chave de áudio.

Uma chave identifica o conteúdo cifrado; uma regra de política define os requisitos de acesso. Em Single Video Key Protection, uma regra ALL aplica os mesmos requisitos à chave de vídeo e a qualquer chave de áudio cifrado. Isso não significa que o áudio e o vídeo compartilhem uma chave. Os pacotes Multi-key Quality Tiered usam regras AUDIO e de qualidade de vídeo separadas.

Modelos nomeados removem a maior parte da política JSON do código da aplicação. DRM-X expande o nome seleccionado para uma política canónica v2, valida-a contra o pacote real e assina o resultado no DRM License Token.

{
  "contentId": "course-12-lesson-4",
  "contentType": "vod",
  "drmSystem": "widevine",
  "subject": "customer-user-1001",
  "playbackMode": "streaming",
  "licensePolicyTemplate": "multi-tier-standard",
  "useEnvironmentDefaults": true,
  "maximumQualityTier": "auto"
}

Com useEnvironmentDefaults: true, o modelo fornece segurança enquanto as configurações de ambiente salvas controlam DRM License Token validade, fluxos simultâneos e renovação. Configure- as em false quando quiser os valores operacionais exatos do modelo.

Os aplicativos podem descobrir os built-ins atuais através de GET /api/v1/playback/license-policy-templates. Os nomes dos modelos são insensíveis à entrada e canonicalizados na solicitação.

Enviar uma política personalizada completa de tempo de solicitação#

Use licensePolicy quando um modelo nomeado não expressar sua regra de negócios. Não envie licensePolicyTemplate na mesma solicitação.

{
  "policy_version": 2,
  "playback_policy": {
    "persistent": false,
    "license_duration": 14400,
    "rental_duration": 0,
    "playback_duration": 7200,
    "renewal_duration": 300,
    "allowed_track_types": "ALL",
    "max_stream_per_user": 2
  },
  "security_policy": [{
    "track_type": "ALL",
    "widevine": {
      "security_level": 1,
      "required_hdcp_version": "HDCP_V1",
      "disable_analog_output": true
    },
    "playready": {
      "security_level": 2000,
      "digital_video_protection_level": 250,
      "analog_video_protection_level": 150,
      "digital_audio_protection_level": 100
    },
    "fairplay": {
      "hdcp_enforcement": 0,
      "allow_airplay": true,
      "allow_av_adapter": false
    },
    "wiseplay": {
      "security_level": 1,
      "output_control": 1
    }
  }]
}

Regras que falham encerradas

• Política JSON é limitada a 16 KiB, deve usar policy_version: 2, e pode conter no máximo sete regras de faixa exclusivas.
• O conteúdo de uma única chave requer uma regra ALL, allowed_track_types: ALL e um limite máximo de qualidade automático.
• Regras multi-chaves podem atingir AUDIO, SD, HD, UHD1, ou UHD2. As camadas omitidas não recebem nenhuma chave.
• max_stream_per_user: 0 desabilita DRM-X limite de fluxo simultâneo para esse token.
• expiresInSeconds é DRM License Token validade (60–7200 segundos). É separado de DRM licença e duração de reprodução.