Forensic Watermarking Settings

This topic provides information on settings for forensic watermarking.

Introduction

Forensic watermarking will help protect your premium content from piracy and unauthorized content sharing. This feature also helps to quickly identify the source of a content leak, so that action can be taken. See Forensic Watermarking for more details on requirements for using forensic watermarking.

forensic_watermark

forensic_watermark:String

API Versions:V2

Parent: outputs

Valid Values: "A", "B"

Compatible Job Types: vod

Example: A

Description:

To generate outputs with forensic watermarking in Zencoder, you need to specify 2 outputs per video, an output A and B so that segments from each output can be intermixed in different sequences to produce a range of different watermarked "videos" for playback (for example: AABABBABA, ABBBABABA, BABAABBAA, etc.).

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "base_url": "s3://urlTest",
      "filename": "contextAwareEncoding1_A.m4f",
      "public": false,
      "format": "m4f",
      "label": "m4f-contextAwareEncoding1-A-b30e1",
      "generate_mp4_atom_map": true,
      "Mp4_atom_map_filename": "contextAwareEncod-A-atom_map.json",
      "skip_audio": true,
      "forensic_watermark": "A",
      "dynamic_profile_rendition": 1,
      "skip": {
          "require_video": true
      },
      "fragment_duration": 2000,
      "segment_seconds": 2,
      "headers": {
          "x-amz-server-side-encryption": "AES256"
      }
    },
    {         
      "base_url": "s3://urlTest",
      "filename": "contextAwareEncoding1_B.m4f",
      "public": false,
      "format": "m4f",
      "label": "m4f-contextAwareEncoding1-B-e348",
      "generate_mp4_atom_map": true,
      "mp4_atom_map_filename": "contextAwareEncod-B-atom_map.json",
      "skip_audio": true,
      "forensic_watermark": "B",
      "dynamic_profile_rendition": 1,
      "skip": {
          "require_video": true
      },
      "fragment_duration": 2000,
      "segment_seconds": 2,
      "headers": {
          "x-amz-server-side-encryption": "AES256"
      }
    }
  ]
}

forensic_watermark_stub_mode

forensic_watermark_stub_mode:Boolean

API Versions:V2

Parent: outputs

Valid Values: true, false

Default Value: false

Compatible Job Types: vod

Example: true

Description:

To be used for purposes of testing integrations that generate outputs with forensic watermarking in Zencoder. When set to true together with forensic_watermark, this flag causes visible watermarks to be created (to verify that forensic watermarking is being successfully added).

Once testing is complete, you will need to run the job again, omitting the forensic_watermark_stub_mode flag or setting it to false, to get outputs without the visible watermarks.

  {
    "input": "s3://zencodertesting/test.mov",
    "outputs": [
      {
        "base_url": "s3://urlTest",
        "filename": "contextAwareEncoding1_A.m4f",
        "public": false,
        "format": "m4f",
        "label": "m4f-contextAwareEncoding1-A-b30e1",
        "generate_mp4_atom_map": true,
        "Mp4_atom_map_filename": "contextAwareEncod-A-atom_map.json",
        "skip_audio": true,
        "forensic_watermark": "A",
        "forensic_watermark_stub_mode": true,
        "dynamic_profile_rendition": 1,
        "skip": {
            "require_video": true
        },
        "fragment_duration": 2000,
        "segment_seconds": 2,
        "headers": {
            "x-amz-server-side-encryption": "AES256"
        }
    },
    {         
        "base_url": "s3://urlTest",
        "filename": "contextAwareEncoding1_B.m4f",
        "public": false,
        "format": "m4f",
        "label": "m4f-contextAwareEncoding1-B-e348",
        "generate_mp4_atom_map": true,
        "mp4_atom_map_filename": "contextAwareEncod-B-atom_map.json",
        "skip_audio": true,
        "forensic_watermark": "B",
        "forensic_watermark_stub_mode": true,
        "dynamic_profile_rendition": 1,
        "skip": {
            "require_video": true
        },
        "fragment_duration": 2000,
        "segment_seconds": 2,
        "headers": {
            "x-amz-server-side-encryption": "AES256"
        }
    }
  ]
}