Enabling watermarking

Overview

OpenTV Video Platform is integrated with QuickMark, the client-side watermarking solution that is offered as part of NAGRA's Security Services Platform (SSP).

This is enabled or disabled by NAGRA per deployment. To enable watermarking, please contact your NAGRA representative.

Prerequisites

1. For QuickMark watermarking to work end-to-end, the following SSP services must be deployed/enabled:
   • NexGuard QuickMark service
   • Watermark detection service
2. Make sure that devices are provisioned/added with the correct device information. This is necessary so that QuickMark can provide the correct type of surface for devices that support playback of HDR content.
   That is:
   • Provisioned devices (STBs, etc.) must have deviceInformation.device.hardware set correctly.
   • When adding an open device (first-time sign-on), the request must include the correct deviceInformation. See Authentication.
   

   For devices that have already been provisioned (for example, ones already being used by customers), you must ensure that the correct device information is set for them (for example, by means of a script).

Enabling QuickMark watermarking

In addition to enabling watermarking in Platform, you need to:

1. Set a usage rule profile for watermark-enabled channels to enable any restrictions required by content owners (e.g., disable AirPlay) and apply it to the appropriate channels. See:
   • Managing usage rules (live)
   • Usage Rule Profiles (OpCon)
   • Adding Technical channels (OpCon)
2. Indicate the channels/content for which watermarking is to be enabled. You can do this:
   • At ingest, by setting qmWaterMark to true in the relevant entity's SecurityInfo block. See:
     • technicalChannel (editorial-based)
     • technicalContent (editorial-based)
     • technicalChannel (technical-based)
     • technicalContent (technical-based)
   • When creating a channel or content via API, by setting qmWaterMark. See:
     • Creating a technical channel
     • Creating a technical content

   • In OpCon, by editing the appropriate technical channel or content.

     

     Re-ingesting the content will overwrite any changes made to the watermark flag that you have made in OpCon.

3. Indicate the dynamic ranges for the content/channel. QuickMark requires this so that it can provide the appropriate surface. (Different surfaces are required for HDR content.) You can do this:
   • At ingest, by setting a value for the dynamicRange attribute on the technical content/channel. See:
     • technicalChannel (editorial-based)
     • technicalContent (editorial-based)
     • technicalChannel (technical-based)
     • technicalContent (technical-based)
   • When ingesting via API, by setting dynamicRange. See:
     • Creating a technical channel
     • Creating a technical content

   • In OpCon, by editing the appropriate technical channel or content.

4. Enable watermarking in your client application. See Client-side watermarking.

See also

Client-side watermarking (in the Client integration guide)