Cette rubrique présente des exemples d'utilisation des opérations API du module de watermarks vidéo. Ces opérations sont encapsulées dans le SDK Python d'ApsaraVideo VOD. Utilisez ces opérations pour ajouter, modifier, supprimer et interroger des watermarks. Vous pouvez également définir un watermark par défaut.
Notes d'utilisation
Tous les exemples de cette rubrique utilisent une paire AccessKey pour initialiser une instance de client.
Pour consulter le détail des paramètres de requête et de réponse, accédez à Alibaba Cloud OpenAPI Explorer et ouvrez l'onglet API Documentations.
Pour consulter des exemples de SDK relatifs à d'autres opérations API, rendez-vous sur Alibaba Cloud OpenAPI Explorer. Dans l'onglet Parameters, spécifiez les paramètres et lancez l'appel. Sélectionnez ensuite la version du SDK et le langage dans l'onglet SDK Sample Code pour afficher et télécharger le code.
Les exemples de cette rubrique utilisent le SDK V1.0. Pour les exemples V2.0, sélectionnez la version appropriée du SDK dans OpenAPI Explorer.
Initialiser un client
Avant d'utiliser le SDK, initialisez un client. Pour plus d'informations, voir Initialisation.
Ajouter un watermark
Appelez l'opération AddWatermark pour ajouter un watermark.
Portail OpenAPI : ou AddWatermark.
Exemple de code :
Pour en savoir plus sur l'URL de téléchargement du fichier et les informations d'identification, consultez CreateUploadAttachedMedia.
Pour découvrir comment télécharger un fichier de watermark vers un compartiment Object Storage Service (OSS), voir Télécharger des objets 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())
Modifier un watermark
Appelez l'opération UpdateWatermark pour modifier un watermark.
Portail OpenAPI : | UpdateWatermark.
Exemple de code :
Vous ne pouvez pas modifier l'URL du watermark image via cette opération. Pour changer l'URL du watermark image, créez un nouveau watermark.
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())
Supprimer un watermark
Appelez l'opération DeleteWatermark pour supprimer un watermark.
Portail OpenAPI : / DeleteWatermark.
Interroger des watermarks
-
Appelez l'opération GetWatermark pour interroger les détails d'un watermark unique.
Portail OpenAPI : GetWatermark.
-
Appelez l'opération ListWatermark pour interroger plusieurs watermarks.
Portail OpenAPI : ListWatermark.
Définir un watermark par défaut
Appelez l'opération SetDefaultWatermark pour définir un watermark par défaut.
Portail OpenAPI : SetDefaultWatermark.