Vordefinierte Vorlagen und eigene Richtlinien

Verwenden Sie eine serverseitige namens policy template#

Schutz mit einem Videoschlüssel

Alle Videovarianten teilen sich einen Videoschlüssel. Verschlüsseltes Audio verwendet einen separaten Audioschlüssel. Reine Audioinhalte verwenden einen Audioschlüssel.

Ein Schlüssel identifiziert verschlüsselte Medien; eine Richtlinienregel legt die Zugriffsanforderungen fest. Bei Single Video Key Protection wendet eine ALL-Regel dieselben Anforderungen auf den Videoschlüssel und jeden Schlüssel für verschlüsseltes Audio an. Das bedeutet nicht, dass Audio und Video denselben Schlüssel verwenden. Multi-key Quality Tiered-Pakete verwenden getrennte AUDIO- und Videoqualitätsregeln.

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.