媒体转码

媒体转码服务简述

PDS提供的媒体转码服务是以音视频为处理对象、模板为处理单元的Domain级服务。对于Domain上的同一个媒体文件（哈希值相同的数据都属于同一个文件），其所有模板均只会触发一次转码，后续不会重复进行转码，为用户提供良好的预览体验和成本控制。

根据业务场景不同，PDS 提供了三种不同类型的转码能力：离线转码（offline_video / offline_audio）、边转边播（live_transcoding）和快速转码（quick_video），其中边转边播和快速转码仅支持视频转码。

对于离线转码，它是指将一个媒体文件完整地转换为另一种媒体文件的流程。它的特点是适配性好，支持绝大多数转换参数，但是在转码完成前无法获取转码结果的预览地址，因此称为离线转码。

对于边转边播和快速转码，它们将转码任务切分为播放列表的生成任务和多个小分片的转码任务，进而实现转码结果的快速预览。当视频上传完成后进行转码信息获取时，即可快速完成播放列表的生成任务得到预览地址。而通过预览地址在播放器进行播放时，若转码已完成，则用户可以快速起播，反之也仅需播放器等待重试起播所需分片的转码任务完成（通常不超过 10 秒）。当用户拖动到未转码完成的分片时，也仅需等待秒级的小分片转码任务的缓冲时间。边转边播和快速转码在用户体验上无明显差距，但后续PDS将主要演进快速转码服务，因此推荐客户开通快速转码。

下图是 PDS 提供的转码服务的大致工作逻辑，主要包括检查转码信息、选取转码模板和发起转码任务三大步骤。

关于转码模板选取，PDS 根据媒体类型不同存在不同的逻辑。对于音频文件，PDS会选取所有Domain 上配置的模板进行转码，其中开通离线音频转码（offline_audio）时默认的模板如下：

对于视频文件，PDS默认会选取所有分辨率小于源视频分辨率和第一个分辨率不小于源视频分辨率的模板进行转码。源视频的分辨率会先进行宽高交换使得宽不小于高。只要变换后的分辨率中的宽高中有一项大于模板分辨率中的对应项，则认为源视频的分辨率大于该模板的分辨率。此外，对于分辨率大于源视频的那个模板，实际转码会以源视频分辨率进行转码，返回预览地址的时候则会通过keep_original_resolution 这个标记字段标识是否保留了原视频分辨率。

举个例子，对于配置模板分辨率分别为720x480, 1280x720, 1920x1080的Domain和分辨率为540x720的源视频，720x480和1280x720的模板会被选取，输出转码结果的分辨率则分别为720x480和720x540。对于三种类型的视频转码能力，开通后Domain上默认的模板如下：

如果默认模板和模板选择策略不满足您的业务需求，您也可以联系我们添加自定义模板和模板选择策略（企业版暂不支持自定义模板和模板选择策略）。以下是 PDS 支持的所有模板参数：

开通媒体转码

企业版文件管理服务（阿里云盘企业版）默认已经开通边转边播和离线音频转码能力。

开发版需要您通过官方钉群联系我们开通，开通媒体转码没有费用，但在使用过程中会产生费用，资费标准增值服务计费项。

上传音/视频文件

新上传的音/视频或者已经上传的音/视频文件都可以，这个步骤是要拿到原媒体文件的drive_id和file_id，用此信息来获取关联的转码结果。

获取媒体转码信息

调用/v2/file/get_video_preview_play_info接口，设置转码类型为Domain已开通的转码能力类型（比如live_transcoding），设置参数template_id="模板id"（比如264_480p）即可获取到"模板id"对应的播放信息（为空时会返回所有转码模板的播放信息）。如果转码尚未完成，您会获得一个等待重试的202响应，反之则会通过url字段返回转码结果的预览地址。

请求示例

{
    "drive_id": "1",
    "file_id": "abcd",              // 媒体文件本身
    "category": "live_transcoding", // 转码类型
    "template_id": "264_480p"       // 需要预览的模板id
}

响应示例

1. 等待重试的响应结果

{
	"Code": "VideoPreviewWaitAndRetry",
  "Message": "media is transcoding, please wait and retry. xxx"
}

2. 离线视频转码的响应结果

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd",                    // 视频文件本身
    "video_preview_play_info": {
        "category": "offline_video",      // 请求参数中的转码类型
        // 其他不重要信息 ...
        "offline_video_transcoding_list": [
            {
                "template_id": "264_480p",           // 模板ID
                "status": "finished"                 // 转码任务完成
                "url": "https://example.aliyundoc.com/c/d?e=f...", // 预览地址
            }
        ]
    }
}

3. 离线音频转码的响应结果

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd",                     // 音频文件本身
    "video_preview_play_info": {
        "category": "offline_audio",      // 请求参数中的转码类型
        // 其他不重要信息 ...
        "offline_audio_list": [
            {
                "template_id": "264_480p",           // 模板ID
                "status": "finished"                 // 转码任务完成
                "url": "https://example.aliyundoc.com/c/d?e=f...", // 预览地址
            }
        ]
    }
}

4. 边转边播的响应结果

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd",                       // 视频文件本身
    "video_preview_play_info": {
        "category": "live_transcoding",      // 请求参数中的转码类型
        // 其他不重要信息 ...
        "live_transcoding_task_list": [
            {
                "template_id": "264_480p",           // 模板ID
                "status": "finished"                 // 播放列表生成完成
                "url": "https://example.aliyundoc.com/c/d?e=f...", // 预览地址
            }
        ]
    }
}

5. 快速转码的响应结果

{
    "domain_id": "xxxxx",
    "drive_id": "1",
    "file_id": "abcd",                   // 视频文件本身
    "video_preview_play_info": {
        "category": "quick_video",      // 请求参数中的转码类型
        // 其他不重要信息 ...
        "quick_video_list": [
            {
                "template_id": "264_480p",           // 模板ID
                "status": "finished"                 // 播放列表生成完成
                "url": "https://example.aliyundoc.com/c/d?e=f...", // 预览地址
            }
        ]
    }
}