媒体处理

初始化客户端

使用前请先初始化客户端，请参见初始化。

提交转码作业-普通

调用SubmitTranscodeJobs接口，生成提交普通转码作业的SDK示例。

阿里云OpenAPI门户地址：SubmitTranscodeJobs。

调用示例如下：

"""
* 构建覆盖参数，目前只支持图片水印文件地址、文字水印的内容覆盖；如不使用可忽略
* 需要替换的水印信息对应水印ID必须是关联在指定的转码模板ID上（即TranscodeTemplateId）
* 不支持通过本接口去增加一个没有关联上的水印
"""
def build_override_params():
    # 以替换水印为例
    watermarks = []

    # 替换图片水印文件，FlieURL示例：https://192.168.0.0/16/watermarks/sample****.png
    watermark1 = {'WatermarkId': '<watermarkId>', 'FileUrl': '<your File URL>'}
    watermarks.append(watermark1)

    # 替换文字水印
    watermark2 = {'WatermarkId': '<watermarkId>', 'Content': 'new Text'}
    watermarks.append(watermark2)

    return {'Watermarks': watermarks}


"""  发起转码处理   """
from aliyunsdkvod.request.v20170321 import SubmitTranscodeJobsRequest
def normal_submit_transcode_jobs(clt):
    request = SubmitTranscodeJobsRequest.SubmitTranscodeJobsRequest()

    # 需要转码的视频ID
    request.set_VideoId('<videoId>')

    # 指定转码模板组
    request.set_TemplateGroupId('<templateGroupId>')

    """
    # 可选设置覆盖参数，如替换水印
    overrideParams = build_override_params()
    request.set_OverrideParams(json.dumps(overrideParams))
    """

    request.set_accept_format('JSON')
    response = json.loads(clt.do_action_with_exception(request))
    return response

try:
    clt = init_vod_client()
    jobs = normal_submit_transcode_jobs(clt)
    print(jobs['TranscodeJobs']['TranscodeJob'])
    print(json.dumps(jobs, ensure_ascii=False, indent=4))

except Exception as e:
    print(e)
    print(traceback.format_exc())

提交转码作业-HLS标准加密

调用SubmitTranscodeJobs接口，生成使用HLS标准加密发起转码作业的SDK示例。

阿里云OpenAPI门户地址：SubmitTranscodeJobs。

调用示例如下：

"""
* 生成HLS标准加密参数的可选配置，无需使用时可忽略该配置
"""
from aliyunsdkvod.request.v20170321 import GenerateKMSDataKeyRequest
from aliyunsdkcore.http import protocol_type
def build_encrypt_config(clt):
    try:
        # 随机生成一个加密的密钥，返回的response包含明文密钥以及密文密钥
        # 视频标准加密只需要传递密文密钥即可
        request = GenerateKMSDataKeyRequest.GenerateKMSDataKeyRequest()

        request.set_protocol_type(protocol_type.HTTPS)
        request.set_accept_format('JSON')
        response = json.loads(clt.do_action_with_exception(request))

        # 解密接口地址，该参数需要将每次生成的密文密钥与接口URL拼接生成，表示每个视频的解密的密文密钥都不一样；注意您需要自己部署解密服务
        # Ciphertext作为解密接口的参数名称，可自定义，此处只作为参考
        # decryptKeyUri示例：http://example.aliyundoc.com/decrypt?' + 'Ciphertext=' + response['CiphertextBlob
        decryptKeyUri = ['<your decryptKeyUri>']

        return {'DecryptKeyUri': decryptKeyUri, 'KeyServiceType': 'KMS', 'CipherText': response['CiphertextBlob']}

    except Exception as e:
        print(e)
        #print(traceback.format_exc())
        return None


"""  发起转码处理   """
from aliyunsdkvod.request.v20170321 import SubmitTranscodeJobsRequest
def hlsencrypt_submit_transcode_jobs(clt):
    request = SubmitTranscodeJobsRequest.SubmitTranscodeJobsRequest()

    # 需要转码的视频ID
    request.set_VideoId('<videoId>')

    # 指定转码模板组
    request.set_TemplateGroupId('<templateGroupId>')

    # 使用KMS生成随机的加密密钥
    encryptConfig = build_encrypt_config(clt)
    if encryptConfig is not None:
        request.set_EncryptConfig(json.dumps(encryptConfig))

    request.set_accept_format('JSON')
    response = json.loads(clt.do_action_with_exception(request))
    return response

try:
    clt = init_vod_client()
    jobs = hlsencrypt_submit_transcode_jobs(clt)
    print(jobs['TranscodeJobs']['TranscodeJob'])
    print(json.dumps(jobs, ensure_ascii=False, indent=4))

except Exception as e:
    print(e)
    print(traceback.format_exc())

提交截图作业

调用SubmitSnapshotJob接口，生成提交截图作业的SDK示例。

阿里云OpenAPI门户地址：SubmitSnapshotJob。

调用示例如下：

from aliyunsdkvod.request.v20170321 import SubmitSnapshotJobRequest
def submit_snapshot_job(clt):
    request = SubmitSnapshotJobRequest.SubmitSnapshotJobRequest()

    # 需要截图的视频ID
    request.set_VideoId('<videoId>')

    # 截图模板ID
    #request.set_SnapshotTemplateId('<snapshotTemplateId>')

    # 如果设置了截图模板ID，则会忽略下面参数
    request.set_Count(50)
    request.set_SpecifiedOffsetTime(0)
    request.set_Interval(1)
    request.set_Width(200)
    request.set_Height(200)

    # 雪碧图参数，如不使用可不设置
    spriteSnapshotConfig = {'CellWidth': 120, 'CellHeight': 68, 'Columns': 3,
                            'Lines': 10, 'Padding': 20, 'Margin': 50}
    # 保留雪碧图原始图
    spriteSnapshotConfig['KeepCellPic'] = 'keep'
    spriteSnapshotConfig['Color'] = 'tomato'
    request.set_SpriteSnapshotConfig(json.dumps(spriteSnapshotConfig))

    request.set_accept_format('JSON')
    response = json.loads(clt.do_action_with_exception(request))
    return response

try:
    clt = init_vod_client()
    job = submit_snapshot_job(clt)
    print(json.dumps(job, ensure_ascii=False, indent=4))

except Exception as e:
    print(e)
    print(traceback.format_exc())

查询截图数据

调用ListSnapshots接口，生成查询截图数据的SDK示例。

阿里云OpenAPI门户地址：ListSnapshots。

导播台视频预处理

调用SubmitPreprocessJobs接口，生成导播台视频预处理的SDK示例。

阿里云OpenAPI门户地址：SubmitPreprocessJobs。