Vordefinierte Vorlagen und eigene Richtlinien

Verwenden Sie eine serverseitige namens policy template#

Benannte Vorlagen entfernen die meisten Richtlinien JSON aus dem Anwendungscode. DRM-X erweitert den ausgewählten Namen zu einer kanonischen v2-Richtlinie, validiert sie gegen das reale Paket und signiert das Ergebnis in die 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"
}

mit useEnvironmentDefaults: true, bietet die Vorlage Sicherheit, während die gespeicherte Umgebung Einstellungen Kontrolle DRM License Token Validität, Concurrent Streams und Erneuerung. false wenn Sie die genauen Betriebswerte der Vorlage wünschen.

Anwendungen können die aktuellen Einbauten durch GET /api/v1/playback/license-policy-templates entdecken. Template-Namen sind bei Eingaben fallunempfindlich und in der Anforderung kanonisiert.

Senden Sie eine vollständige benutzerdefinierte Request-Time-Policy#

Verwendung licensePolicy Wenn eine benannte Vorlage Ihre Geschäftsregel nicht ausdrückt, senden Sie nicht licensePolicyTemplate im gleichen Antrag.

{
  "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
    }
  }]
}

Regeln, die scheitern geschlossen

• Policy JSON ist auf 16 KiB begrenzt, muss policy_version: 2 verwenden und kann höchstens sieben einzigartige Track-Regeln enthalten.
• Single-Key-Inhalte erfordern eine ALL-Regel allowed_track_types: ALL und eine automatische Qualitätsobergrenze.
• Mehrschlüsselregeln können auf AUDIO, SD, HD, UHD1 oder UHD2 zielen. Ausgelassene Ebenen erhalten keinen Schlüssel.
• max_stream_per_user: 0 deaktiviert DRM-X Concurrent-Stream-Begrenzung für dieses Token.
• expiresInSeconds ist DRM License Token Gültigkeit (60-7200 Sekunden). Es ist getrennt von DRM Lizenz- und Wiedergabedauer.