浮水印設定

簡介

水印是添加到視頻中的圖像，通常用於指示其來源或所有權。當您指定水印時，圖像將嵌入到該輸出中。與視頻輸入一url樣，水印的位置通過 Zencoder 可以訪問的指定位置。

Zencoder 允許您通過以下設置來定位和調整水印的大小：

位置/尺寸設置
設定	描述
`x`	浮水印的水平位置表示為數個像素、視訊寬度的百分比或為`centered`。如果`x`是正數或百分比，則會從視訊的左邊緣到影像左邊緣進行測量。如果`x`有負值，則會從視訊的右邊緣到影像的右邊緣進行測量。默認： -10
`y`	浮水印的垂直位置以數個像素、視訊寬度的百分比或表示為`centered`。如果`y`是正數或百分比，則會從視訊的頂端邊緣到影像的頂端邊緣進行測量。如果`y`有負值，則會從視訊的底部邊緣到影像的底部邊緣進行測量。默認： -10
`width`	水印的寬度表示為像素數或視頻寬度的百分比。默認值：圖像的實際寬度。
`height`	水印的高度表示為像素數或視頻高度的百分比。默認值：圖像的實際高度。

注意事項

如果上面的所有設置具有像素值，則可以將其作為字符串或數字輸入。
如果使用width或height圖像將被拉伸或擠壓，降低圖像質量。
如果必須調整影像大小，請指定width或height，但不能同時指定兩者。在這種情況下，另一個維度將相應地縮放，同時保持縱橫比。
水印的大小和位置必須使其完全適合分配給它的輸出的幀大小。如果沒有，Zencoder 將返回一個錯誤。
如果兩者不同origin，還有一個允許您參考視頻幀大小而不是內容大小進行所有測量-但這很少見。

下圖說明x和y設定的運作方式。

範例

下面的示例使用以下設置加水印：

{
  "input": "https://support.brightcove.com/test-assets/videos/oystercatcher.mp4",
  "outputs": [
    {
      "watermarks": {
        "url": "https://support.brightcove.com/test-assets/images/watermark.png",
        "x": "centered",
        "y": "centered"
      }
    }
  ]
}

水印

watermarks:Array or Hash

API 版本：V2

上級：輸出要么dynamic_profile_options

有效值：水印設置的數組或哈希

兼容的工作類型：VOD

描述：

您可以使用我們的水印API將一個或多個水印添加到輸出視頻中。Zencoder每個輸出最多支持JPEG，BMP或PNG格式的4個水印文件。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        “水印”：[
          {
            “ url”：“ s3：//bucket/watermark_file.png”，
            「x」：20,
            “ y”：“-10％”，
            「寬度」：32，
            「高度」：+24
          }
        ]
      }
    ]
   }

url

url:String

API 版本：V2

上級：輸出 / 水印

有效值：圖像文件的有效URL。

兼容的工作類型：VOD

例：

https://s3.amazonaws.com/bucket/img.png
ftp：// user：pass@example.com/path/to/watermark.jpg

描述：

用作水印的遠程圖像文件的URL。使用輸入 URL語法。支持S3，GCS，雲文件，HTTP / S，FTP和SFTP（帶有或不帶有身份驗證）。

Zencoder 支持 JPEG、BMP 或 PNG 格式的水印文件。

對於透明水印，請使用具有Alpha或索引透明性的PNG。

支持的PNG格式

8位RGB
8位RGB + Alpha
8位灰度
8位索引
8位索引+透明度
16位RGB
16位灰度

不支持的PNG格式

8位灰度+ Alpha
16位灰度+ Alpha
16位RGB + Alpha

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          “ url”：“ https://s3.amazonaws.com/bucket/img.png”
        }
      }
    ]
   }

X

x:String or Number

API 版本：V2

上級：輸出 / 水印

默認： -10

兼容的工作類型：VOD

例：

-+0
320
居中的

描述：

在x軸（左/右）上將水印放置在視頻中的位置。可以是像素數目 (例如 100 或-20)、視訊寬度的百分比 (例如 25% 或-5%)，或是「置中」以將浮水印與視訊中央對齊。相對於視頻的左側使用正數，相對於視頻的右側使用負數。使用“ -0”（作為字符串）鎖定到右側。

默認情況下，位置是基於可見的內容區域，不包括任何填充。採用起源設置基於完整輸出的水印位置。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          「x」：320
        }
      }
    ]
   }

也可以看看： ÿ和起源

ÿ

y:String or Number

API 版本：V2

上級：輸出 / 水印

默認： -10

兼容的工作類型：VOD

例：

-+0
320
居中的

描述：

將水印放置在視頻中y軸上的位置（頂部/底部）。可以是像素數目 (例如 100 或-20)、視訊寬度的百分比 (例如 25% 或-5%)，或是「置中」以將浮水印與視訊中央對齊。相對於視頻的頂部使用正數，相對於視頻的底部使用負數。使用“ -0”（作為字符串）鎖定到底部。

默認情況下，位置是基於可見的內容區域，不包括任何填充。採用起源設置基於完整輸出的水印位置。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          “ y”：320
        }
      }
    ]
   }

也可以看看： X和起源

寬度

width:Number or String

API 版本：V2

上級：輸出 / 水印

默認：縮放到高度，或原始圖像寬度。

有效值：正數或百分比

兼容的工作類型：VOD

描述：

水印的寬度，表示為像素數（例如64個）或視頻寬度的百分比（例如10％）。如果高度如果提供（但不提供寬度），則水印圖像將按比例縮放。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          「寬度」：100
        }
      }
    ]
   }

也可以看看：高度

高度

height:Number or String

API 版本：V2

上級：輸出 / 水印

默認：縮放到寬度或原始圖像高度。

有效值：正數或百分比

兼容的工作類型：VOD

描述：

水印的高度，表示為像素數（例如64）或視頻高度的百分比（例如10％）。如果寬度如果提供（但不提供）高度，則水印圖像將按比例縮放。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          「高度」：100
        }
      }
    ]
   }

也可以看看：寬度

起源

origin:String

API 版本：V2

上級：輸出 / 水印

默認：內容

有效值：內容或框架

兼容的工作類型：VOD

例：幀

描述：

視頻中用於水印定位的部分。這僅影響aspect_mode為“ pad”的作業。

“框架”基於輸出的完整分辨率（包括任何填充）放置位置。
“內容”將放置位置放在可見內容區域上，不包括填充。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          “ origin”：“內容”
        }
      }
    ]
   }

也可以看看： X， ÿ和Aspect_mode

不透明度

opacity:Float

API 版本：V2

上級：輸出 / 水印

默認：+1.0

有效值：0.0至1.0

兼容的工作類型：VOD

例：+0.5

描述：

通過將不透明度值設置為0.0（透明）和1.0（不透明）來使水印透明。

  {
    「輸入」：「S3：//zencodertesting/test.mov」，
    「輸出」：[
      {
        「浮水印」: {
          “不透明度”：+0.5
        }
      }
    ]
   }

也可以看看：網址