Este tópico apresenta exemplos de uso das operações de API do módulo de marcas d'água de vídeo. O ApsaraVideo VOD SDK for Python encapsula essas operações, que permitem adicionar, modifique, exclua e consultar marcas d'água, além de definir uma marca d'água padrão.
Observações de uso
Todos os exemplos deste tópico usam um par de AccessKey para inicializar uma instância de cliente.
Para obter detalhes sobre os parâmetros de solicitação e resposta, acesse o Alibaba Cloud OpenAPI Explorer e abra a aba API Documentations.
Para ver exemplos de SDK de outras operações de API, visite o Alibaba Cloud OpenAPI Explorer. Na aba Parameters, especifique os parâmetros e inicie a chamada. Em seguida, selecione a versão do SDK e a linguagem na aba SDK Sample Code para visualize e baixe o código.
Os exemplos deste tópico usam o SDK V1.0. Para exemplos da V2.0, selecione a versão correta do SDK no OpenAPI Explorer.

Inicializar um cliente
Antes de usar o SDK, inicialize um cliente. Para mais informações, consulte Inicialização.
Adicionar uma marca d'água
Chame a operação AddWatermark para adicionar uma marca d'água.
Portal OpenAPI: ou AddWatermark.
Código de exemplo:
Para mais informações sobre a URL de upload de arquivo e as credenciais, consulte CreateUploadAttachedMedia.
Para saber como fazer upload de um arquivo de marca d'água em um bucket do Object Storage Service (OSS), consulte Upload de objetos do OSS.
from aliyunsdkvod.request.v20170321 import AddWatermarkRequest
def add_watermark(clt):
request = AddWatermarkRequest.AddWatermarkRequest()
request.set_Name('watermark-sample')
# If you want to use an image watermark, the image must be stored in an OSS bucket and the image file and source video file must be stored in the same region, such as China (Shanghai).
# Example of FileUrl: http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/watermark/test-****.png.
request.set_FileUrl('<your File URL>')
# Example on how to configure a text watermark:
request.set_Type('Text')
# Specify the text content, font, size, color, transparency, and other configurations.
watermarkConfig = {'Content': 'watermark Text', 'FontName': 'SimSun', 'FontSize': 25, 'FontColor': 'Black',
'FontAlpha': 0.2, 'BorderColor': 'White', 'BorderWidth': 1, 'Top': 20, 'Left': 15}
request.set_WatermarkConfig(json.dumps(watermarkConfig))
"""
# Example on how to configure an image watermark:
request.set_Type('Image')
# The start time and duration of the watermark.
timeline = {'Start': 2, 'Duration': 'ToEND'}
# The position configurations of the watermark.
watermarkConfig = {'Dx': 8, 'Dy': 8, 'Width': 55, 'Height': 55, 'ReferPos': 'BottomRight', 'Timeline': timeline}
request.set_WatermarkConfig(json.dumps(watermarkConfig))
"""
request.set_accept_format('JSON')
response = json.loads(clt.do_action_with_exception(request))
return response
try:
clt = init_vod_client()
watermark = add_watermark(clt)
print(json.dumps(watermark, ensure_ascii=False, indent=4))
except Exception as e:
print(e)
print(traceback.format_exc())
Modificar uma marca d'água
Chame a operação UpdateWatermark para modifique uma marca d'água.
Portal OpenAPI: | UpdateWatermark.
Código de exemplo:
Esta operação não permite alterar a URL da marca d'água de imagem. Caso precise modifique a URL, crie uma nova marca d'água.
from aliyunsdkvod.request.v20170321 import UpdateWatermarkRequest
def update_watermark(clt):
request = UpdateWatermarkRequest.UpdateWatermarkRequest()
request.set_WatermarkId('<watermarkId>')
request.set_Name('new-watermark-name')
# Example on how to modify a text watermark:
# Specify the text content, font, size, color, transparency, and other configurations.
watermarkConfig = {'Content': 'watermark Text', 'FontName': 'SimSun', 'FontSize': 25, 'FontColor': 'Black',
'FontAlpha': 0.2, 'BorderColor': 'White', 'BorderWidth': 1, 'Top': 20, 'Left': 15}
request.set_WatermarkConfig(json.dumps(watermarkConfig))
"""
# Example on how to modify an image watermark:
# The start time and duration of the watermark.
timeline = {'Start': 2, 'Duration': 'ToEND'}
# The position configurations of the watermark.
watermarkConfig = {'Dx': 8, 'Dy': 8, 'Width': 55, 'Height': 55, 'ReferPos': 'BottomRight', 'Timeline': timeline}
request.set_WatermarkConfig(json.dumps(watermarkConfig))
"""
request.set_accept_format('JSON')
response = json.loads(clt.do_action_with_exception(request))
return response
try:
clt = init_vod_client()
watermark = update_watermark(clt)
print(json.dumps(watermark, ensure_ascii=False, indent=4))
except Exception as e:
print(e)
print(traceback.format_exc())
Excluir uma marca d'água
Chame a operação DeleteWatermark para exclua uma marca d'água.
Portal OpenAPI: / DeleteWatermark.
Consultar marcas d'água
-
Chame a operação GetWatermark para consultar os detalhes de uma única marca d'água.
Portal OpenAPI: GetWatermark.
-
Chame a operação ListWatermark para consultar várias marcas d'água.
Portal OpenAPI: ListWatermark.
Definir uma marca d'água como padrão
Chame a operação SetDefaultWatermark para definir uma marca d'água como padrão.
Portal OpenAPI: SetDefaultWatermark.