媒体处理

本文提供了PHP SDK媒体处理模块相关功能的API调用示例,包含提交转码作业、提交截图作业、查询截图数据、导播台视频预处理。

初始化客户端

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

提交转码作业

调用SubmitTranscodeJobs接口,完成提交转码作业功能。

接口参数和返回字段请参见SubmitTranscodeJobs。调用示例如下:

use Kms\Request\V20160120 as kms;

/**
 * 构建覆盖参数,目前只支持图片水印文件地址、文字水印的内容覆盖;如不使用可忽略
 * 需要替换的水印信息对应水印ID必须是关联在指定的转码模板组ID上(即TranscodeTemplateId)
 * 不支持通过媒体处理接口去增加一个没有关联上的水印
 */
function buildOverrideParams() {
    $overrideParams = array();

    //以替换水印为例
    $watermarks = array();

    //替换图片水印文件
    $watermarks1 = array();
    $watermarks1["WatermarkId"] = "2ea587477c5a1bc8b52****";
    $watermarks1["FileUrl"] = "https://outin-40564284ef05113e1403e7.oss-cn-shanghai.aliyuncs.com/watermarks/02A1B22DF25D46C3C725A4-6-2.png";
    $watermarks[] = $watermarks1;

    //替换文字水印
    $watermarks2 = array();
    $watermarks2["WatermarkId"] = "d297ba31ac5242d2052****";
    $watermarks2["Content"] = "用户ID:6****";
    $watermarks[] = $watermarks2;

    $overrideParams["Watermarks"] = $watermarks;
    return json_encode($overrideParams);
}

/**
 * 生成HLS标准加密参数的可选配置,如不使用可忽略
 * 此时依赖KMS服务,需要安装KMS依赖包 aliyun-php-sdk-kms
 * 生成密钥API参考:https://192.168.0.0/16/document_detail/28948.html
 */
function buildEncryptConfig($client) {
    try {
        //随机生成一个加密的密钥,返回的response包含明文密钥以及密文密钥,
        //视频标准加密只需要传递密文密钥即可
        $request = new kms\GenerateDataKeyRequest();
        $request->setKeyId('<serviceKey>');
        $request->setKeySpec("AES_128");
        $response = $client->getAcsResponse($request);

       $encryptConfig = array();
        # 解密接口地址,该参数需要将每次生成的密文密钥与接口URL拼接生成,表示每个视频的解密的密文密钥都不一样;注意您需要自己部署解密服务 
        $encryptConfig["DecryptKeyUri"] = "http://192.168.0.0/16/decrypt?Ciphertext=" + $response->getCiphertextBlob();
        //密钥服务的类型,目前只支持KMS
        $encryptConfig["KeyServiceType"] = "KMS";
        # Ciphertext作为解密接口的参数名称,可自定义,此处只作为参考
        $encryptConfig["CipherText"] = $response->getCiphertextBlob();

        return json_encode($encryptConfig);
    } catch (Exception $e) {
        print $e->getMessage()."\n";
        return null;
    }
}

/**
 * 提交媒体处理作业
 */
function submitTranscodeJobs($client) {
    $request = new vod\SubmitTranscodeJobsRequest();
    //需要转码的视频ID
    $request->setVideoId("6893fca9814640c8821efa523e52****");
    //转码模板ID
    $request->setTemplateGroupId("44f915b63a2375a6121533c6b252****");
    //构建需要替换的水印参数(只有需要替换水印相关信息才需要构建)
    $request->setOverrideParams(buildOverrideParams());
    //HLS标准加密配置(只有标准加密才需要传递)
    $request->setEncryptConfig(buildEncryptConfig($client));

    return $client->getAcsResponse($request);
}

/**
 * 以下为调用示例
 */
try {
    $client = initVodClient("<AccessKeyId>", "<AccessKeySecret>");

    $result = submitTranscodeJobs($client);
    var_dump($result);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

提交截图作业

调用SubmitSnapshotJob接口,完成提交截图作业功能。

接口参数和返回字段请参见SubmitSnapshotJob。调用示例如下:

说明

创建截图模板详细请参考截图模板

/**
 * 构建雪碧图截图配置
 * @return
 */
function buildSnapshotTemplateConfig() {
    $spriteSnapshotConfig = array();
    $spriteSnapshotConfig["CellWidth"] = "120";
    $spriteSnapshotConfig["CellHeight"] = "68";
    $spriteSnapshotConfig["Columns"] = "3";
    $spriteSnapshotConfig["Lines"] = "10";
    $spriteSnapshotConfig["Padding"] = "20";
    $spriteSnapshotConfig["Margin"] = "50";

    //保留雪碧图原始图
    $spriteSnapshotConfig["KeepCellPic"] = "keep";
    $spriteSnapshotConfig["Color"] = "tomato";

    return json_encode($spriteSnapshotConfig);
}


/**
 * 提交媒体截图处理作业调用函数
 */
function submitSnapshotJob($client) {
    $request = new vod\SubmitSnapshotJobRequest();
    //需要截图的视频ID(推荐传递截图模板ID)
    $request->setVideoId("6893fca9814640c8821efa523e52****");
    //截图模板ID
    $request->setSnapshotTemplateId("44f915b63a2375a6121533c6b252****");

    //如果设置了SnapshotTemplateId,会忽略下面参数
    $request->setCount(50);
    $request->setSpecifiedOffsetTime(0);
    $request->setInterval(1);
    $request->setWidth("200");
    $request->setHeight("200");
    $request->setSpriteSnapshotConfig(buildSnapshotTemplateConfig());

    return $client->getAcsResponse($request);
}

/**
 * 以下为调用示例
 */
try {
    $client = initVodClient("<AccessKeyId>", "<AccessKeySecret>");

    $result = submitSnapshotJob($client);
    var_dump($result);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

查询截图数据

调用listSnapshots接口,完成查询截图数据功能。

接口参数和返回字段请参见listSnapshots。调用示例如下:

/**
 * 查询截图数据
 */
function listSnapshots($client) {
    $request = new vod\ListSnapshotsRequest();
    //视频ID
    $request->setVideoId("6893fca9814640c8821efa523e52****");
    ///截图类型
    $request->setSnapshotType("CoverSnapshot");
    // 翻页参数
    $request->setPageNo("1");
    $request->setPageSize("20");

    return $client->getAcsResponse($request);
}

/**
 * 以下为调用示例
 */
try {
    $client = initVodClient("<AccessKeyId>", "<AccessKeySecret>");

    $result = listSnapshots($client);
    var_dump($result);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}

导播台视频预处理

调用SubmitPreprocessJobs接口,完成导播台视频预处理功能。

接口参数和返回字段请参见SubmitPreprocessJobs。调用示例如下:

/**
 * 导播台视频预处理
 */
function submitPreprocessJobs($client) {
    $request = new vod\SubmitPreprocessJobsRequest();
    //视频ID
    $request->setVideoId("6893fca9814640c8821efa523e52****");
    ///类型
    $request->setPreprocessType("PreprocessType");

    return $client->getAcsResponse($request);
}

/**
 * 以下为调用示例
 */
try {
    $client = initVodClient("<AccessKeyId>", "<AccessKeySecret>");

    $result = submitPreprocessJobs($client);
    var_dump($result);
} catch (Exception $e) {
    print $e->getMessage()."\n";
}